Android programos (APK) kūrimas¶
Kurti sau, o ne parsisiųsti¶
Dėl reikalavimų medicininiams įrenginiams, nėra galimybės tiesiog parsisiųsti AndroidAPS programą. Programos kūrimas savo reikmėms yra visiškai teisėtas, tačiau jums neleidžiama perduoti jos kopijos kitiems! Žr. DUK dėl išsamesnės informacijos.
## Svarbios pastabos¶
- Norėdami sukurti APK failą, naudokite Android Studio 4.0.1 arba naujesnę versiją.
- Windows 10 32-bitų sistemos nėra palaikomos Android Studio 4.0.1.
Konfigūracija pagal pareikalavimą nepalaikoma dabartinėje Android Gradle modulio versijoje!
Jei sukurti APK nepavyko dėl pasirinktinės konfigūracijos klaidos, galite atlikti šiuos veiksmus:
- Atidarykite nustatymų langą spustelėdami File > Settings (Mac kompiuteryje Android Studio > Preferences).
- Kairiojoje srityje spustelėkite Build, Execution, Deployment > Compiler.
- Panaikinkite langelio „Configure on demand“ žymėjimą.
- Spustelėkite Apply arba OK.
Šis straipsnis yra padalintas į dvi dalis.¶
- Apžvalgos skyriuje paaiškinta, kokių veiksmų reikia norint sukurti APK failą.
- Žingsnis po žingsnio instrukcijose rasite konkretaus diegimo ekrano kopijas. Kadangi Android Studio versijos - programinės įrangos kūrimo aplinka, kurioje sukursime APK - keičiasi labai greitai, tikslios atitikties su savo kūrimu nepamatysite, tačiau susidarysite bendrą įspūdį, kaip tai daroma. Android Studio veikia Windows, Mac OS X ir Linux ir kiekvienoje platformoje gali būti nedidelių skirtumų. Jei pastebite, kad kažkas svarbaus neveikia tinkamai arba jo trūksta, praneškite Facebook grupėje “AndroidAPS users” arba Gitter kanale Android APS arba AndroidAPSwiki, kad galėtumėme išspręsti problemą.
Apžvalga¶
APK failui sukurti reikalingi šie veiksmai:
Žingsnis po žingsnio instrukcija¶
Detalus veiksmų, reikalingų sukurti APK failą, aprašymas.
Įdiegti git (jei neturite)¶
Vykdykite instrukcijas pagal git instaliavimo puslapį.
Android Studio įdiegimas¶
Šios ekrano kopijos yra iš Android Studio 3.6.1 versijos. Priklausomai nuo Android Studio versijos, jūsų ekranas gali atrodyti šiek tiek kitaip. Bet jūs vis tiek turėtumėte sugebėti susitvarkyti. Čia galite rasti bendruomenės pagalbą.
Vienas iš svarbiausių aspektų diegiant Android Studio yra: Būkite kantrūs! Diegiant ir nustatant Android Studio yra įkeliama daug duomenų ir tai užima daug laiko.
Įdiekite Android Studio ir nustatykite jį pirmojo paleidimo metu.
Pasirinkite „Do not import settings“, nes iki šiol nebuvo atlikta jokių nustatymų.
Nuspręsti, ar norite bendrinti duomenis su Google, ar ne.
Kitame ekrane spustelėkite “Next” (kitas).
Pasirinkite “Standart” instaliavimą ir spauskite “Next”.
Pasirinkite sąsajos dizainą, kuris jums labiausiai patinka. (Šiame vadove mes naudojamas “Light”.) Tada spustelėkite “Next” (kitas). Tai tik spalvų schema. Galite pasirinkti bet kurią norite (pvz., “Darcula” tamsiam režimui). Šis pasirinkimas neturi įtakos APK kūrimui.
“Verify Settings” (patvirtinti nustatymus) lange spustelėkite “Next”.
Palaukite, kol Android Studio siunčiasi papildomus komponentus ir būkite kantrūs. Kai viskas atsisiųs, mygtukas “Finish” (baigti) pamėlynuos. Spustelėkite mygtuką dabar.
Android Studio nustatymuose įveskite git kelią¶
Įsitikinkite, kad git yra įdiegta kompiuteryje.
Android Studio pasisveikinimo ekrane spustelėkite mažą trikampį (1. kitame paveikslėlį) ir pasirinkite “Settings” (Nustatymai) (2.).
Windows¶
Spustelėkite mažą trikampį šalia “Version Control” (1.) norėdami atidaryti sub-meniu.
Spustelėkite Git (2.).
Įsitikinkite, kad atnaujinimo metodas “Merge” (3.) yra pasirinktas.
Patikrinkite, ar Android Studio automatiškai randa kelią į git.exe, paspaudus mygtuką “Test” (4.)
Jei automatinis nustatymas sėkmingas, git versija bus rodoma.
Spauskite “OK” dialogo lange (1.) ir “OK” nustatymų lange (2.).
Jei failas git.exe negali būti rastas, spustelėkite “OK” dialogo lange (1.) ir tada mygtuką su trimis taškais (2.).
Naudokite paieškos funkcija “Windows explorer” rasti “git.exe” jei jūs nežinote, kur jį galima rasti. Jūs ieškote git.exe, esančiame \bin\ aplanke.
Pasirinkite kelią į git.exe ir įsitikinkite, kad jūs pasirinkote vieną iš ** \bin\ ** aplankų (3.) ir spustelėkite “OK” (4.).
Uždarykite nustatymų langą, paspausdami “OK” mygtuką (5.).
Perkraukite kompiuterį, kad atsinaujintų sistemos aplinka.
Mac¶
- Bet kuri git versija turėtų veikti. Pvz., https://git-scm.com/download/mac.
- Naudoti homebrew įdiegti git:
$ brew install git. - Daugiau informacijos, kaip įdiegti git, žr. oficialioji git dokumentacija.
- Jei įdiegiate git per homebrew, nereikia keisti jokių nuostatų. Jei prireiks: Jos gali būti randamos čia: Android Studio - Preferences.
Atsisiųsti AndroidAPS kodą¶
Jei dar neperkrovėte kompiuterio iš naujo, po git.exe kelio nustatymų, padarykite tai dabar. Sistemos aplinka turi būti atnaujinta.
Yra du variantai, kaip pradėti naują projektą:
Android Studio pasisveikinimo ekrane spustelėkite “Get from version control”
Jei jau atidarėte Android Studio ir nematote pasisveikinimo ekrano, pasirinkite File (1.) > New (2.) > Project from Version Control... (3.)
Įveskite pagrindinio AndroidAPS saugyklos puslapio URL (https://github.com/nightscout/AndroidAPS) (1.).
Pasirinkite katalogą, kuriame norite išsaugoti klonuotą kodą. (2.)
Spustelėkite mygtuką “Clone” (3.).
Nespauskite “Background” (vykdyti fone), o kol duomenų saugykla yra klonuojama!
Po duomenų saugyklos sėkmingo klonavimo, atidarykite savo vietinę kopiją, paspausdami “Yes”.
Apatiniame dešiniajame kampe pamatysite informaciją, kad Android Studio vykdo fonines užduotis.
Suteikite prieigą, jei ugniasienė prašo leidimo.
Kai foninės užduotys yra baigtos, jūs tikriausiai pamatysite tokį klaidos pranešimą:
Atsisiųskite AndroidAPS SDK¶
Spustelėkite File > Settings.
Spustelėkite mažą trikampį šalia Appearance & Behaviour (1.).
Spustelėkite mažą trikampį prie System Settings (2.) ir pasirinkite Android SDK (3.)
Pažymėkite langelį kairėje “Android 9.0 (Pie)” (4.) (API Level 28).
Patvirtinkite pakeitimus paspausdami OK.
Sutikite su licencijos nuostatomis (1.) ir spustelėkite “Next” (2.).
Palaukite, kol baigsis diegimas.
Kai SDK diegimas bus baigtas, “Finish” mygtukas pamėlynuos. Spustelėkite mygtuką dabar.
Android Studio gali rekomenduoti atnaujinti gradle sistemą. Niekada neatnaujinkite gradle! Tai gali sukelti problemų!
Jei apatinėje dešinėje Android Studio lango pusėje matote informaciją, kad Android Gradle papildinį galima atnaujinti, spustelėkite tekstą „update“ (1.) ir dialogo lange “Don’t remind me again for this project” (Nepriminti vėl šiam projektui) (2.).
Generuoti pasirašytą APK (Generate signed APK)¶
Pasirašymas reiškia, kad jūs pasirašote savo sukurtą programą, skaitmenine prasme reiškia tam tikrą skaitmeninį pirštų atspaudą pačioje programoje. Programą būtina pasirašyti skaitmeniniu būdu, nes Android saugumo sumetimais priima tik pasirašytą kodą. Daugiau informacijos apie šią temą, spauskite šią nuorodą.
Spustelėkite “Build” (Sukurti) meniu juostoje ir pasirinkite “Generate Signed Bundle / APK...” (Generuoti pasirašomą rinkinį / APK...).
Pasirinkite “APK” (1.) vietoje “Android App Bundle” ir spauskite “Next” (2.).
Įsitikinkite, kad modulis yra nustatytas, į “app” (1.).
Spustelėkite “Create new...” (2.), kad pradėtumėte kurti savo raktų saugyklą.
Tai ne kas kita, kaip failas, kuriame saugoma jūsų programos parašo informacija. Ji šifruojama, ir informacija apsaugota slaptažodžiais.
Spustelėkite aplanko simbolį (1.), kad pasirinktumėte savo rakto saugyklos kelią.
Pasirinkite kelią, kur jūsų raktų saugykla turi būti išsaugota (2.). Nesaugokite tame pačiame aplanke, kuriame yra projektas. Jūs turite naudoti kitą aplanką! Galimas variantas yra jūsų pagrindinis katalogas.
Įveskite failo vardą savo raktų saugyklai (3.).
Spustelėkite “OK” (4.).
Raktų saugyklos ir pačių raktų slaptažodžiai neturi būti labai sudėtingi. Įsitikinkite, kad juos prisiminsite, arba užsirašykite ir laikykite saugioje vietoje. Tuo atveju, jei neprisiminsite slaptažodžio ateityje, skaitykite pamestų raktų saugyklų trikčių šalinimas.
Įveskite (5.) ir patvirtinkite (6.) raktų saugyklos slaptažodį.
Atlikite tą patį ir raktui (7. + 8.).
Galiojimas (9.) 25 metus, kaip nustatyta. Jums nereikia pakeisti nustatytų reikšmių.
Vardas ir pavardė turi būti įrašyti (10.). Visa kita informacija yra neprivaloma.
Spustelėkite “OK” (11.) kai baigsite.
Įsitikinkite, kad langelis prisiminti slaptažodžius (remember passwords), yra pažymėtas (1.). Taigi jums nereikia įvesti juos kitą kartą, kai kursite apk (t. y. kai atnaujinima į naują AndroidAPS versiją).
Spustelėkite “Next” (2.).
Pasirinkite kūrimo variantą “fullRelease” (1.).
Pažymėkite langelius V1 ir V2 parašo versijoms(2.).
Spustelėkite “Finish”. (3.)
Android Studio bus rodoma informacija “APK(s) generated successfully...”(APK(s) sukurtas sėkmingai...), kai kūrimas bus baigtas.
Jei kūrimas nebuvo sėkmingas, skaitykite trikčių diagnostikos skiltį.
Lengviausias būdas surasti sukurtą APK, spustelėkite ant “Event log” (įvykių žurnalai).
Įvykių žurnalo skiltyje spauskite “locate” (surasti).
failo, kurio ieškote, pavadinimas yra app-full-release.apk.
Perkelkite APK į išmanųjį telefoną¶
Lengviausias būdas perkelti app-full-release.apk failą į telefoną yra USB kabeliu ar Google Disku. Prašome atkreipti dėmesį, kad perdavimas elektroniniu paštu gali sukelti sunkumų ir nėra tinkamiausias būdas.
Jūsų telefone jūs turite leisti diegti programas iš nežinomų šaltinių. Instrukcijas, kaip tai padaryti, galima rasti internete (pvz., čia arba čia).
Identifikuoti gavėją, jei naudojate xDrip+¶
Trikčių šalinimas¶
Žr. atskirą puslapį, kuriame pateiktas Android Studio trikčių šalinimas.