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! See FAQ page for details.
## Důležité poznámky¶
- Please use Android Studio Version 3.5.1 or newer to build the apk.
- Windows 10 32-bit systems are not supported by Android Studio 3.5.1.
Configuration on demand is not supported by the current version of the Android Gradle plugin!
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.
Přehled¶
Následují obecné kroky k sestavení souboru APK:
- Nainstalujte git
- Nainstalujte a nastavte Android Studio.
- Použijte git, abyste si naklonovali zdrojové kódy z centrálního úložiště na Githubu, kam vývojáři umístili nejnovější zdrojové kódy aplikace.
- Otevřete naklonovaný projekt v Android Studiu jako aktivní projekt.
- Sestavete podepsané APK.
- Přeneste podepsané APK do svého telefonu.
Průvodce krok za krokem¶
Následuje detailní popis kroků nutných k sestavení souboru APK.
Nainstalujte git (pokud ho ještě nemáte)¶
Follow the manual on the git installation page.
Instalace Android Studio¶
Následující snímky obrazovky byly převzaty z aplikace Android Studio verze 3.1.3. Vaše obrazovka by mohla vypadat trochu jinak, v závislosti na verzi aplikace Android Studio, kterou používáte. Měli byste však být schopni najít cestu. Pomoc komunity je poskytována například ve facebookové skupině AndroidAPS a na dalších místech.
Nainstalujte Android Studio a proveďte úvodní nastavení.
Zvolte “Do not import settings”, protože jste tento software zatím nevyužívali.
Klikněte na „Next“.
Vyberte “Standard” instalaci a klikněte na „Next“.
Vyberte si motiv uživatelského rozhraní, který se vám líbí. (V tomto návodu používáme “Intellij”. Poté klikněte na tlačítko „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.
Klikněte na „Next“ v dialogovém okně „Verify Settings“.
Emulátor Androidu (pro simulaci telefonu na vašem PC nebo Macu) se pro sestavení APK nepoužívá. Můžete kliknout na „Finish“, abyste dokončili instalaci a odložili četbu dokumentace na později.
Android Studio stahuje velké množství softwarových komponent, které používá. Můžete kliknout na tlačítko „Show Details“ pro zobrazení detailů, které ale vůbec nejsou důležité.
Jakmile jsou stahování dokončena, klikněte na tlačítko „Finish“.
- Hurá, hurá, nyní jste dokončili instalaci Android Studia a můžete začít s klonováním zdrojových souborů. Možná je teď vhodná doba na krátkou přestávku?
Nastavení cesty k nástroji git v předvolbách¶
Windows¶
Zadejte do Studia umístění souboru git.exe: File - Settings
„Validity (years)“ můžete ponechat na výchozí hodnotě 25.
Zvolte správnou cestu: .../Git/bin
Ujistěte se, že je vybrána metoda aktualizace „Merge“.
Mac¶
- 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 a další komponenty¶
- Použijte klonování gitu v Android Studiu, jak je vidět na snímku níže. Zvolte „Check out project from Version Control“ s „Git“ jako konkrétní verzí správce zdrojových kódů.
Zadejte URL adresu do hlavního úložiště AndroidAPS („https://github.com/MilosKozak/AndroidAPS“) a klepněte na „Clone“.
Android Studio začne s klonováním. Neklikejte na „Background“, což by věci nyní pouze zkomplikovalo.
Dokončete načtení projektu od správce zdrojových kódů kliknutím na „Yes“, což projekt otevře.
Použijte standardní „default gradle wrapper“ a klikněte na „OK“.
Přečtěte si okno „Tip of Day“ a kliknutím na „Close“ je zavřete.
- Super, máte vlastní kopii zdrojového kódu a jste připraveni na vytvoření Apk.
- Nyní se blížíme k první chybové zprávě. Naštěstí nám Android Studio nabídne její řešení.
Klikněte na „Install missing platform(s) and sync project“, protože Android Studio potřebuje doinstalovat chybějící platformu.
Přijměte licenční ujednání zvolením „Accept“ a klikněte na „Next“.
Jak již bylo řečeno v dialogovém okně, počkejte, než se stahování dokončí.
Nyní je dokončené. Klikněte prosím na tlačítko „Finish“.
Aaaach, další chyba. Ale Android Studio navrhuje podobné řešení. Klikněte na „Install Build Tools and sync project“, protože Android Studio potřebuje stáhnout chybějící pomůcky.
Jak již bylo řečeno v dialogovém okně, počkejte, než se stahování dokončí.
Nyní je dokončené. Klikněte prosím na tlačítko „Finish“.
A další chyba k řešení, protože Android Studio potřebuje zase stáhnout chybějící platformu. Klikněte na „Install missing platform(s) and sync project“.
Jak již bylo řečeno v dialogovém okně, počkejte, než se stahování dokončí.
Nyní je dokončené. Klikněte prosím na tlačítko „Finish“.
Klikněte na „Install Build Tools and sync project“, protože Android Studio potřebuje stáhnout chybějící pomůcky.
Jak již bylo řečeno v dialogovém okně, počkejte, než se stahování dokončí.
Nyní je dokončené. Klikněte prosím na tlačítko „Finish“.
Ano, chybové zprávy jsou pryč a první gradle sestavení běží. Možná je čas dát si trochu vody?
Android Studio doporučuje aktualizaci systému gradle. Nikdy neaktualizujte gradle! Mohlo by to vše zkomplikovat!
Klikněte prosím na „Znovu nepřipomínat pro tento projekt“.
Sestavení zase běží.
Ano, první sestavení bylo úspěšné, ale ještě nejsme hotoví.
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 poté „Generate Signed APK“.
Podepsání znamená, že podepíšete vygenerovanou aplikaci, ale digitálním způsobem, jakoby nějakým digitálním otiskem prstu uvnitř samotné aplikace. 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.
V následujícím dialogovém okně vyberte „APK“ místo „Android App Bundle“ a klepněte na tlačítko „Next“.
Zvolte „app“ a klepněte na tlačítko „Next“.
Klepněte na „Create new...“ a vytvořte úložiště svých klíčů. Úložiště klíčů v tomto případě není nic jiného než soubor, ve kterém jsou uložené podepisovací informace. Je zašifrované a údaje jsou zabezpečené hesly. Doporučujeme, abyste si ho uložili do své domovské složky a zapamatovali si hesla. Kdybyste však tyto informace ztratili, nebyl by to tak velký problém, protože potom byste prostě museli vytvořit nové úložiště klíčů. Ale lepší je tyto údaje pečlivě uložit.
- Vyplňte údaje pro další dialogové okno.
- Key store path: je cesta k vašemu úložišti klíčů. Do not save in same folder as projekt. You must use a different directory!
- Políčka s hesly níže jsou pro úložiště klíčů a jsou zdvojená, aby se zabránilo překlepům.
- Alias je název pro klíč, který potřebujete. Můžete ponechat výchozí, anebo si vybrat jakýkoli jiný název.
- Políčka s hesly pod tím jsou pro samotný klíč. Jako vždy jsou zdvojená, aby se zabránilo překlepům.
- You can let the validity at the default of 25 years.
- You only have to fill out first name and last name but feel free to complete the rest of information. Then click “OK”.
Fill in the information of the last dialog in this dialog and click “Next”.
Select “full” (or “fullRelease”) as flavour for the generated app. Select V1 “Jar Signature” (V2 is optional) and click “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 / fullRelease (i.e. recommendations automatically enacted in closed looping)
- 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í)
V podokně „Event Log“ vidíme, že podepsaný soubor APK byl úspěšně vygenerován.
Klikněte na odkaz „locate“ v podokně „Event Log“.
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.
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. You can do it on your preferred way, i.e.
- Bluetooth
- cloud upload (Google Drive or other cloud services)
- connect computer and phone by cable
- by mail (Note that some mail apps do not allow apk attachments, in this case use other transfer method.)
In this example Gmail is used as it is fairly simple. To install the self-signed app you need to allow Android on your smartphone to do this installation even if this file is received via Gmail which is normally forbidden. Pokud použijete jinou metodu, zvolte vhodný postup.
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.
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.
Identify receiver if using xDrip+¶
Poradce při potížích¶
See separate page troubleshooting Android Studio.