Sestavení APK

Vyrobte si místo stažení

AndroidAPS není k dispozici ke stažení kvůli regulaci zdravotnických zařízení. Je legální vytvořit aplikaci pro své vlastní použití, ale nesmíte dát kopii ostatním! Další informace naleznete v části Časté dotazy.

## Důležité poznámky

Configuration on demand (Konfigurace na vyžádání) není aktuální verzí plug-inu Android Gradle podporována!

Jestliže vytváření apk selže s chybou “on demand configuration”, proveďte následující změnu:

  • Otevřete okno Preferences klepnutím na File > Settings (na platformě Mac, Android Studio > Preferences).
  • V levé části pak na Build, Execution, Deployment > Compiler.
  • Zrušte označení možnosti Configure on demand.
  • Klepněte na tlačítko použít nebo OK.

Tento článek je rozdělený do dvou částí.

  • V části Přehled najdete vysvětlení, které kroky jsou obecně nutné, abyste sestavili soubor APK.
  • V části Průvodce krok za krokem najdete snímky obrazovky z konkrétní instalace. Jelikož se Android Studio (vývojové prostředí, které použijeme k sestavení APK) v čase mění velmi rychle, nebudou snímky úplně shodné s vaší instalací, ale určitě vám poskytnou dobrý záchytný bod. Android studio běží na Windows, Linuxu a Mac OS X, a proto mohou být na různých platformách malé rozdíly. Jestliže najdete něco zásadního, co je špatně nebo vám něco chybí, prosím informujte o tom facebookovou skupinu „AndroidAPS users“ nebo použijte Gitter chat Android APS nebo AndroidAPSwiki, abychom se na to mohli podívat.

Průvodce krok za krokem

Následuje detailní popis kroků nutných k sestavení souboru APK.

Nainstalujte git (pokud ho ještě nemáte)

Postupujte podle návodu na stránka instalace gitu.

Instalace Android Studio

Následující snímky obrazovky byly převzaty z aplikace Android Studio verze 3.6.1. Máte-li vyšší verzi aplikace Android Studio, může Vaše obrazovka vypadat trochu jinak. Měli byste však být schopni najít cestu. K dispozici je pomoc od komunity.

Jedna z nejdůležitějších věcí při instalaci aplikace Android Studio: Buďte trpěliví! Během instalace a nastavení aplikace Android Studio se stahuje spousta věcí, které zaberou spoustu času.

Nainstalujte Android Studio a proveďte nastavení během prvního spuštění.

Zvolte “Do not import settings”, protože jste tento software zatím nevyužívali.

Do not import settings

Rozhodněte se, zda chcete či nechcete sdílet data se společností Google.

Share data with Google

Na následující obrazovce klepněte na tlačítko „Další“.

Welcome screen

Vyberte „Standard“ instalaci a klikněte na „Next“.

Standard installation

Vyberte si motiv uživatelského rozhraní, který se vám líbí. (V tomto návodu jsme použili „Light“.) Poté klikněte na „Next“. Jedná se pouze o barevný motiv. Můžete si vybrat jakýkoli jiný (např. „Darcula“ pro tmavý režim). Tato volba nemá žádný vliv na sestavení APK.

UI color scheme

V dialogovém okně „Verify Settings“ klikněte na „Next“.

Verify settings

Buďte trpěliví - vyčkejte, dokud Android Studio nestáhne potřebné komponenty. Jakmile je vše staženo, tlačítko „Finish“ se zbarví modře. Klikněte na něj.

Downloading components

Nastavení cesty k nástroji git v předvolbách

Ujistěte se, že na svém počítači máte nainstalován git.

Na úvodní obrazovce aplikace Android Studio klepněte na malý trojúhelník (1. v dalším snímku obrazovky) a vyberte „Settings“ (2.).

Android Studio settings from welcome screen

Windows

  • Click the small triangle next to 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.)

Android Studio settings

  • If automatic setting is successful git version will be displayed.
  • Click “OK” in the dialog box (1.) and “OK” in the settings window (2.).

Automatic git installation succeeded

  • In case file git.exe cannot be found click “OK” in the dialog box (1.) and then the button with the three dots (2.).
  • Use search function in windows explorer to find “git.exe” if you are unsure where it can be found. You are looking for 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.).
  • Close settings window by clicking “OK” button (5.).

Automatic git installation failed

  • Reboot your computer to update system environment.

Mac

  • Měly by fungovat všechny verze gitu. Například https://git-scm.com/download/mac.
  • Použijte homebrew k instalaci gitu: $ brew install git.
  • Detaily o instalaci gitu naleznete v oficiální dokumentaci gitu.
  • Pokud instalujete git přes homebrew, není třeba měnit žádné předvolby. Pokud by bylo třeba: Najdete je zde: Android Studio - Preferences.

