Aktualizace na novou verzi nebo větev (branch)

Important note: As of version 2.3 you have to use git to update. Updating via zip file does not work anymore.

Install git (if you don’t have it)

Windows

  • Měly by fungovat všechny verze gitu. Například https://git-scm.com/download/win

  • Make sure to note down the installation path. You will need it in the next step.

    Git installation path

  • Let Studio know where is git.exe located: File - Settings

    Android Studio - open settings

  • In the next window: Version Control - Git

  • Choose correct path: .../Git/bin

  • Make sure update method “Merge” is selected.

    Android Studio - GIT path

Mac

  • Měly by fungovat všechny verze gitu. 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.

Update your local copy

  • Click: VCS->Git->Fetch

    Android Studio - GIT - Fetch

Selecting branch

  • If you want to change branch select another branch from tray: master (latest release) or another version (please see below)

and then checkout (You can use ‘Checkout as New Branch’ if ‘Checkout’ is not available.)

 ![](../images/UpdateAAPS2.png)

Updating branch from Github

  • Press Ctrl+T, select Merge method and press OK

On the tray you’ll see green message about updated project

Vytvořte podepsaný soubor APK

V nabídce vyberte „Build“ a pak „Generate Signed Bundle / APK…“. (Nabídka Android Studio se v září 2018 změnila. Ve starších verzích vyberte nabídku „Build“ a pak „Generate Signed APK...“.)

Podepsání znamená, že podepíšete svou generovanou aplikaci, ale digitálním způsobem, něco jako digitálním otiskem prstu v samotné aplikaci. To je nezbytné, protože Android má pravidlo, že z bezpečnostních důvodů přijme pouze podepsaný kód. Pokud se o toto téma zajímáte, můžete si k tomu víc přečíst zde, ale Bezpečnost je hluboké a komplexní téma a teď ho nepotřebujete.

Snímek 39a

V následujícím dialogovém okně vyberte „APK“ místo „Android App Bundle“ a klepněte na tlačítko „Next“.

Snímek 39b

Zvolte „app“ a klepněte na tlačítko „Next“.

Snímek 40

Enter your key store path, enter key store password, select key alias and enter key password.

Select ‘Remember passwords’.

Then click next.

Key store path

Zvolte „full“ jako flavour generované aplikace. Zvolte V1 „Jar Signature“ (V2 je volitelné) a klikněte na tlačítko „Finish“. Následující údaje mohou být důležité pro pozdější použití.

  • Možnost „Release“ by měla být výchozí volbou pro „Build Type“, možnost „Debug“ je pouze pro vývojáře.
  • Vyberte typ sestavení, jaký budete chtít.
    • full (tj. automatické doporučení pro uzavřenou smyčku)
    • openloop (tj. doporučení pro uživatele s otevřenou smyčkou)
    • pumpcontrol (tj. vzdálené ovládání pumpy bez smyčky)
    • nsclient (tj. zobrazují se data jiného uživatele se smyčkou a lze vkládat záznamy ošetření)

Snímek 44

V podokně „Event Log“ vidíme, že podepsaný soubor APK byl úspěšně vygenerován.

Snímek 45

Klikněte na odkaz „locate“ v podokně „Event Log“.

Snímek 46

Přeneste soubor APK do telefonu

Objeví se okno správce souborů. Na vašem počítači může vypadat trochu jinak, protože já používám systém Linux. Pokud používáte sytém Windows, otevře se Průzkumník souborů, na platformě Mac OS X to bude Finder. V něm byste měli vidět složku s vygenerovaným souborem APK. Toto bohužel není správné umístění, protože „wear-release.apk“ není podepsaný soubor „app“ APK, který hledáme.

Snímek 47

Přejděte prosím do složky AndroidAPS/app/full/release a tam vyhledejte soubor „app-full-release.apk“. Přeneste tento soubor do telefonu s Androidem. Můžete to udělat způsobem, který upřednostňujete, přes Bluetooth, nahráním do cloudu, připojením telefonu k počítači pomocí kabelu nebo přes přílohu e-mailu. Já v této ukázce používám Gmail, jelikož je to pro mě poměrně jednoduché. Zmiňuji to proto, protože instalaci self-signed aplikace (certifikát podepsaný sám sebou) potřebujeme v systému Android výslovně povolit, i když byl soubor přijatý přes Gmail. Standardně je to totiž zakázané. Pokud použijete jinou metodu, zvolte vhodný postup.

Snímek 48

V nastavení telefonu je nabídka (instalovat neznámé aplikace), kde lze povolit instalaci APK souborů, které jsem si poslal přes Gmail.

Vyberte možnost „Povolit z tohoto zdroje“. Po instalaci můžete tuto volbu zase zakázat.

Instalace z neznámých zdrojů

Posledním krokem je klepnout na soubor APK, který jsem přijal přes Gmail, a nainstalovat aplikaci. Pokud se APK nechce nainstalovat a máte v telefonu již starší verzi AndroidAPS, pravděpodobně byla podepsaná jiným klíčem – v tom případě musíte starou verzi nejdřív odinstalovat, avšak nezapomeňte předtím exportovat svá nastavení!

Ano, máte to a můžete začít s úvodní konfigurací AndroidAPS (CGM, inzulínová pumpa) atd.

Check AAPS version on phone

You can check the AAPS version on your phone by clicking the three dots menu on the top right and then about.

AAPS version installed

Troubleshooting

Kotlin compiler warning

If build completed successfully but you get Kotlin compiler warnings then just ignore these warnings.

App was build successfully and can be transferred to phone.

ignore Kotline compiler warning

Could not download… / Offline Work

If you get a failure message like this

Warning could not download

make sure that ‘Offline work’ is disabled.

File -> Settings

Settings offline work

Uncommitted changes

If you receive failure message like

Failure uncommitted changes

Option 1

  • In Android Studio select VCS -> GIT -> Reset HEAD Reset HEAD

Option 2

  • Copy ‘git checkout –’ to clipboard (without quote signs)
  • Switch to Terminal in Android Studio (lower left side of Android Studio window) Android Studio Terminal
  • Paste copied text and press return GIT checkout success

App not installed

phone app note installed

  • Make sure you have transferred the “app-full-release.apk” file to your phone.
  • If “App not installed” is displayed on your phone follow these steps:
    1. Export settings (in AAPS version already installed on your phone)
    2. Uninstall AAPS on your phone.
    3. Enable airplane mode & turn off bluetooth.
    4. Install new version (“app-full-release.apk”)
    5. Importujte nastavení
    6. Turn bluetooth back on and disable airplane mode

App installed but old version

If you build the app successfully, transferred it to your phone and installed it successfully but the version number stays the same then you might have missed the merging step in the update manual.

None of the above worked

If non of the above tips helped you might consider building the app from scratch:

  1. Export settings (in AAPS version already installed on your phone)

  2. Have your key password and key store password ready In case you have forgotten passwords you can try to find them in project files as described here.

  3. Note down the path to your key store
    

    In Android Studio Build -> Generate Signed APK Key store path

  1. Build app from scratch as described here. Use existing key and key store.
  2. When you have build the APK successfully delete the exiting app on your phone, transfer the new apk to your phone and install.
  3. Importujte nastavení

Worst case scenario

In case even building the app from scratch does not solve your problem you might want to try to uninstall Android Studio completely. Some Users reported that this solved their problem.

Make sure to uninstall all files associated with Android Studio. Manuals can be found online i.e. https://stackoverflow.com/questions/39953495/how-to-completely-uninstall-android-studio-from-windowsv10.

Install Android Studio from scratch as described here and do not update gradle.