Bouwen van de app


Let op bij het bouwen van de AndroidAPS 2.0 apk: Configuration on demand wordt niet ondersteund door de huidige versie van de Android Gradle plugin! Als je een foutmelding krijgt die gaat over “on demand configuration” kun je het volgende doen:

 *  *Open het instellingen venster, door op File > Settings (voor Mac: Android Studio > Preferences) te klikken.*
*  *In het linker subvenster, klik op Build, Execution, Deployment > Compiler.*
*  *Haal het vinkje weg bij "Configure on demand".*
*  *Klik op Apply of OK.*

Dit artikel is verdeeld in twee delen.

  • In het overzicht gedeelte wordt uitgelegd welke stappen je moet nemen om de APK (APK is het bestandsformaat van een app) te bouwen.
  • In de stap voor stap instructie vind je heel gedetailleerd wat je moet doen, met behulp van screenshots. Omdat van Android Studio (het programma waarin je de APK bouwt) vaak een nieuwe versie uitkomt, kan het zijn dat de screenshots niet helemaal hetzelfde zijn als jouw versie maar het is een goede houvast. Android Studio kun je gebruiken onder Windows, Mac OS X en Linux, er kunnen kleine verschillen zitten tussen deze besturingssystemen. Als je vindt dat een belangrijke stap onjuist is of ontbreekt, stel er dan een vraag over in de facebook groep “AndroidAPS gebruikers” of in de Gitter chats Android APS of AndroidAPSwiki zodat we hiernaar kunnen kijken.

Overzicht

De belangrijkste stappen voor het bouwen van het APK bestand zijn:

  • Git installeren
  • Android Studio installeren en instellen
  • Gebruik Git clone, om een kopie (‘kloon’) van de broncode voor AndroidAPS te downloaden vanaf Github.
  • Open het gedownloade project in Android Studio.
  • Bouw de ondertekende APK.
  • Zet de ondertekende APK op jouw telefoon.

Stap voor stap instructie

Gedetailleerde beschrijving van de verschillende stappen.

Installeer Git + Android Studio

  • Git installeren
    • Windows
    • Mac OS X
    • Linux - installeer simpelweg een ‘Package Git’ van de ‘Package Manager’ die bij jouw Linux-Distribution hoort
  • Installeer Android Studio.
  • Instellen van Android Studio als je hem voor het eerst opstart

Selecteer “Do not import settings” (instellingen niet importeren) omdat je het nog niet eerder hebt gebruikt.

Screenshot 1

Klik “Next” (volgende).

Screenshot 2

Selecteer “Standard” Installation en klik op “Next”.

Screenshot 3

Selecteer “Intellij” als thema voor UI (gebruikersinterface) en klik op “Next”.

Screenshot 4

Klik op “Next” in het dialoogvenster “Verify Settings” (instellingen controleren).

Screenshot 5

De Android emulator (hiermee boots je een smartphone na op je computer) wordt niet gebruikt bij het bouwen van de APK. Klik op “Finish” om de installatie af te ronden, de documentatie kun je later lezen wanneer je wilt.

Screenshot 6

Android Studio gaat nu allerlei software-onderdelen downloaden. Je kunt klikken op de knop “Show Details” (details weergeven) om te zien wat er precies gebeurt, maar het is niet nodig om dat allemaal te weten.

Screenshot 7

Screenshot 8

Wanneer hij klaar is met downloaden, klik op “Finish” (afronden).

Screenshot 9

  • Gefeliciteerd! Je hebt nu Android Studio succesvol geïnstalleerd en je kunt beginnen met het klonen van de broncode. Misschien is het even tijd voor pauze?

Code en extra componenten downloaden

  • Gebruik Git clone in Android Studio zoals in onderstaande screenshots te zien is. Selecteer “Check out project from Version Control” en kies “Git” als versie controle systeem.

Screenshot 10 Version_Control_Git

