AndroidAPS installieren - App erstellen

Kein Download möglich - APK muss selbst erstellt werden

Aufgrund der gesetzlichen Regelungen für Medizinprodukte ist AndroidAPS nicht als Download verfügbar. Es ist zulässig, die App für den eigenen Gebrauch zu erstellen, aber du darfst keine Kopie an andere weitergeben! Weitere Informationen findest Du auf der FAQ Seite.

Wichtige Hinweise

Empfohlene Spezifikation des Computers zum Erstellen der Apk-Datei

Betriebssystem (nur 64 Bit) Windows 8 oder höher Mac OS 10.14 oder höher Jedes Linux unterstützt Gnome, KDE oder Unity DE;  GNU C Library 2.31 oder höher

CPU (nur 64 Bit)

x86_64 CPU-Architektur; Intel Core oder neuere Generation oder AMD CPU mit Unterstützung für einen
Windows Hypervisor
ARM-based Chips oder Intel Core der zweiten Generation oder neuer mit Unterstützung für
Hypervisor.Framework
x86_64 CPU Architektur; Intel Core der zweiten Generation oder neuer, alternativ AMD Prozessor mit Unterstützung für AMD Virtualization (AMD-V) und SSSE3

RAM

8GB oder mehr

Festplatte

Mind. 30 GB freier Speicherplatz. SSD wird empfohlen.

Bildschirmauflösung

min. 1280 x 800

Internet

Breitband

Bitte beachte, dass sowohl eine 64-Bit-CPU als auch ein 64-Bit-Betriebssystem zwingend erforderlich sind. Wenn Dein System diese Bedingung nicht erfüllt, musst Du die betroffene Hardware, Software oder das ganze System ersetzen. Es wird dringend empfohlen, SSD (Solid State Disk) anstelle von HDD (Hard Disk Drive) zu verwenden, da dies dies die Zeit zur Erstellung der APS-Installationsdatei reduziert. Dies wird nur empfohlen und ist nicht zwingend. Trotzdem kannst Du eine normale Festplatte verwenden. Beachte aber, dass der Prozess zur Erstellung der APK-Datei recht lange dauern kann. Du kannst den Prozess aber unbeaufsichtigt laufen lassen, nachdem Du ihn gestartet hast.


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. Falls Du feststellst, dass etwas wichtiges falsch ist oder fehlt, informiere bitte die Facebook Gruppe “AndroidAPS users” oder im Discord chat Android APS, damit wir uns das anschauen können.

Schritt für Schritt Anleitung

Detaillierte Beschreibung der notwendigen Schritte.

Installiere git (falls du es noch nicht hast)

Die Schritt-für-Schritt-Anleitung findest Du auf der Seite zur git Installation.

Android Studio installieren

Die folgenden Screenshots stammen von Android Studio Version Arctic Fox | 2020.3.1. Die Bildschirme können bei zukünftigen Versionen von Android Studio leicht anders aussehen. Aber Du solltest Dich dennoch zurecht finden. Bei Fragen gibt es Hilfe in der Community.

Einer der wichtigsten Punkte bei der Installation von Android Studio ist: Sei geduldig! Während der Installation und Einrichtung lädt Android Studio sehr viele Daten nach und das braucht seine Zeit.

Lade Android Studio von dieser Seite herunter und installiere es auf Deinem Computer.

Beim ersten Start öffnet sich der Setup Wizard:

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

Einstellungen nicht importieren

Entscheide, ob Du Daten mit Google teilen möchten oder nicht.

Daten mit Google teilen

Klicke auf dem nächsten Bildschirm den Button “Next”.

Willkommensbildschirm

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

Standardinstallation

Wähle das Design für die Benutzeroberfläche, das Dir am besten gefällt. (In dieser Anleitung verwenden wir “Light”.) Dann klicke auf “Next”.

Hinweis: Das ist nur das Farbschema. Du kannst auswählen, was Du möchtest (z.B. “Darcula” für den dunklen Modus). Diese Auswahl hat keinen Einfluss auf das Erstellen der APK, aber die folgenden Screenshots könnten anders aussehen.

Farbschema

Klicke auf “Finish” im Fenster “Verify Settings”.

Einstellungen überprüfen

Warte während Android Studio zusätzliche Komponenten herunterlädt und bleibe geduldig. Sobald alles heruntergeladen ist, wird der Button “Finish” blau dargestellt. Klicke diesen dann an.

Komponenten herunterladen

Git-Pfad in Android Studio eintragen

Stelle sicher, dass git auf Deinem PC installiert ist und dass Du den PC nach der git-Installation neu gestartet hast.

Klicke auf dem Android Studio Willkommensbildschirm auf “Customize” [Anpassen] (1) auf der linken Seite und wähle dann den Link “All settings...” [Alle Einstellungen...] (2):

Einstellungen für Android Studio vom Willkommensbildschirm aus

