Bijwerken naar een nieuwe versie

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:

• Vanaf versie 2.3 moet je git gebruiken om te updaten. Bijwerken via zip-bestand werkt niet meer.
• Gebruik Android Studio Versie 3.5.1 of nieuwer om de apk te bouwen.
• Windows 10 32-bits systemen worden niet ondersteund door Android Studio 3.5.1.
• Als je “xDrip+” gebruikt, zorg dan dat je de instelling voor Identify receiver (identificeer ontvanger) hebt ingevuld in xDrip+.
• Als je de Dexcom G6 gebruikt met de aangepaste Dexcom-app, dan moet je de versie uit de 2.4 map gebruiken.

Snelle methode voor ervaren gebruikers

Sla deze alinea over als je app voor de eerste keer bijwerkt. De snelle methode is voor ervaren gebruikers. De eerste stap is Git installeren als je dit nog niet gedaan had.

If you already updated AAPS in previous versions and use a Windows PC you can update in four simple steps:

1. Export your settings from the existing AAPS version on your phone to be on the save side
2. Update local copy (VCS->Git->Pull)
3. Generate signed APK (Select ‘app’ instead of ‘wear’ on your way!)
4. Depending on your BG source make sure to identify receiver in xDrip or use the patched Dexcom app from the 2.4 folder.

Installeer Git (als je dat nog niet hebt)

Volg de handleiding op de git-installatiepagina.

Bijwerken van jouw lokale kopie

• Klik op: VCS-> Git-> Pull

  

• Klik op Pull (laat alles staan zoals het is in het dialoogvenster)

  

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 ga je naar het menu "Build" en klik vervolgens op "Generate Signed APK...".)

Ondertekenen betekent dat je een handtekening op jouw app zet, een soort digitale vingerafdruk. 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.

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

Selecteer “App” en klik op “Next”.

Enter your key store path, enter key store password, select key alias and enter key password.

Select ‘Remember passwords’.

Then click next.

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.
• Kies de “Flavour” die je wilt bouwen:
  • full/fullRelease (volledige versie van de app, deze heb je nodig om het systeem in closed loop modus te gebruiken)
  • openloop (je krijgt alleen voorstellen voor tijdelijke basaalstanden, die jij als gebruiker handmatig op de pomp moet invoeren)
  • pumpcontrol (functioneert alleen als afstandsbediening voor je pomp, zonder te loopen)
  • nsclient (je kunt de real time gegevens van een andere looper bekijken je kunt dingen invullen in de care portal van die andere looper, wordt gebruikt door ouders van een loopend kind)

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

Klik op de “locate” link in het Event Log.

Overzetten van de APK naar je telefoon

Export your settings from the existing AAPS version on your phone to be on the save side.

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 een map zien met daarin een APK bestand. Helaas is dit de VERKEERDE locatie, omdat "wear-release.apk" NIET de ondertekende app die we zoeken.

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. You can do it on your preferred way:

• Bluetooth
• Via de cloud (bijvoorbeeld Google Drive, Dropbox)
• Simpelweg met een usb kabeltje tussen computer en telefoon
• Via e-mail (let op: sommige e-mailapps hebben de mogelijkheid om een apk-bestand als bijlage toe te voegen, geblokkeerd. Kies dan één van bovenstaande opties.)

In dit voorbeeld wordt Gmail gebruikt omdat het vrij eenvoudig is. Om de zelf-ondertekende app te kunnen installeren, moet je Android hiervoor toestemming geven, ook al 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.

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.

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

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.

Controleer AAPS versie op telefoon

You can check the AAPS version on your phone by clicking the three dots menu on the top right and then about.

Problemen oplossen

Zie afzonderlijke pagina over Probleemoplossing Android Studio.