Δημιουργώντας την εφαρμογή APK

Φτιάξτε το μόνοι σας, αντί να το κατεβάσετε

AndroidAPS δεν είναι διαθέσιμο για κατέβασμα λόγω κανονισμού για τις ιατρικές συσκευές. Είναι νόμιμο να χτίσει η εφαρμογή για δική σας χρήση, αλλά δεν πρέπει να δώσετε αντίγραφο σε άλλους! Δείτε το σελίδα FAQ για λεπτομέρειες.

## Σημαντικές σημειώσεις

Σημείωση: Παρακαλώ χρησιμοποιήστε το Android Studio Έκδοση 3.5.1 ή νεότερη έκδοση για να χτίσει το apk.

Διαμόρφωση της ζήτησης δεν υποστηρίζεται από την τρέχουσα έκδοση του Android Gradle plugin!

Εάν η κατασκευή σας αποτύχει με σφάλμα σχετικά με τη διαμόρφωση “κατά παραγγελία”, μπορείτε να κάνετε τα εξής:

  • Ανοίξτε το παράθυρο “Προτιμήσεις” κάνοντας κλικ στην επιλογή Αρχείο> Ρυθμίσεις (σε Mac, Android Studio> Προτιμήσεις).
  • Στο αριστερό τμήμα του παραθύρου, κάντε κλικ στην επιλογή Δημιουργία, εκτέλεση, ανάπτυξη> μεταγλωττιστής.
  • Καταργήστε την επιλογή του πλαισίου ελέγχου Configure κατα παραγγελία.
  • Κάντε κλικ στην επιλογή Εφάρμοσε ή ΟΚ.

Αυτό το άρθρο χωρίζεται σε δύο μέρη.

  • Στο τμήμα επισκόπησης υπάρχει μια εξήγηση για τα βήματα που απαιτούνται για τη δημιουργία του αρχείου APK.
  • Στο τμήμα βήμα προς βήμα θα βρείτε τα στιγμιότυπα οθόνης μιας πετυχημένης εγκατάστασης. Επειδή οι εκδόσεις του Android Studio - το περιβάλλον ανάπτυξης λογισμικού που θα χρησιμοποιήσουμε για την κατασκευή του APK - θα αλλάξουν πολύ γρήγορα αυτό δεν θα είναι ταυτόσημο με την εγκατάστασή σας, αλλά θα πρέπει να σας δώσει ένα καλό σημείο εκκίνησης. Το Android Studio τρέχει επίσης σε Windows, Mac OS X και Linux και ενδέχεται να υπάρχουν μικρές διαφορές σε ορισμένες πτυχές μεταξύ κάθε πλατφόρμας. Αν διαπιστώσετε ότι κάτι σημαντικό είναι λάθος ή λείπει, παρακαλούμε ενημερώστε την ομάδα του facebook “AndroidAPS users” ή στο chat Gitter Android APS ή AndroidAPSwiki ώστε να το κοιτάξουμε.

Μία γενική ιδέα

Γενικά, τα απαραίτητα βήματα για τη δημιουργία του αρχείου APK:

  • Install git
  • Εγκαταστήστε και ρυθμίστε το Android Studio.
  • Χρησιμοποιήστε git για να κλωνοποιήσετε τον πηγαίο κώδικα από το κεντρικό αποθετήριο Github όπου οι προγραμματιστές έχουν βάλει τον πραγματικό κώδικα για την εφαρμογή.
  • Ανοίξτε το κλωνοποιημένο έργο στο Android Studio ως ενεργό έργο.
  • Δημιουργήστε το υπογεγραμμένο APK.
  • Μεταφέρετε το υπογεγραμμένο APK στο smartphone σας.

Step by step walkthrough

Λεπτομερής περιγραφή των βημάτων που είναι απαραίτητα για τη δημιουργία του αρχείου APK.

Εγκαταστήστε το git (αν δεν το έχετε)

Follow the manual on the git installation page.

Install Android Studio

The following screenshots have been taken from Android Studio Version 3.1.3. Your screen might look a bit different depending on the Android Studio version you use. But you should be able to find your way through. Help from the community is provided for example in the AndroidAPS Facebook group and other places.

Install Android Studio and setup during first start.

Select “Do not import settings” as you have not used it before.

Screenshot 1

Click “Next”.

Screenshot 2

Select “Standard” installation and click “Next”.

Screenshot 3

