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

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

Ž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ų.

Neimportuoti nustatymų

Nuspręsti, ar norite bendrinti duomenis su Google, ar ne.

Dalintis duomenimis su Google

Kitame ekrane spustelėkite “Next” (kitas).

Pasisveikinimo ekranas

Pasirinkite “Standart” instaliavimą ir spauskite “Next”.

Standartinis instaliavimas

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.

UI Spalvų schema

“Verify Settings” (patvirtinti nustatymus) lange spustelėkite “Next”.

Patvirtinti nustatymus

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.

Komponentai atsisiunčiami

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

Android Studio nustatymai pasisveikinimo ekrane

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

Android Studio nustatymai

  • Jei automatinis nustatymas sėkmingas, git versija bus rodoma.
  • Spauskite “OK” dialogo lange (1.) ir “OK” nustatymų lange (2.).

Automatinis git instaliavimas pavyko

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

Automatinis git instaliavimas nepavyko

  • 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 dokumentacijoje.
  • 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.
  • Android Studio pasisveikinimo ekrane spustelėkite mažas trikampį dešinėje “Check out project from version control” (1.).
  • Pasirinkite “Git” (2.).

Patikrinti projektą iš Versijos kontrolės pasisveikinimo ekrane

  • Jei jau atidarėte Android Studio ir nematote pasisveikinimo ekrano, pasirinkite File (1.) > New (2.) > Project from Version Control... (3.) > Git (4.).

Patikrinti projektą iš Versijos kontrolės Android Studio

  • Įveskite pagrindinio AndroidAPS saugyklos puslapio URL (nuorodą_ (“https://github.com/MilosKozak/AndroidAPS”) (1.).
  • Pasirinkite katalogą, kuriame norite išsaugoti klonuotą kodą.
  • Spustelėkite mygtuką “Test” (2.).
  • Jei testas negali būti baigtas sėkmingai, patikrinkite URL (nuorodą), pataisykite, jei reikia, ir spauskite “Test” dar kartą.
  • Jei URL yra įvestas teisingai, bus rodomas “Connection successful” (3.).
  • Spustelėkite mygtuką “Clone” (4.).

Klonuoti saugyklą

  • Nespauskite “Background” (vykdyti fone), o kol duomenų saugykla yra klonuojama!

Klonuoti saugyklą - jokių foninių veiksmų

  • Po duomenų saugyklos sėkmingo klonavimo, atidarykite savo vietinę kopiją, paspausdami “Yes”.

Atidaryti saugyklą

  • Apatiniame dešiniajame kampe pamatysite informaciją, kad Android Studio vykdo fonines užduotis.

Foninis veikimas

  • Suteikite prieigą, jei ugniasienė prašo leidimo.

Ugniasienės leidimas java

  • Kai foninės užduotys yra baigtos, jūs tikriausiai pamatysite tokį klaidos pranešimą:

SDK licencija

Atsisiųskite AndroidAPS SDK

  • Spustelėkite File > Settings.

Atidaryti nustatymus

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

SDK nustatymai

  • Patvirtinkite pakeitimus paspausdami OK.

Patvirtinti SDK pakeitimus

  • Sutikite su licencijos nuostatomis (1.) ir spustelėkite “Next” (2.).

Priimti SDK licenciją

  • Palaukite, kol baigsis diegimas.

Palaukti, kol SDK diegiamas

  • Kai SDK diegimas bus baigtas, “Finish” mygtukas pamėlynuos. Spustelėkite mygtuką dabar.

Baigti SDK diegimą

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

Neatnaujinti Gradle

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

Kurti apk

  • Pasirinkite “APK” (1.) vietoje “Android App Bundle” ir spauskite “Next” (2.).

APK vietoj rinkinio

  • Į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.

Sukurti raktų saugyklą

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

Raktų saugyklos kelias

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

Atsiminti slaptažodžius

  • Pasirinkite kūrimo variantą “fullRelease” (1.).
  • Pažymėkite langelius V1 ir V2 parašo versijoms(2.).
  • Spustelėkite “Finish”. (3.)

Baigti kūrimą

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

Kūrimas sėkmingas - įvykių žurnalas

  • Įvykių žurnalo skiltyje spauskite “locate” (surasti).

Įvykių žurnalas - raskite apk

  • failo, kurio ieškote, pavadinimas yra app-full-release.apk.

APK failo vieta

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+

Žr. xDrip+ puslapyje

Trikčių šalinimas

Žr. atskirą puslapį, kuriame pateiktas Android Studio trikčių šalinimas.