Vul de URL in van de hoofdpagina van de AndroidAPS Repository (“https://github.com/MilosKozak/AndroidAPS”) en klik op “Clone”.

Screenshot 13

Android Studio zal nu het project gaan klonen (kopiëren). Klik niet op “Background” (achtergrond). Dit gaat snel en wanneer je het naar de achtergrond verplaatst, maak je het onnodig ingewikkeld voor nu.

Screenshot 14

Je krijgt de melding dat de “checkout from version control” (het klonen) is afgerond. Open het project door op “Yes” te klikken.

Screenshot 15

Gebruik de standaard “default gradle wrapper” en klik “OK”.

Screenshot 16

Lees en sluit het scherm van de “Tip of the Day” (tip van de dag) van Android Studio door te drukken op “Close” (sluiten).

Screenshot 17

  • Top! Je hebt jouw eigen kopie van de broncode en je bent klaar om de app te gaan bouwen.
  • Nu krijg je je eerste foutmelding. Gelukkig geeft Android Studio je direct de oplossing hiervoor.

Klik op “Install missing platform(s) and sync project” (ontbrekende platforms installeren en project synchroniseren). Android Studio zal nu een ontbrekend stuk software gaan installeren.

Screenshot 18

Accepteer de gebruiksrechtovereenkomst door op “Accept” en op “Next” te klikken.

Screenshot 19

Het dialoogvenster geeft aan “Please wait until the installation finishes” (wacht aub tot de installatie is afgerond) en dus wacht je even.

Screenshot 20

Wanneer hij een melding geeft dat dit is afgerond, klik je op “Finish” (afronden).

Screenshot 21

En dan... een volgende foutmelding. Maar ook hier geeft Android Studio je weer een vergelijkbare oplossing. Klik op “Install Build Tools and sync project” om de ontbrekende “Tools” te installeren.

Screenshot 22

Het dialoogvenster geeft aan “Please wait until the installation finishes” (wacht aub tot de installatie is afgerond) en dus wacht je even.

Screenshot 23

Wanneer hij een melding geeft dat dit is afgerond, klik je op “Finish” (afronden).

Screenshot 24

En een andere foutmelding omdat Android Studio weer een ontbrekend platform moet installeren. Klik weer op “Install missing platform(s) and sync project”.

Screenshot 25

Het dialoogvenster geeft aan “Please wait until the installation finishes” (wacht aub tot de installatie is afgerond) en dus wacht je even.

Screenshot 26

Wanneer hij een melding geeft dat dit is afgerond, klik je op “Finish” (afronden).

Screenshot 27

Klik op “Install Build Tools and sync project” om de ontbrekende “Tools” te installeren.

Screenshot 28

Het dialoogvenster geeft aan “Please wait until the installation finishes” (wacht aub tot de installatie is afgerond) en dus wacht je even.

Screenshot 29

Wanneer hij een melding geeft dat dit is afgerond, klik je op “Finish” (afronden).

Screenshot 30

Jippie! De foutmeldingen zijn voorbij en je bent begonnen. Misschien tijd om wat water te drinken?

Screenshot 31

Android Studio raad nu aan dat je de “Gradle Plugin” zult updaten naar versie 4.4. Wanneer je een oudere versie van AndroidAPS wilt bouwen (ouder dan een release candidate (RC) voor versie 2.0) dan sla je deze update over, door op “Remind me tomorrow” te klikken. Anders kun je de app niet succesvol bouwen. “Gradle” is een onderdeel van Android Studio dat het bouwen controleert. Voor AndroidAPS is het geen probleem om de oude versie van Gradle te gebruiken. De uiteindelijke APK zal niet anders zijn. Wanneer je AndroidAPS versie 2.0 of hoger wilt bouwen, dan kun je wel naar 4.4 updaten, klik op “Update”.

Screenshot 32

Hij gaat verder met bouwen...

Screenshot 33

Mooi, je hebt nu jouw eerste app “Build finished” (bouw afgerond). Maar we zijn nog niet klaar.

Screenshot 34

Bouwen van de ondertekende APK

Selecteer in het menu “Build” en vervolgens “Generate Signed Bundle / APK...”. (Het menu in Android Studio is gewijzigd per september 2018. In oudere versies selecteerde je in het menu “Build” en vervolgens “Generate Signed APK...”.)Ondertekenen betekent dat je de door jou gemaakte app ondertekent. Dit is een soort digitale vingerafdruk in de app zelf. Dat is nodig omdat Android om veiligheidsredenen voorschrijft dat een app altijd zo’n handtekening moet hebben. Voor meer informatie over dit onderwerp, volg de link hier. Veiligheid van apps is een groot en ingewikkeld onderwerp waarin je je niet verder hoeft te verdiepen.

Screenshot 39a

In het volgende dialoogvenster selecteer je “APK” in plaats van “Android App Bundle” en klik op “Volgende”.

Screenshot 39b

Selecteer “App” en klik op “Next”.

Screenshot 40

Klik op “Create new...” (maak nieuwe...) om jouw eigen key store (digitale handtekening) te maken. Een key store is een bestandje waarin de informatie van jouw handtekening is opgeslagen. Het bestandje is versleuteld en beveiligd met een wachtwoord. We raden aan om het op te slaan in jouw eigen map op je computer en om het wachtwoord goed te onthouden. Maar mocht je het bestandje of jouw wachtwoord kwijtraken dan is dat geen groot probleem, je moet dan gewoon een nieuwe maken. Het is goed om deze informatie zorgvuldig te bewaren.

Screenshot 41

  • Vul de volgende tekstvelden in.
    • Key store path: is de locatie waar je het bestandje met jouw handtekening opslaat
    • In de Password (wachtwoord) en Confirm (bevestig) velden vul je tweemaal het door jou gekozen wachtwoord in. Tweemaal om op typfouten te controleren.
    • Alias is de naam voor jouw handtekening. Je kunt de vooraf ingevulde tekst laten staan, of zelf een naam kiezen die je leuk vindt.
    • Ook hier moet je weer tweemaal een door jou gekozen wachtwoord invullen. Ook weer tweemaal, om op typfouten te controleren.
    • Je kunt de Validity (geldigheidsduur) op de standaardwaarde van 25 jaar laten staan.
    • Je hoeft alleen je First and Last Name (voor- en achternaam) in te vullen, de rest is optioneel. Klik daarna op “OK”.

Screenshot 42

Vul de informatie in van jouw handtekening die je zojuist hebt aangemaakt in het volgende venster en klik op “Next”.

Screenshot 43

Selecteer “full” (volledig) als “Flavour” (smaak) om de volledige AndroidAPS app te maken. Selecteer “V1 Jar Signature” (V2 is optioneel) en klik op “Finish”. De volgende informatie kan handig zijn voor later.

  • ‘Release’ is wat je hoort te kiezen als “Build Type”, ‘Debug’ is alleen voor programmeurs, om fouten op te sporen.
  • Kies de “Flavour” die je wilt bouwen:
    • full (dwz je pomp wordt automatisch aangestuurd tijdens closed looping)
    • openloop (dwz voorstellen voor tijdelijke basaalstanden, die de gebruiker handmatig op de pomp instelt)
    • pumpcontrol (dwz alleeneen afstandsbediening voor de pomp, zonder te loopen)
    • nsclient (dwz de gegevens van een andere gebruiker worden weergegeven en care portal bijdragen kunnen worden toegevoegd)

Screenshot 44

In het Event Log kun je zien dat de Signed APK (ondertekende APK) succesvol is gebouwd.

Screenshot 45

Klik op de “locate” link in het Event Log om hem de map te laten weergeven waar de APK file staat.

Screenshot 46

Overzetten van de APK naar je telefoon

Een Verkenner venster zal openen. Het kan dat het er iets anders uitziet, dit screenshot is met een Linux computer gemaakt. In Windows zal de “Verkenner” openen, op een Mac OS X de “Finder” Hier zul je de locatie zien waar de APK te vinden is. Helaas is dit de verkeerde locatie, omdat “wear-release.apk” niet de ondertekende app die we zoeken.

Screenshot 47

Om de juiste locatie te openen, ga naar de map met AndroidAPS/app/full/release om het bestand “app-full-release.apk” te vinden. Zet dit bestand op jouw Android telefoon. Dit kan op verschillende manieren, kies wat jij wilt (Bluetooth, cloud upload, email). Of gewoon met een USB kabeltje. In dit voorbeeld wordt Gmail gebruikt. Om de zelf-ondertekende app te kunnen installeren, moet je Android hiervoor toestemming geven ookal is dit bestand via Gmail ontvangen, wat normaal gesproken niet toegestaan is. Als je een andere manier gebruikt om de APK over te zetten op je telefoon, geef dan de toestemmingen waar hij naar vraagt zodat je verder kunt.

Screenshot 48

In de instellingen van je telefoon is een optie om “Apps uit onbekende bronnen” toestemming te geven om te kunnen installeren. Daar moet je Gmail (in dit voorbeeld) toestemming geven om de APK te installeren.

Screenshot 49

Selecteer “Toestaan van deze bron”. Nadat je klaar bent met installeren, wordt het aanbevolen om de instellingen weer terug te zetten op “niet toestaan”.

Screenshot 50

De laatste stap is om op het APK bestand te tikken en de app te installeren. Als hij niet uit zichzelf installeert en je hebt een vorige versie van AndroidAPS op je telefoon staan die met een andere handtekening is ondertekend, dan moet je die versie van de app eerst verwijderen. Vergeet niet om eerst je instellingen van die versie te exporteren vóórdat je de app verwijdert!

Van harte! Je hebt de app geïnstalleerd op je telefoon en nu kun je verder met het instellen van AndroidAPS.