Update to a new version or branch

Build yourself instead of download

AAPS is not available to download, due to regulations concerning medical devices. It is legal to build the app for your own use, but you must not give a copy to others! See FAQ page for details.

Important notes

  • Please update to the new version of AAPS as soon as possible after a new release is available.

  • When a new release is available, in the AAPS app itself, you will receive an information banner about the new version.

  • The new version will also be announced on Facebook at the time of release.

  • Following the release, please read the Release Notes in detail, and clarify any queries with the community on Facebook or Discord, before proceeding with the update.

  • Updating from AAPS 3.x? Read What changed in AAPS v4 first: it lists the features that moved, were renamed or were removed.

  • Do not forget to export your settings. When you import them again after the update, you choose whether the pump settings are replaced too.

Update AAPS with browser build

You already built your AAPS app with a browser? Follow the instructions for the method you used:

  • AAPS Builder: you build from the Build AAPS page of your private repository (usually named my-aaps) and download the app from GitHub. Follow Updating AAPS with AAPS Builder. There is no fork to sync.

  • Fork and preparation file: you run the AAPS-CI workflow in your own copy (fork) of AndroidAPS, a repository named AndroidAPS in your GitHub account, and the app lands in your Google Drive. Follow Update with a browser (fork).

Update AAPS with Android Studio

Follow these instructions.

Update AAPS with the command-line

Use the same instructions as when building AAPS previously, but pull new changes with git.

After the update

These steps are the same for every build method. Check in the Release Notes if there are any specific instructions after update.

After you installed the new apk:

  • you can check the AAPS version on your phone by opening the menu (☰) on the top left and then About (as per the screenshot below). The current AAPS version can be viewed;

  • make sure you have imported your settings; and

  • please check your AAPS settings under Settings and ensure these remain accurate.

About dialog with the AAPS version installed