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¶
Nutze bitte Android Studio Version 2020.3.1 oder neuer, um die APK-Datei zu erstellen.
Windows 10 32-bit systems are not supported by Android Studio 2020.3.1
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 |
Please be in mind that both 64 bit CPU and 64 bit OS are mandatory condition. If your system DOES NOT meet this condition, you have to change affected hardware or software or the whole system. It is strongly recommended to use SSD (Solid State Disk) instead of HDD (Hard Disk Drive) because it will take less time when you are building the APS installation apk file. Recommended is just recommended and it is not a mandatory. However, you may still use a HDD when you are building apk file but note that the building process can take a long time to complete, although once started, you can leave it running unattended.
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.
Übersicht¶
In general, the steps necessary to build the APK file:
Android Studio installieren
Pfad zu git.exe in den Einstellungen von Android Studio festlegen
AndroidAPS-Code herunterladen
Build the app (generate signed apk)
APK-Datei auf das Smartphone übertragen
Identifiziere den Empfänger falls Du xDrip verwendest+
Schritt für Schritt Anleitung¶
Detailed description of the steps necessary to build the APK file.
Installiere git (falls du es noch nicht hast)¶
Follow the manual on the git installation page.
Android Studio installieren¶
The following screenshots have been taken from Android Studio Version Arctic Fox | 2020.3.1. Screens can change in future versions of Android Studio. But you should be able to find your way through. Help from the community is provided.
One of the most important things when installing Android Studio: Be patient! During installation and setup Android Studio is downloading a lot of stuff which will take its time.
Download Android Studio from here and install it on your computer.
On first start you will find the setup wizard:
Select „Do not import settings“ as you have not used it before.
Decide whether you want to share data with Google or not.
On the following screen click „Next“.
Select „Standard“ installation and click „Next“.
Select the theme for the user interface you like. (In this manual we used „Light“.) Then click „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.
Click „Finish“ on the „Verify Settings“ dialog.
Wait while Android Studio downloads additional components and be patient. Once everything is downloaded button „Finish“ turns blue. Click the button now.
Git-Pfad in Android Studio eintragen¶
Make sure git is installed on your computer and you have restarted your computer after installing.
On the Android Studio welcome screen click „Customize“ (1) on the left and then select the link „All settings…“ (2):
Windows¶
As windows user, make sure you have restarted your computer after installing Git.
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.
Wenn die automatische Einstellung möglich ist, wird die Git-Version hinter dem Pfad angezeigt.
Eventuell kann git.exe nicht automatisch gefunden werden oder der Test führt zu einem Fehler (1):
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).
Ü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).
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)
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.).
Klicke auf „Clone“ (5).
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“!
In der Statusleiste im unteren Teil des Fensters siehst Du die Information, dass Android Studio Hintergrundaufgaben ausführt.
Gewähre Zugriff, falls Dich Deine Firewall dazu auffordert.
Sobald die Hintergrund-Aufgaben beendet sind, wirst Du wahrscheinlich eine Fehlermeldung sehen, die besagt, dass Fehler aufgetreten sind (1) oder (2) oder (3).
Keine Sorge, das wird bald gelöst!
Download Android SDK¶
Gehe im Menü zu File (1) > Settings (2).
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).
Bestätige die Änderungen durch Klick auf OK.
Akzeptiere die Lizenzvereinbarung (1) und klicke auf „Next“ (2).
Warte, bis der SDK-Download und die Installation abgeschlossen sind.
Wenn die SDK-Installation abgeschlossen ist, wird der Button „Finish“ blau angezeigt. Klicke dann darauf.
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).
Wähle in der folgenden Dialogbox „Don’t remind me again for this project“ (2).
Starte Android Studio neu, bevor Du fortfährst.
Signierte APK erstellen (Generate signed APK)¶
Signing means that you indicate your app to be your own creation but in a digital way as a kind of digital fingerprint within the app itself. 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 this link.
Nachdem Android Studio gestartet wurde, musst Du warten, bis alle Hintergrundaufgaben abgeschlossen sind.
Warnung: Fahre mit den folgenden Schritten nicht fort, wenn Fehler auftreten. \ Schaue auf der Seite zur Problembehebung in Android Studio nach bekannten Problemen!
Klicke in der Menüzeile auf „Build“ (1) und wähle „Generate Signed Bundle / APK…“ (2).
Wähle „APK“ (1) statt „Android App Bundle“ aus und klicke auf „Next“ (2).
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.
Klicke das Ordner-Symbol, um den Pfad zu wählen, unter dem Dein key store auf Deinem PC gespeichert werden soll.
Wähle den Pfad, in dem Dein key store gespeichert werden soll (1).
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).
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. In case you will not remember your passwords in the future, see troubleshooting for lost 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).
Wähle die Build-Variante „fullRelease“ (1) und drücke „Finish“.
Android Studio zeigt im unteren Teil des Fensters „Gradle Build running“ an. Dies dauert eine Weile je nach Computer und Internetverbindung. Sei geduldig!
Android Studio zeigt „Generate Signed APK“ an, so bald die Erstellung der APK-Datei abgeschlossen ist.
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“.
Falls die Benrachrichtigung automatisch geschlossen wurde, kannst Du immer den „Event log“ öffen und dort den Link auswählen.
Dein Dateimanager (z.B. Windows Explorer) wird geöffnet. Navigiere zum Verzeichnis „full“ (1) > „release“ (2).
„app-full-release.apk“ (3) ist die von Dir gesuchte Datei!
Übertrage die APK-Datei auf das Smartphone¶
Easiest way to transfer app-full-release.apk to your phone is via USB cable or Google Drive. Please note that transfer by mail might cause difficulties and is not the preferred way.
On your phone you have to allow installation from unknown sources. Manuals how to do this can be found on the internet (i.e. here or here).
Problembehandlung¶
See separate page troubleshooting Android Studio.