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
Please use Android Studio Giraffe“ (2022.3.1) or newer to build the apk.
Windows 32-bit systems are not supported by Android Studio
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 keep 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. 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 eine Empfohlung und ist nicht zwingend erforderlich. Du kannst auch eine normale Festplatte verwenden. Beachte aber, dass der Prozess zur Erstellung der APK-Datei dann länger dauert. 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.
Übersicht
Kurzfassung der wichtigsten Schritte zum Erstellen der APK Datei:
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 zurechtfinden. 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.
Entscheide, ob Du Daten mit Google teilen möchtest oder nicht.
Klicke auf dem nächsten Bildschirm den Button „Next“.
Wähle “Standard” Installation und klicke auf “Next”.
Wähle das Design für die Benutzeroberfläche, welches 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.
Click „Next“ on the „Verify Settings“ dialog.
Click on all three license agreement parts and select „Agree“. When you have agreed to all, the „Finish“ button will be enabled and you can „Finish“.
Wait while Android Studio downloads additional components and be patient. Once everything is downloaded button „Finish“ turns blue. Click the button now.
Download AAPS-Code
On the Android Studio welcome screen select „Projects“ (1) on the left and then „Get from VCS“ (2).
If you already opened Android Studio and do not see the welcome screen anymore select File (1) > New (2) > Project from Version Control… (3)
We will now tell Android Studio were to get the code from:
Make sure you have selected „Repository URL“ on the left (1).
Check if „Git“ is selected as version control (2).
Copy and paste the URL
https://github.com/nightscout/AndroidAPSto the main AAPS repository into the URL textbox (3).Choose the directory where you want to save the cloned code (4).
Click button „Clone“ (5).
Do not click „Background“ while repository is cloned!
After the repository is cloned successfully, Android Studio will open the cloned project.
You will be asked whether you want to trust the project. Click on „Trust project“!
In the status bar at the bottom you will see the information that Android Studio is running background tasks.
Windows only: Grant access if your firewall is asking for permission.
Once the background tasks are finished you will probably see an error saying that errors occurred (1) or (2) or (3).
Don’t worry, this will be solved soon!
Set git path in preferences
Make sure git is installed on your computer and you have restarted your computer since 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.
Gehe im Menü auf Datei (1) > Einstellungen (2) (oder Android Studio > Einstellungen auf dem Mac).
Double-click „Version Control“ (1) to open the sub-menu.
Click Git (2).
Make sure update method „Merge“ (3) is selected.
Check if Android Studio can locate path to git.exe automatically by clicking the button „Test“ (4).
If automatic setting is successful git version will be displayed next to the path.
Eventually git.exe cannot be found automatically or the Test will result in an error (1):
In this case click on the folder icon (2).
Use search function in windows explorer to find „git.exe“ if you are unsure where git has been installed. You are looking for a file named „git.exe“, located in \bin folder.
Select path to git.exe and make sure you selected the one in ** \bin\ ** folder (3) and click „OK“ (4).
Check your selected git path again with the „Test“ button as described above.
When the git version is displayed next to the path (see screenshot above), close settings window by clicking „OK“ button (5).
Mac
Any git version should work. For example https://git-scm.com/download/mac.
Use homebrew to install git:
$ brew install git.For details on installing git see the official git documentation.
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 Android SDK
Gehe im Menü auf Datei (1) > Einstellungen (2) (oder Android Studio > Einstellungen auf dem Mac).
Double-click on Languages & Frameworks to open its submenu (1).
Select Android SDK (2).
Tick the box left of „Android 9.0 (Pie)“ (3) (API Level 28).
Bestätige die Änderungen durch Klick auf OK.
Wait until the SDK download and installation is finished.
When SDK installation is completed the „Finish“ button will turn blue. Click this button.
Android Studio might recommend to update the gradle system. Never update gradle! This will lead to difficulties!
If you see an information on the lower right side of your Android Studio window that Android Gradle Plugin is ready to update click on the text „upgrade“ (1).
In the dialog box the select „Don’t remind me again for this project“ (2).
Restart Android Studio before you continue.
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).
Make sure that module is set to „AndroidAPS.app“ (1).
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. 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).
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.