Building AAPS

Build yourself instead of download

The AAPS app (an apk file) is not available for download, due to regulations around 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.


Three methods are available to build the AAPS app:


Build with Android Studio

You can build the app with your computer using Android Studio. This used to be the only build option, nowadays Android Studio is mostly used by developers who consider making code changes.

Follow these instructions.


Build using the command-line

This option is intended for those who prefer to build AAPS in local command-line, without installing Android Studio.

Follow these instructions.


If the build fails

Each build method has its own troubleshooting section:

Lost your keystore or its password? See Reinstalling AAPS with a new keystore.

If the app is built but does not install on your phone, see Transferring and installing AAPS.

If your problem is not listed, see Where can I get help.