Update auf eine neue Version oder branch

Kein Download möglich - APK muss selbst erstellt werden

AAPS is not available to download, due to regulations concerning medical devices. 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 update to the new version of AAPS as soon as possible after a new release is available.

  • When a new release is available, in the AAPS app itself, you will receive an information banner about the new version.

  • The new version will also be announced on Facebook at the time of release.

  • Following the release, please read the Release Notes in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update.

  • For AAPS versions 2.7 and newer, the location for the new files is at https://github.com/nightscout/AndroidAPS.

  • The easiest way to update AAPS is to remove the directory with AAPS and do a new clone.

  • If you are unsure about how to do this, you can also completely uninstall and reinstall Android Studio to make sure the build is a success.

  • Ideally, use the latest version of Android Studio, Giraffe, 2022.3.1, but at least Arctic Fox (2020.3.1) or newer, to build the updated AAPS apk.

  • If building the AAPS app using a Windows platform, you will need to use a Windows 64-bit system since 32-bit systems are not supported.

Overview for updating to a new version of AAPS

  1. Export your settings from the existing AAPS version on your phone. You might not need it, but better be safe than sorry.

  2. Update local copy of the AAPS sourcecode (Git->Fetch and Git -> Pull)

  3. Erstelle signierte APK

  4. Übertrage die erstellte APK-Datei auf Dein Smartphone und installiere sie.

  5. Check the version in AAPS

  6. Stelle abhängig von Deiner BZ-Quelle sicher, dass Du ‚identify receiver‘ in xDrip+ gesetzt hast oder verwende die ‚Build your own Dexcom App‘.

Für den Fall, dass Probleme auftreten, findest Du Lösungsansätze auf der separaten Seite für Fehlerbehebung von Android Studio.

1. Exportiere Deine Einstellungen

Falls Du Dir nicht mehr sicher bist, wie dies genau funktioniert, findest Du die Anleitung auf der Seite Einstellungen exportieren & importieren.

2. Führe ein Update deiner lokalen Version durch

Ab Version 2.7 wurde der Speicherort des Repositories auf https://github.com/nightscout/AndroidAPS geändert. If you are not familiar with git the easiest way for update is remove directory with AAPS on your disk and follow the instructions to do a New clone.

Wenn Du die URL bereits geändert hast oder von Version 2.8.x updatest, folge diesen Schritten:

  • Open your existing AAPS project with Android Studio. Möglicherweise musst Du Dein Projekt wählen. (Double) click on the AAPS project.

    Android Studio - Projekt auswählen

  • Wähle in der Menüleiste von Android Studio Git -> Fetch.

    Android Studio Menü - Git - Fetch

  • Unten rechts wird Dir eine Meldung angezeigt, sobald der Fetch erfolgreich durchgeführt wurde.

    Android Studio Menü - Git - Fetch erfolgreich

  • Wähle nun in der Menüleiste Git -> Pull.

    Android Studio Menü - Git - Pull

  • Lasse alle Optionen wie sie sind (Original/Master) und wähle Pull.

    Android Studio - Git - Pull-Dialog

  • Warte ab, während der Download läuft. Du siehst dazu einen Hinweis in der Fußzeile. Eine Erfolgsmeldung wird angezeigt, so bald erfolgreich heruntergeladen wurde. Hinweis: Die Zahl der Dateien, die aktualisiert wurden, kann variieren! Dies ist kein Hinweis auf einen Download-Fehler.

    Android Studio - Pull erfolgreich

  • Gradle Sync wird ein paar Sekunden benötigen, um einige Abhängigkeiten herunterzuladen. Warte, bis es fertig ist.

    Android Studio - Gradle Sync

3. Erstelle die signierte APK

Dein Sourcecode ist jetzt die aktuelle veröffentlichte Version. Es ist an der Zeit, die signierte apk wie im Build signed apk Abschnitt beschrieben.

4. Übertrage die APK-Datei

Du musst die APK-Datei auf Dein Smartphone übertragen, um sie dort installieren zu können.

Siehe die Anleitung für APK auf Smartphone übertragen

5. APK installieren

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). Hinweis: Wenn Du beim Erstellen Deinen bestehenden ‚key store‘ im Android Studio verwendest hast, muss die alte AAPS nicht vom Smartphone deinstalliert werden. Um die APK zu installieren, folge den Anweisungen während des Updatevorgangs. In allen anderen Fällen (z.B. wenn ein neuer ‚key store‘ für das Signieren der APK genutzt wurde), muss die alte App gelöscht werden, bevor die neue Version installiert werden kann.

6. AAPS-Version auf dem Smartphone überprüfen

Nachdem Du die neue APK-Datei installiert hast, kannst Du auf dem Smartphone die Version prüfen. Gehe dazu oben rechts auf die drei Punkte und wähle dann „Über“. Du solltest die aktuelle Version angezeigt bekommen.

Installierte AAPS Version

Problembehandlung

Keine Panik, wenn irgendetwas schiefläuft.

Tief durchatmen!

Wirf dann einen Blick auf die Lösungsansätze der separaten Seite zur Fehlerbehebung für Android Studio. In den meisten Fällen dürfte Dein Problem und eine Lösung dort zu finden sein.