Bouwen van de app

Zelf bouwen, in plaats van downloaden

AndroidAPS is niet beschikbaar als download vanwege regelgeving voor medische hulpmiddelen. Het is wettelijk wel toegestaan om de app voor eigen gebruik te bouwen, maar het is verboden om de kant-en-klare app te verspreiden. Zie de Veelgestelde vragen pagina voor meer informatie.

Belangrijk:

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 Preferences (Voorkeuren) venster door op File > Settings (Bestand > Instellingen) te klikken (op Mac, Android Studio > Voorkeuren).
  • In het linkerscherm, klik op Build, Execution, Deployment > Compiler.
  • Vink de Configure on demand checkbox uit.
  • Klik op Apply (Toepassen) of OK.

Step by step walkthrough

Detailed description of the steps necessary to build the APK file.

Installeer Git (als je dat nog niet hebt)

Volg de handleiding op de git-installatiepagina.

Installeer Git + Android Studio

The following screenshots have been taken from Android Studio Version 3.6.1. Your screen might look a bit different if you use a newer version of Android Studio. But you should be able to find your way through. Help from the community is provided.

One of the most important things when installing Android Studio: Be patient! During installation and setup Android Studio is downloading a lot of stuff which will take its time.

Install Android Studio and setup during first start.

Select “Do not import settings” as you have not used it before.

Do not import settings

Decide whether you want to share data with Google or not.

Share data with Google

On the following screen click “Next”.

Welcome screen

Select “Standard” installation and click “Next”.

Standard installation

Select the theme for the user interface you like. (In this manual we used “Light”.) Then click “Next”. This is just the color scheme. You can select any you like (i.e. “Darcula” for dark mode). This selection has no influence on building the APK.

UI color scheme

Click “Finish” on the “Verify Settings” dialog.

Verify settings

Wait while Android Studio downloads additional components and be patient. Once everything is downloaded button “Finish” turns blue. Click the button now.

Downloading components

Set git path in preferences

Make sure git is installed on your computer.

On the Android Studio welcome screen click the small triangle (1. in next screenshot) and select “Settings” (2.).

Android Studio settings from welcome screen

Windows

  • Klik op het driehoekje naast Version Control “versiebeheer” (1.) om het submenu te openen.

  • Klik op Git (2.).

  • Zorg ervoor dat de update methode Merge “Samenvoegen” (3.)is geselecteerd.

  • Controleer of Android Studio het pad naar git.exe automatisch heeft gevonden door te klikken op de knop “Test” (4.)

    Android Studio instellingen

  • Als hij hem heeft gevonden, zal het git versienummer worden getoond.

  • Klik op “OK” in het dialoogvenster (1.) en “OK” in het instellingenvenster (2.).

    Automatische installatie van git geslaagd

  • Als hij het bestand git.exe niet heeft kunnen vinden klik “OK” in het dialoogvenster (1.) en dan de knop met de drie stipjes (2.).

  • Gebruik zoekfunctie in windows verkenner om “git.exe” te vinden als je niet zeker weet waar op jouw computer het git bestand staat. Je moet zoeken naar git.exe in een map die \bin\ heet.

  • Selecteer het pad naar git.exe en zorg ervoor dat je de map hebt geselecteerd in de ** \bin\ ** map (3.) en klik op “OK” (4.).

  • Sluit het instellingen venster door te klikken op de “OK” knop (5.).

    Automatische installatie van git mislukt

  • Start de PC opnieuw op om de installatie van Android Studio af te ronden.

Mac

  • Elke versie van Git zou moeten werken. Bijvoorbeeld https://git-scm.com/download/mac. Volg de instructies op die site om Git te installeren.
  • Gebruik homebrew om git te installeren: $ brew install git.
  • Voor meer informatie over het installeren van git zie de officiële git documentatie.
  • Als je git installeert via homebrew, hoef je niets aan de instellingen te wijzigen. Voor het geval je ze toch zoekt: je vind ze hier: Android Studio - Preferences.