Windows

  • Stelle als Windows Nutzer sicher, dass Du den PC neu gestartet hast, nachdem Du Git installiert hast.

  • Doppelklicke auf “Version Control” (1), um das Untermenü zu öffnen.

  • Git (2) anklicken.

  • Stelle sicher, dass die update method “Merge” (3) ausgewählt ist.

  • Prüfe durch klicken des Buttons “Test” (4), ob Android Studio den Pfad zu git.exe automatisch ermitteln kann.

    Einstellungen für Android Studio

  • Wenn die automatische Einstellung möglich ist, wird die Git-Version hinter dem Pfad angezeigt.

    Anzeige git Version

  • Eventuell kann git.exe nicht automatisch gefunden werden oder der Test führt zu einem Fehler (1):

    Git wurde nicht gefunden

    Klicke in diesem Fall auf das Ordner-Symbol (2).

  • Verwende die Suchfunktion im Windows Explorer um “git.exe” zu finden, falls Du Dir nicht sicher bist, in welchem Ordner “git.exe” installiert wurde. Du suchst eine Datei namens “git.exe”, diese befindet sich im \bin Ordner.

  • Wähle den Pfad zu git.exe aus, stelle sicher, dass Du den Ordner ** \bin\ ** ausgewählt hast (3), und klicke auf “OK” (4).

    Git manuell auswählen

  • Überprüfe den gewählten Git-Pfad erneut mit der Schaltfläche “Test” wie oben beschrieben.

  • Wenn die git Version hinter dem Pfad angezeigt wird (siehe Screenshot oben), kannst Du das Einstellungsfenster mit Klick auf “OK” (5) schließen.

Mac

  • Jede git Version sollte funktionieren. Zum Beispiel https://git-scm.com/download/mac.
  • Benutze Homebrew um git zu installieren: $ brew install git.
  • Details zur Installation von git findest Du in der offiziellen git Dokumentation.
  • Wenn Du git über homebrew installierst, musst Du keine Einstellungen ändern. Im Fall der Fälle findest Du diese unter Android Studio - Preferences.

AndroidAPS-Code herunterladen

  • Wähle auf dem Android Studio Willkommensbildschirm “Projects” auf der linken Seite (1) und dann “Get from VCS” (2).

    Android Studio wizard

    • Wenn Du Android Studio bereits geöffnet hast und den Willkommensbildschirm nicht mehr siehst, klicke auf File (1) > New (2) > Project from Version Control... (3)

      Check out project from version control innerhalb von Android Studio

    • Wir werden Android Studio nun sagen, wo es den Code herunterladen soll:

    • Stelle sicher, dass Du “Repository-URL” auf der linken Seite ausgewählt hast (1).

    • Überprüfe, ob “Git” als Versionskontrolle (2) ausgewählt ist.

    • Kopiere nachfolgende URL https://github.com/nightscout/AndroidAPS und füge sie in Android Studio in die URL Textbox (3) ein.

    • Wähle das Verzeichnis, in dem die Kopie des Codes gespeichert werden soll (4.).

      Clone Git

  • Klicke auf “Clone” (5).

    Repository klonen

  • Klicke nicht auf “Background”, während das Repository geklont wird!

  • Nachdem das Projektarchiv erfolgreich geklont wurde, wird Android Studio das geklonte Projekt öffnen.

  • Du wirst gefragt, ob Du dem Projekt vertrauen willst. Klicke auf “Trust project”!

    Projekt vertrauen

  • In der Statusleiste im unteren Teil des Fensters siehst Du die Information, dass Android Studio Hintergrundaufgaben ausführt.

    Hintergrundprozesse

  • Gewähre Zugriff, falls Dich Deine Firewall dazu auffordert.

    Java-Firewall-Berechtigung

  • Sobald die Hintergrund-Aufgaben beendet sind, wirst Du wahrscheinlich eine Fehlermeldung sehen, die besagt, dass Fehler aufgetreten sind (1) oder (2) oder (3).

    SDK-Lizenz

    Keine Sorge, das wird bald gelöst!

Download Android SDK

  • Gehe im Menü zu File (1) > Settings (2).

    Einstellungen öffnen

  • Doppelklicke auf Appearance & Behaviour, um das Untermenü zu öffnen (1).

  • Doppelklicke auf System Settings (2) und wähle Android SDK (3).

  • Markiere die Box links neben “Android 9.0 (Pie)” (4) (API Level 28).

    SDK-Einstellungen

  • Bestätige die Änderungen durch Klick auf OK.

    SDK-Änderungen bestätigen

  • Akzeptiere die Lizenzvereinbarung (1) und klicke auf “Next” (2).

    SDK-Lizenz akzeptieren

  • Warte, bis der SDK-Download und die Installation abgeschlossen sind.

    Während der SDK-Installation warten

  • Wenn die SDK-Installation abgeschlossen ist, wird der Button “Finish” blau angezeigt. Klicke dann darauf.

    SDK-Installation abschließen

  • Android Studio empfiehlt eventuell, das Gradle-System zu aktualisieren. Führe niemals ein Gradle-Update durch! Dies wird zu Problemen führen!

  • Wenn Du auf der unteren rechten Seite des Android Studio Fensters die Information siehst, dass das Android Gradle Plugin zur Aktualisierung bereit ist, klicke auf den Text “Update” (1).

    Kein Gradle Update

  • Wähle in der folgenden Dialogbox “Don’t remind me again for this project” (2).

    Kein Gradle Update

  • Starte Android Studio neu, bevor Du fortfährst.

