AndroidAPS installieren - App erstellen


Bitte beachte beim Erstellen einer AndroidAPS 2.0 apk: Configuration on demand wird in der aktuellen Version des Android Gradle Plugins nicht unterstützt! Wenn der Build-Prozess mit einem Fehler zu “on demand configuration” fehlschlägt, dann kannst du folgendes tun:

 *  *Das Einstellungen-Fenster öffnen, indem du auf Datei > Einstellungen (auf dem Mac: Android Studio > Präferenzen) klickst.*
*  *Im linken Fensterbereich, klicke auf Build, Execution, Deployment > Compiler.*
*  *Deaktiviere die "Configure on demand" checkbox.*

* Klicke Apply oder OK.

Dieser Artikel ist in zwei Teile geteilt.

  • Im Überblick werden die wichtigsten Schritte kurz zusammengefasst die allgemein nötig sind, um die APK Datei zu erstellen.
  • In der “Schritt für Schritt Anleitung” wird detailliert auf die einzelnen Punkte mithilfe von Screenshots eingegangen. Da die Versionen von Android Studio - der Software, die wir zum Bau der APK verwenden werden - sich schnell weiterentwickeln werden diese nicht mit deiner Installation übereinstimmen, aber sie geben einen guten ersten Eindruck. Android Studio läuft sowohl auf Windows, als auch auf Mac OS X und Linux. Es kann sein, dass es bei jedem Betriebssystem einige kleinere Unterschiede gibt. Bei grösseren Veränderungen oder fehlenden bzw. falschen Informationen wäre es hilfreich, dies den Entwicklern in der Facebookgruppe “Android APS” oder in den Gitter Chats Android APS oder AndroidAPSwiki mitzuteilen, so dass wir einen Blick darauf werfen können.

Übersicht

Kurzfassung der wichtigsten Schritte zum Erstellen der APK Datei:

  • Git installieren
  • Installiere und konfiguriere Android Studio.
  • Nutze git clone, um den Quellcode von AndroidAPS auf Github zu downloaden.
  • Öffne das heruntergeladene Projekt in Android Studio.
  • Erstelle die signierte APK.
  • Übertrage die erstellte APK auf dein Smartphone.

Schritt für Schritt Anleitung

Detaillierte Beschreibung der notwendigen Schritte.

Android Studio installieren

  • Installiere git
    • Windows
    • Mac OS X
    • Linux - installiere einfach ein ‘Package Git’ über einen ‘Package Manager’ deiner Linux-Distribution
  • Installiere Android Studio.
  • Konfiguriere Android Studio gleich beim ersten Öffnen des Programms.

Wähle “Do not import settings”, da bisher keine Einstellungen vorgenommen wurden.

Screenshot 1

Klicke auf “Next”.

Screenshot 2

Wähle “Standard” Installation und klicke auf “Next”.

Screenshot 3

Wähle “Intellij” als “UI theme” (Benutzeroberfläche) und klicke auf “Next”.

Screenshot 4

Klicke auf “Next” in dem Fenster “Verify Settings”.

Screenshot 5

Der Android Emulator (um ein Smartphone auf Deinem PC oder Mac zu simulieren) wird zum Bau der APK nicht benutzt. Du kannst auf ‘Finish’ klicken, um die Installation zu beenden und die vorgeschlagene Dokumentation bei Bedarf später lesen.

Screenshot 6

Android Studio lädt viele benötigte Software-Komponenten herunter. Du kannst auf ‘Show Details’ klicken um zu sehen was passiert, aber das ist nicht relevant für den weiteren Verlauf.

Screenshot 7

Screenshot 8

Wenn der Download beendet ist, klicke auf “Finish”.

Screenshot 9

  • Herzlichen Glückwunsch, jetzt hast du Android Studio soweit fertig installiert und kannst mit dem Clonen des Quellcodes beginnen. Hier ist allerdings auch ein guter Zeitpunkt, um eine Pause einzulegen.

Code und weitere Komponenten herunterladen

  • Nutze “git clone” in Android Studio wie in dem folgendem Screenshot angegeben. Wähle “Check out project from Version Control” und “Git” als konkretes System zur Versionskontrolle aus.

Screenshot 10 Version_Control_Git

Gib die URL der Hauptseite des AndroidAPS Repositorys (“https://github.com/MilosKozak/AndroidAPS”) an und klicke auf “Clone”.

Screenshot 13

Android Studio fängt an das Projekt zu ”clonen” (kopieren). Klicke nicht auf “Background”, es geht schnell und macht es derzeit nur komplizierter.

Screenshot 14

Beende “checkout from version control”, indem du auf “Yes” klickst und das Projekt öffnest.

Screenshot 15

Nutze den Standard “default gradle wrapper” und klicke auf “OK”.

Screenshot 16

Lies und schließe den “Tip of the Day” von Android Studio, indem du auf “close” klickst.

Screenshot 17

  • Perfekt, du hast jetzt deine eigene Kopie des Quellcodes erstellt und kannst mit dem Kompilieren beginnen.
  • Als nächstes erwartet uns die erste Fehlermeldung. Glücklicherweise schlägt Android Studio gleich die Lösung vor.

Klicke auf “Install missing platform(s) and sync project”, da Android Studios noch einige Komponenten installieren muss.

Screenshot 18

Akzeptiere die Lizenzvereinbarung, indem du auf “Accept” und “Next” klickst.

Screenshot 19

Wie beschrieben, einfach warten, bis die Installation abgeschlossen ist.

Screenshot 20

Ist diese abgeschlossen, dann klicke wieder auf “Finish”.

Screenshot 21

Und dann wird wohl wieder der nächste Fehler auf dich zukommen... Aber auch hier schlägt Android Studio einen ähnlichen Lösungsweg vor. Klicke auf “Install Build Tools and sync project” um die fehlenden “Tools” zu installieren.

Screenshot 22

Wie beschrieben, einfach warten, bis die Installation abgeschlossen ist.

Screenshot 23

Ist diese abgeschlossen, dann klicke wieder auf “Finish”.

Screenshot 24

Und der nächste Fehler tritt auf. Klicke einfach wieder auf “Install missing platform(s) and sync project”.

Screenshot 25

Wie beschrieben, einfach warten, bis die Installation abgeschlossen ist.

Screenshot 26

Ist diese abgeschlossen, dann klicke wieder auf “Finish”.

Screenshot 27

Klicke auf “Install Build Tools and sync project” um die fehlenden “Tools” zu installieren.

Screenshot 28

Wie beschrieben, einfach warten, bis die Installation abgeschlossen ist.

Screenshot 29

Ist diese abgeschlossen, dann klicke wieder auf “Finish”.

Screenshot 30

Sieht so aus, als ob wir die Fehlermeldungen hinter uns haben :). Zeit für eine Trinkpause?