AndroidAPS-code downloaden

  • Als je je computer nog niet hebt heropgestart nadat je het git pad in voorkeuren hebt ingesteld, doe het dan nu. Als je dit niet doet krijg je later een foutmelding.

  • Er zijn twee opties om een nieuw project te starten:

    • Op het welkomstscherm van Android Studio klik op “Get from version control” (Haal op van versiebeheer)

      Project uitchecken van versiebeheer vanaf welkomstscherm

    • Als je Android Studio al geopend had en het welkomstscherm niet meer ziet, selecteer je File (1.) > New (2.) > Project from Version Control... (Bestand (1.) > Nieuw (2.) > Project van versiebeheer...) (3.)

      Project uitchecken van versiebeheer vanuit Android studio

  • Vul de URL in van de hoofdpagina van de AndroidAPS Repository (https://github.com/nightscout/AndroidAPS) (1.).

  • Kies de map waar je de gedownloade code wilt opslaan. (2.)

  • Klik op de knop “Clone” (3.).

    Kloon repository

  • Klik niet op “Background” terwijl de code wordt gekloond!

    Geen achtergrondactie

  • Nadat de code is gedownload, open je jouw lokale kopie door te klikken op “Ja”.

    Open repository

  • In de rechterbenedenhoek zie je dat Android Studio achtergrondtaken uitvoert “background tasks running”.

    Achtergrondtaken

  • Verleen toegang als jouw firewall om toestemming vraagt.

    Firewall toestemming java

  • Zodra de achtergrondtaken zijn voltooid, zul je waarschijnlijk het volgende foutbericht zien:

    SDK licentie

Android SDK downloaden

  • Klik op File > Settings (Bestand > Instellingen).

    Instellingen openen

  • Klik op de kleine driehoek naast Appearance & Behaviour (1.) (Verschijning & Gedrag).

  • Klik op de kleine driehoek naast System Settings (2.) en selecteer Android SDK (3.).

  • Vink het vakje links van “Android 9.0 (Pie)” (4.) (API Level 28) aan.

    SDK instellingen

  • Bevestig door op OK te klikken.

    Bevestig SDK wijzigingen

  • Accepteer de licence agreement (1.) (licentieovereenkomst) en klik op “Next” (2.) (Volgende).

    SDK licentie accepteren

  • Wacht tot de installatie is voltooid.

    Wachten tijdens SDK installatie

  • Wanneer de SDK-installatie is voltooid zal de “Finish” knop blauw worden. Klik op de knop.

    Voltooi SDK installatie

  • Android Studio komt nu misschien met een “update Gradle” melding (Gradle bijwerken). Update Gradle nooit! Dit kan tot problemen leiden!

  • Als je een melding ziet aan de rechteronderkant van het Android Studio scherm waarin iets staat over “Android Gradle Plugin is ready to update” (dat de Android Gradle Plugin klaar is om te updaten) klik dan op de tekst “update” (1.) en in het dialoogvenster op “Don’t remind me again for this prject” (2.) (Herinner me niet opnieuw voor dit project).

    Geen cradle update

Bouwen van de ondertekende 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. That is necessary because Android has a rule that it only accepts signed code to run for security reasons. For more information on this topic, follow this link.

  • Klik op “Build” in de menubalk en kies “Generate Signed Bundle / APK...” (Ondertekende Bundel/APK genereren...).

    Apk bouwen

  • Selecteer “APK” (1.) in plaats van “Android App Bundle” en klik op “Next” (2.).

    APK in plaats van bundel

  • Zorg dat de module is ingesteld op “app” (1.).

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

    Maak key store

  • Klik op het mapsymbool (1.) om te selecteren waar jouw key store bestandje moet worden opgeslagen.

  • Selecteer een map (submap) waar jouw key store moet worden opgeslagen (2.). Sla dit NIET op in dezelfde map als jouw project. Je moet het in een andere map opslaan! Bijvoorbeeld ergens in je persoonlijke bestanden.

  • Typ een bestandsnaam voor jouw key store (3.).

  • Klik op “OK” (4.).

  • Je hoeft niet een heel ingewikkeld wachtwoord te kiezen voor de key store en de key. Zorg er wel voor dat je deze onthoudt of noteer ze op een veilige plek. Je hebt ze telkens nodig wanneer je een nieuwe versie van de app moet bouwen als er een update is uitgekomen. In het geval dat je jouw wachtwoorden toch vergeet zie probleemoplossing bij verloren key store.

  • Typ (5.) en bevestig (6.) het wachtwoord voor jouw key store.

  • Doe hetzelfde voor jouw key (7. + 8.).

  • Geldigheid (9.) is standaard 25 jaar. Je hoeft de standaardwaarde niet te wijzigen.

  • De voor- en de achternaam velden moeten worden ingevuld (10.). Alle andere informatie is optioneel.

  • Klik op “OK” (11.) als je klaar bent.

    Key store bestandslocatie

  • Zorg ervoor dat het vakje om wachtwoorden te onthouden is geselecteerd (1.). Zodat je ze niet opnieuw hoeft in te voeren de volgende keer dat je de apk bouwt (d.w.z. bij het updaten naar een nieuwe AndroidAPS versie).

  • Klik op “Next” (2.).

    Wachtwoorden onthouden

  • Selecteer de buildvariant “fullRelease” (1.).

  • Selecteer de hokjes V1 en V2 voor de handtekeningversies (2.).

  • Klik op “Finish”. (3.)

    Bouwen voltooien

  • Android Studio laat het je weten wanneer de APK succesvol is gebouwd: “APK(s) generated succesfully...”.

  • In het geval dat de APK niet succesvol is gebouwd, verwijzen we je naar de pagina Problemen oplossen.

  • De makkelijkste manier om de apk te vinden is door te klikken op “Event log”.

    Succesvol gebouwd - event log

  • Klik in de event log sectie op “locate”.

    Event log - zoek apk

  • app-full-release.apk is het bestand dat je nodig hebt.

    Bestandslocatie apk

Overzetten van de APK naar je telefoon

De eenvoudigste manier om app-full-release.apk over te zetten op je telefoon is via USB-kabel of Google Drive. Overdracht per e-mail kan leiden tot problemen (veel e-mailprogramma’s blokkeren apk-bestanden als bijlage) en is dus niet de makkelijkste manier.

Op jouw telefoon moet je installatie uit onbekende bronnen toestaan. Je vindt dit ergens in je telefooninstellingen, waarschijnlijk onder Beveiliging. Handleidingen hoe dit te doen kun je op internet vinden (bijv. hier of hier).

Identify receiver (identificeer ontvanger) bij gebruik van xDrip+

See xDrip+ page

Problemen oplossen

Zie afzonderlijke pagina over Probleemoplossing Android Studio.