Select the theme for the user interface you like. (In this manual we used “Intellij”. Then click “Next”. This is just the color scheme. You can select any you like (i.e. “Darcula” for dark mode). This selection has no influence on building the APK.

Screenshot 4

Click “Next” on the “Verify Settings” dialog.

Screenshot 5

The Android emulator (to emulate the smartphone on your PC or Mac) is not used to build the APK. You can click “Finish” to finish the installation and read the documentation later on demand.

Screenshot 6

Android Studio is downloading a lot of software components it uses. You can click on the “Show Details” button to the what happens but that’s not important at all.

Screenshot 7

Screenshot 8

After the downloads are completed click the “Finish” button.

Screenshot 9

  • Applause, applause you have now finished the Android Studio installation and can start cloning the source code. Maybe it’s time for a short break?

Set git path in preferences

Windows

  • Let Studio know where is git.exe located: File - Settings

    Android Studio - open settings

  • In the next window: Version Control - Git

  • Choose correct path: .../Git/bin

  • Make sure update method “Merge” is selected.

    Android Studio - GIT path

Mac

  • If you install git via homebrew there is no need to change any preferences. Just in case: They can be found here: Android Studio - Preferences.

Download code and additional components

  • Use git clone in Android Studio as shown in screenshots below. Select “Check out project from Version Control” with “Git” as concrete version control system.

Screenshot 10

Version_Control_Git

Fill in the URL to the main AndroidAPS repository (“https://github.com/MilosKozak/AndroidAPS”) and click “clone”.

Screenshot 13

Android Studio will start cloning. Don’t click “Background” as it goes fast and makes things more complicated at the moment.

Screenshot 14

Finish the checkout from version control with opening the project by clicking “Yes”.

Screenshot 15

Use the standard “default gradle wrapper” and click “OK”.

Screenshot 16

Read and close the “Tip of Day” screen of Android Studio by pressing “Close”.

Screenshot 17

  • Excellent, you have your own copy of the source code and are ready to start the build.
  • Now we are approaching our first error message. Fortunately, Android Studio will directly give us the solution for this.

Click “Install missing platform(s) and sync project” as Android Studio needs to install a missing platform.

Screenshot 18

Accept the license agreement by selecting “Accept” and clicking “Next”.

Screenshot 19

As it is said in the dialog please wait until the download is finished.

Screenshot 20

Now it’s finished. Please click “Finish”.

Screenshot 21

Aaaahhh, next error. But Android Studio suggests a similar solution. Click “Install Build Tools and sync project” as Android Studio needs to download missing Tools.

Screenshot 22

As it is said in the dialog please wait until the download is finished.

Screenshot 23

Now it’s finished. Please click “Finish”.

Screenshot 24

And another error to handle as Android Studio needs to download again a missing platform. Click “Install missing platform(s) and sync project”.

Screenshot 25

As it is said in the dialog please wait until the download is finished.

Screenshot 26

Now it’s finished. Please click “Finish”.

Screenshot 27

Click “Install Build Tools and sync project” as Android Studio needs to download missing Tools.

Screenshot 28

As it is said in the dialog please wait until the download is finished.

Screenshot 29

Now it’s finished. Please click “Finish”.

Screenshot 30

Yeah, the error messages are gone and the first gradle build is runing. Maybe it’s time to drink some water?

Screenshot 31

Android Studio recommends to update the gradle system. Never update gradle! This might lead to difficulties!

Please click “Don’t remind me again for this project”.

Screenshot 32

The build is running again.

Screenshot 33

Yeah, the first build is successful but we are not finished.

Screenshot 34

Δημιουργία υπογεγραμμένου APK

Στο μενού επιλέξτε “Δημιουργία” και, στη συνέχεια, “Δημιουργία υπογεγραμμένης δέσμης / APK...”. (Το μενού στο Android Studio άλλαξε από τον Σεπτέμβριο του 2018. In older versions select in the menu “Build” and then “Generate Signed APK...”.)

Signing means that you sign your generated app but in a digital way as a kind of digital fingerprint in the app itself. Αυτό είναι απαραίτητο επειδή το Android έχει έναν κανόνα ότι δέχεται μόνο υπογεγραμμένο κώδικα για εκτέλεση για λόγους ασφαλείας. Για περισσότερες πληροφορίες σχετικά με αυτό το θέμα, ακολουθήστε τον σύνδεσμο εδώ Η ασφάλεια είναι ένα βαθύ και πολύπλοκο θέμα και δεν το χρειάζεστε τώρα.

Στιγμιότυπο οθόνης 39α

Στο παρακάτω παράθυρο διαλόγου επιλέξτε “APK” αντί για “Bundle Android App” και κάντε κλικ στο κουμπί “Επόμενο”.

Στιγμιότυπο οθόνης 39α

Επιλέξτε “εφαρμογή” και κάντε κλικ στο κουμπί “Επόμενο”.

Στιγμιότυπο οθόνης 40

Click “Create new...” to start creating your keystore. A keystore in this case is nothing more than a file in which the information for signing is stored. It is encrypted and the information is secured with passwords. We suggest storing it in your home folder and remember the passwords but if you lose this information it’s not a big issue because then you just have to create a new one. Best practice is to store this information carefully.

Screenshot 41

  • Fill in the information for the next dialog.
    • Key store path: is the path to the keystore file. Do not save in same folder as projekt. You must use a different directory!
    • The password fields below are for the keystore to double check for typing errors.
    • Alias is a name for the key you need. You can leave the default or give it a fancy name you want.
    • The password fields below the key are for the key itself. As always to double check for typing errors.
    • You can let the validity at the default of 25 years.
    • You only have to fill out first name and last name but feel free to complete the rest of information. Then click “OK”.

Screenshot 42

Fill in the information of the last dialog in this dialog and click “Next”.

Screenshot 43

Select “full” (or “fullRelease”) as flavour for the generated app. Select V1 “Jar Signature” (V2 is optional) and click “Finish”. Οι ακόλουθες πληροφορίες μπορεί να είναι σημαντικές για μεταγενέστερη χρήση.

  • Το “Απελευθερωμένο” θα πρέπει να είναι η προεπιλεγμένη επιλογή σας για το “Τύπος κατασκευής”, το “Debug” είναι μόνο για τους ανθρώπους που κωδικοποιούν.
  • Επιλέξτε τον τύπο κατασκευής που θέλετε να δημιουργήσετε.
    • full / fullRelease (i.e. recommendations automatically enacted in closed looping)
    • ανοιχτό κύκλωμα (δηλ. συστάσεις που δίδονται στο χρήστη να χειρίζεται με μη αυτόματο τρόπο)
    • έλεγχος αντλίας (δηλαδή τηλεχειριστήριο για αντλία, χωρίς κύκλωμα)
    • nsclient (δηλ. εμφανίζονται τα δεδομένα του κυκλώματος ενός άλλου χρήστη και μπορούν να προστεθούν καταχωρήσεις στην εξυπηρέτηση)

Στιγμιότυπο οθόνης 44

Στο αρχείο καταγραφής συμβάντων βλέπετε ότι το υπογεγραμμένο APK δημιουργήθηκε με επιτυχία.

Στιγμιότυπο οθόνης 45

Κάντε κλικ στο σύνδεσμο “εντοπίστε” στο αρχείο καταγραφής συμβάντων.

Στιγμιότυπο οθόνης 46

Μεταφορά APK σε smartphone

Ανοίγει ένα παράθυρο διαχειριστή αρχείων. Μπορεί να φαίνεται λίγο διαφορετικό στο σύστημά σας καθώς χρησιμοποιώ το Linux. Στα Windows θα υπάρχει η Εξερεύνηση αρχείων και στο Mac OS X ο εξερευνητής. Εκεί θα πρέπει να δείτε τον κατάλογο με το αρχείο APK που δημιουργήθηκε. Δυστυχώς, αυτό είναι λάθος, καθώς το “wear-release.apk” δεν είναι η υπογεγραμμένη εφαρμογή APK που ψάχνουμε.

Στιγμιότυπο οθόνης 47

Μεταβείτε στον κατάλογο AndroidAPS / εφαρμογή / πλήρεις/ release για να βρείτε το αρχείο “app-full-release.apk”. Μεταφέρετε αυτό το αρχείο στο Android smartphone σας. You can do it on your preferred way, i.e.

  • Bluetooth
  • cloud upload (Google Drive or other cloud services)
  • connect computer and phone by cable
  • by mail (Note that some mail apps do not allow apk attachments, in this case use other transfer method.)

In this example Gmail is used as it is fairly simple. To install the self-signed app you need to allow Android on your smartphone to do this installation even if this file is received via Gmail which is normally forbidden. Αν χρησιμοποιείτε κάτι άλλο παρακαλούμε προχωρήστε ανάλογα.

Στιγμιότυπο οθόνης 48

Στις ρυθμίσεις του smartphone σας υπάρχει μια περιοχή “Άγνωστη εγκατάσταση εφαρμογών”, όπου πρέπει να δώσω στο Gmail το δικαίωμα να εγκαταστήσει αρχεία APK που λαμβάνω μέσω του Gmail.

Επιλέξτε “Να επιτρέπεται από αυτή την πηγή”. Μετά την εγκατάσταση, μπορείτε να την απενεργοποιήσετε ξανά.

Εγκατάσταση από άγνωστες πηγές

Το τελευταίο βήμα είναι να πατήσετε το αρχείο APK που λαβατε μέσω του Gmail και να εγκαταστήσετε την εφαρμογή. Αν το APK δεν εγκατασταθεί και έχετε μια παλαιότερη έκδοση του AndroidAPS στο τηλέφωνό σας που έχει υπογραφεί με διαφορετικό κλειδί τότε θα πρέπει πρώτα να την απεγκαταστήσετε, να θυμάστε να εξάγετε τις ρυθμίσεις σας αν το κάνετε!

Ναι, το πήρατε και τώρα μπορείτε να ξεκινήσετε με τη ρύθμιση του AndroidAPS για τη χρήση σας (CGMS, αντλία ινσουλίνης) κλπ.

Identify receiver if using xDrip

See xDrip page

Αντιμετώπιση προβλημάτων

See separate page troubleshooting Android Studio.