Screenshot 31

Nun wird von Android Studio empfohlen, ”Gradle Plugin” auf Version 4.4 zu aktualisieren. Wenn du nicht mindestens einen Release Candidate für AndroidAPS 2.0 kompilieren willst, dann befolge diese Empfehlung nicht. Anderenfalls wird der Build fehlschlagen. “Gradle” ist nur dafür da, den “Build Process” zu kontrollieren. Für AndroidAPS ist es kein Nachteil, die alte Gradle Version zu verwenden. Die APK-Datei unterscheidet sich nicht. Wenn du eine Version von AndroidAPS 2.0 oder größer bauen willst, könntest du dennoch auf Version 4.4 aktualisieren.

Screenshot 32

Der Prozess läuft weiter...

Screenshot 33

Perfekt, der erste “Build Prozess” ist erfolgreich abgeschlossen, aber wir sind noch nicht fertig.

Screenshot 34

Siginierte APK erstellen (Generate signed APK)

Wähle im Menü “Build” und dann “Generate Signed Bundle / APK...”. (Das Menü in Android Studio wurde im September 2018 geändert. Falls Du eine ältere Version benutzt, wähle im Menü “Build” und dann “Generate Signed APK...”.)Signieren bedeutet, dass du deine generierte Anwendung unterschreibst, aber digital als eine Art digitaler Fingerabdruck in der Anwendung selbst. That is necessary because Android has a rule that it only accepts signed code to run for security reasons. For more information on this topic, follow the link here Security is a deep and complex topic and you don’t need this now.

Screenshot 39a

In the following dialogue box select “APK” instead of “Android App Bundle” and click button “Next”.

Screenshot 39b

Select “app” and click “Next”.

Screenshot 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

  • Fülle die Informationen in den nächsten Textfeldern aus.
    • “Key store path”: Der Ort, an dem der Keystore gespeichert wird.
    • Die Passwortfelder sind dazu da, um den Key auf Tippfehler zu überprüfen.
    • “Alias”: ist der Name des Schlüssels. Du kannst ihn unverändert lassen wie vorgegeben oder jeden beliebigen anderen Namen eingeben.
    • Die Passwort-Felder unter dem Key sind für den Key selbst. Wie immer, um die Eingabe auf Tippfehler zu prüfen.
    • Die Gültigkeit kannst du bei den vorgeschlagenen 25 Jahren belassen.
    • Du musst nur Vor- und Nachname ausfüllen, kannst aber auch den Rest ergänzen. Klicke danach auf “OK”.

Screenshot 42

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

Screenshot 43

Select “full” as flavour for the generated app. Select V1 “Jar Signature” (V2 is optional) and click “Finish”. The following information might be important for later use.

  • “Release” solltest du immer lassen, “Debug” ist nur für Programmierer, um Fehler zu finden.
  • Wähle den “build type”, den du kompilieren möchtest:
    • full (d.h. automatische Pumpensteuerung im Closed Loop)
    • openloop (d.h. gibt temporäre Basalraten-Vorschläge, die manuell auszuführen sind)
    • pumpcontrol (d.h. nur Fernbedienung für die Pumpe, kein Loopen)
    • nsclient (d.h. es werden z.B. die Daten eines anderen Nutzers dargestellt und Careportal-Einträge können hinzugefügt werden)

Screenshot 44

In the event log you see that the Signed APK was generated successfully.

Screenshot 45

Click the “locate” link in the event log.

Screenshot 46

Transfer APK to smartphone

A file manager window opens. It might look a bit different on your system as I am using Linux. On Windows there will be the File Explorer and on Mac OS X the Finder. There you should see the directory with the generated APK file. Unfortunately this is the wrong place as “wear-release.apk” is not the signed “app” APK we are searching for.

Screenshot 47

Please change to the directory AndroidAPS/app/full/release to find the “app-full-release.apk” file. Transfer this file to your Android smartphone. You can do it on your preferred way, i.e. Bluetooth, cloud upload or email. I use Gmail here in this example as it is fairly simple for me. I mention this because to install the self-signed app we need to allow Android on our smartphone to do this installation even if this file is received via Gmail which is normally forbidden. If you use something other please proceed accordingly.

Screenshot 48

In the settings of your smartphone there is an area “unknown apps install” where I have to give Gmail the right to install APK files which I get via Gmail.

Screenshot 49

Select “Allow from this source”. After the installation, you can disable it again.

Screenshot 50

The last step is to press on the APK file I got via Gmail and install the app. If the APK does not install and you have an older version of AndroidAPS on your phone that was signed with a different key then you will need to uninstall this first, remember to export your settings if so!

Yeah, you got it and can now start with configuring AndroidAPS for your use (CGMS, insulin pump) etc.