Stáhněte si kód AndroidAPS

  • If you haven’t already rebooted your computer after setting git path in preferences do it now. System environment must be updated.
  • On the Android Studio welcome screen click the small triangle right of “Check out project from version control” (1.).
  • Select “Git” (2.).

Check out project from version control from welcome screen

  • If you already opened Android Studio and do not see the welcome screen anymore select File (1.) > New (2.) > Project from Version Control... (3.) > Git (4.).

Check out project from version control within Android Studio

  • Fill in the URL to the main AndroidAPS repository (“https://github.com/MilosKozak/AndroidAPS”) (1.).
  • Choose the directory where you want to save the cloned code.
  • Click button “Test” (2.).
  • If test cannot be completed successfully check URL, correct and click “Test” again.
  • If URL is entered correctly “Connection successful” (3.) will be shown.
  • Click button “Clone” (4.).

Clone repository

  • Do not click “Background” while repository is cloned!

Clone repository - no background action

  • After repository is cloned successfully open your local copy by clicking “Yes”.

Open repository

  • In the lower right corner you will see the information that Android Studio is running background tasks.

Background tasks

  • Grant access if your firewall is asking for permission.

Firewall permission java

  • Once the background tasks are finished you will probably see the following error message:

SDK licence

Stáhněte Android SDK

  • Click File > Settings.

Open settings

  • Click the small triangle next to Appearance & Behaviour (1.).
  • Click the small triangle next to System Settings (2.) and select Android SDK (3.)
  • Check the box left of “Android 9.0 (Pie)” (4.) (API Level 28).

SDK settings

  • Confirm changes by clicking OK.

Confirm SDK changes

  • Accept licence agreement (1.) and click “Next” (2.).

Accept SDK licence

  • Wait until installation is finished.

Wait during SDK installation

  • When SDK installation is completed the “Finish” button will turn blue. Click this button.

Finish SDK installation

  • Android Studio might recommend to update the gradle system. Nikdy neaktualizujte gradle! Mohlo by to vše zkomplikovat!
  • 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 “update” (1.) and in the dialog box on “Don’t remind me again for this project” (2.).

No cradle update

Vytvořte podepsaný soubor 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. To je nezbytné, protože Android má pravidlo, že z bezpečnostních důvodů přijme pouze podepsaný kód. For more information on this topic, follow this link.

  • Click “Build” in the menu bar and select “Generate Signed Bundle / APK...”.

Build apk

  • Select “APK” (1.) instead of “Android App Bundle” and click “Next” (2.).

APK instead of bundle

  • Make sure that module is set to “app” (1.).

  • Click “Create new...” (2.) to start creating your key store.

    A key store in this case is nothing more than a file in which the information for signing is stored. Je zašifrované a údaje jsou zabezpečené hesly.

Create key store

  • Click the folder symbol (1.) to select your key store path.
  • Select the path where your key store shall be saved (2.). Do not save in same folder as project. You must use a different directory! One option might be your home folder.
  • Type a file name for your key store (3.).
  • Click “OK” (4.).
  • Passwords for key store and key do not have to be very sophisticated. Make sure to remember those or make a note in a safe place. In case you will not remember your passwords in the future you see troubleshooting for lost key store.
  • Enter (5.) and confirm (6.) the password for your key store.
  • Do the same for your key (7. + 8.).
  • Validity (9.) is 25 years by default. You do not have to change the default value.
  • First and last name must be entered (10.). All other information is optional.
  • Click “OK” (11.) when you are done.

Cesta k úložišti klíčů

  • Make sure the box to remember passwords is checked (1.). So you don’t have to enter them again next time you build the apk (i.e. when updating to a new AndroidAPS version).
  • Click “Next” (2.).

Remember passwords

  • Select build variant “fullRelease” (1.).
  • Check boxes V1 and V2 for signature versions (2.).
  • Click “Finish”. (3.)

Finish build

  • Android Studio will display the information “APK(s) generated successfully...” after build is finished.
  • In case build was not successful refer to the troubleshooting section.
  • Easiest way to find the apk is to click on “Event log”.

Build successfully - event log

  • In the event log section click “locate”.

Event log - locate apk

  • app-full-release.apk is the file you are looking for.

File location apk

Přeneste soubor APK do telefonu

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).

Možnost „Identify receiver“ při používání xDripu+

Viz stránka xDrip+

Poradce při potížích

Viz samostatná stránka odstraňování potíží s Android Studiem.