Signierte APK erstellen (Generate signed APK)

Signieren bedeutet, dass Du die App mit einem digitalen Fingerabdruck versiehst und als von Dir erstellt kennzeichnest. Es ist notwendig, die App digital zu signieren, da Android aus Sicherheitsgründen nur signierten Code akzeptiert. Weitere Informationen dazu findest Du unter diesem Link.

  • Nachdem Android Studio gestartet wurde, musst Du warten, bis alle Hintergrundaufgaben abgeschlossen sind.

    Auf Hintergrundaufgaben warten

    Gradle Sync Fehler

  • Klicke in der Menüzeile auf “Build” (1) und wähle “Generate Signed Bundle / APK...” (2).

    Apk erstellen

  • Wähle “APK” (1) statt “Android App Bundle” aus und klicke auf “Next” (2).

    APK statt Bundle

  • Stelle sicher, dass als Modul “AndroidAPS.app” (1) ausgewählt ist.

  • Klicke auf “Create new...” (2), um Deinen key store zu erstellen.

    Hinweis: Ein key store ist in diesem Fall nichts anderes als eine Datei, in der die Signierdaten gespeichert werden. Sie ist verschlüsselt und passwortgeschützt.

    Key Store erstellen

  • Klicke das Ordner-Symbol, um den Pfad zu wählen, unter dem Dein key store auf Deinem PC gespeichert werden soll.

    Key Store erstellen

  • Wähle den Pfad, in dem Dein key store gespeichert werden soll (1).

    Key Store erstellen

    Speichere ihn nicht im gleichen Ordner wie Dein Projekt. Du musst ein anderes Verzeichnis verwenden! Dein Benutzerordner wäre ein guter Speicherort.

  • Gib einen Dateinamen für Deinen key store ein (2) und bestätige mit “OK” (3).

  • Gib das Passwort für Deinen key store ein (2) und bestätige es (3).Key store Pfad wählen

    Hinweis: Passwörter für key store und key müssen nicht sehr anspruchsvoll sein. Merke sie Dir gut oder notiere sie an einem sicheren Ort. Falls Du künftig einmal keinen Zugriff auf die Passwörter haben solltest, findest Du einen Lösungsvorschlag unter Fehlerbehebung verlorener key store.

  • Gib einen Alias für Deinen key ein (4). Wähle eine beliebige Bezeichnung.

  • Gib das Passwort für Deinen key ein (5) und bestätige es (6).

  • Als Validity (Gültigkeit) (7) ist standardmäßig 25 Jahre voreingestellt. Das musst Du nicht verändern.

  • Ein Vor- und Nachname müssen eingegeben werden (8). Alle anderen Informationen sind optional.

  • Klicke auf “OK” (9), wenn Du fertig bist.

  • Achte darauf, dass die Checkbox “remember passwords” ausgewählt ist (1). Dann musst Du sie bei der nächsten App-Erstellung (z.B. beim Update auf eine neue AndroidAPS Version) nicht erneut eingeben.

  • Klicke auf “Next” (2).

    Passwörter speichern

  • Wähle die Build-Variante “fullRelease” (1) und drücke “Finish”.

    Build-Variante auswählen

  • Android Studio zeigt im unteren Teil des Fensters “Gradle Build running” an. Dies dauert eine Weile je nach Computer und Internetverbindung. Sei geduldig!

    Build-Variante auswählen

  • Android Studio zeigt “Generate Signed APK” an, so bald die Erstellung der APK-Datei abgeschlossen ist.

    Build abgeschlossen

  • Falls beim Erstellen Fehler auftreten, findest Du Lösungsansätze auf den Seiten zur Fehlerbehebung.

  • Klicke auf die Benachrichtigung, um sie zu vergrößern.

  • Klicke auf den link “locate”.

    Build finden

    • Falls die Benrachrichtigung automatisch geschlossen wurde, kannst Du immer den “Event log” öffen und dort den Link auswählen.Build erfolgreich - Ereignisprotokoll
  • Dein Dateimanager (z.B. Windows Explorer) wird geöffnet. Navigiere zum Verzeichnis “full” (1) > “release” (2).

    Datei-Speicherort apk

  • “app-full-release.apk” (3) ist die von Dir gesuchte Datei!

Übertrage die APK-Datei auf das Smartphone

Der einfachste Weg, die Datei app-full-release.apk auf Dein Smartphone zu übertragen ist mittels USB-Kabel oder Google Drive. Bitte beachte, dass die Übertragung per Mail zu Schwierigkeiten führen kann und daher nicht empfohlen wird.

Auf dem Smartphone musst Du die Installation aus unbekannten Quellen zulassen. Anleitungen dazu findest Du im Internet (z.B. hier oder hier).

Problembehandlung

Siehe die separate Seite zur Problembehandlung bei Android Studio.