Release notes

Please follow the instructions in the update manual. You can also find a troubleshooting section addressing the most common difficulties when updating on the update manual page.

You will receive the following information as soon as a new update is available:

Update info

Then you have 60 days to update. If you do not update within these 60 days AAPS will fall back to LGS (low glucose suspend - see glossary) as in objective 6.

If you do not update for another 30 days (90 days from new release date) AAPS will switch to Open Loop.

Please understand that this change is not intended to bug you but is due to safety reasons. New versions of AndroidAPS do not only provide new features but also important safety fixes. Therefore it is neccessary that every user updates a.s.a.p.. Unfortunately there are still bug reports from very old versions so this is a try to improve safety for every single user and the whole DIY community. Thanks for your understanding.

Version 2.7.0

Release date: 24-09-2020

Repository location changed to . If you are not familiar with git the easiest way for update is remove directory with AndroidAPS and do a new clone.

As already announced some time ago, Android 7 is minimum requirement for AndroidAPS 2.7.

Please use Android Studio 3.6.1 or newer to build the apk.

Make sure to check and adjust settings after updating to 2.7 as described here.

You need at least start objective 11 in order to continue using Automation feature (all previous objectives must be completed otherwise starting Objective 11 is not possible). If for example you did not finish the exam in objective 3 yet, you will have to complete the exam before you can start objective 11. This will not effect other objectives you have already finished. You will keep all finished objectives!

Major new features


Release date: 04-05-2020

Please use Android Studio 3.6.1 or newer to build the apk.

Major new features

  • Insight: Disable vibration on bolus for firmware version 3 - second attempt
  • Otherwise is equal to Update is optional.


Release date: 03-05-2020

Please use Android Studio 3.6.1 or newer to build the apk.

Major new features

  • Insight: Disable vibration on bolus for firmware version 3
  • Otherwise is equal to Update is optional.


Release date: 19-04-2020

Please use Android Studio 3.6.1 or newer to build the apk.

Major new features

  • Fix crashing in Insight service
  • Otherwise is equal to If you are not affected by this bug you don’t need to upgrade.


Release date: 06-04-2020

Please use Android Studio 3.6.1 or newer to build the apk.

Major new features

  • Resolves SMS CARBS command issue while using Combo pump
  • Otherwise is equal to 2.6.1. If you are not affected by this bug you don’t need to upgrade.

Version 2.6.1

Release date: 21-03-2020

Please use Android Studio 3.6.1 or newer to build the apk.

Major new features

  • Allow to enter only https:// in NSClient settings
  • Fixed BGI displaying bug on watches
  • Fixed small UI bugs
  • Fixed Insight crashes
  • Fixed future carbs with Combo pump
  • Fixed LocalProfile -> NS sync
  • Insight alerts improvements
  • Improved detection of boluses from pump history
  • Fixed NSClient connection settings (wifi, charging)
  • Fixed sending of calibrations to xDrip

Version 2.6.0

Release date: 29-02-2020

Please use Android Studio 3.6.1 or newer to build the apk.

Major new features

  • Small design changes (startpage...)
  • Careportal tab / menu removed - more details here
  • New Local Profile plugin
    • Local profile can hold more than 1 profile
    • Profiles can be cloned and edited
    • Ability of upload profiles to NS
    • Old profile switches can be cloned to new profile in LocalProfile (timeshift and percentage is applied)
    • Veritical NumberPicker for targets
  • SimpleProfile is removed
  • Extended bolus feature - closed loop will be disabled
  • MDT plugin: Fixed bug with duplicated entries
  • Units are not specified in profile but it’s global setting
  • Added new settings to startup wizard
  • Different UI and internal improvements
  • Wear complications
  • Fixed language support
  • Objectives: Allow to go back, Time fetching dialog
  • Automation: allow sorting
  • Automation: fixed bug when automation was running with disabled loop
  • New status line for Combo
  • GlucoseStatus improvement
  • Fixed TempTarget NS sync
  • New statistics activity
  • Allow Extended bolus in open loop mode
  • Android 10 alarm support
  • Tons on new translations

Version 2.5.1

Release date: 31-10-2019

Please note the important notes and limitations listed for version 2.5.0. * Fixed a bug in the network state receiver that lead to crashes with many (not critical but would waste a lot of energy re-calculating things). * New versioning that will allow to do minor updates without triggering the update-notification.

Version 2.5.0

Release date: 26-10-2019

Important notes

Is this update for me? Currently is NOT supported

  • Android 5 and lower
  • Poctech
  • 600SeriesUploader
  • Patched Dexcom from 2.3 directory

Major new features

  • Internal change of targetSDK to 28 (Android 9), jetpack support

  • RxJava2, Okhttp3, Retrofit support

  • Old Medtronic pumps support (RileyLink need)

  • New Automation plugin

  • Allow to bolus only part from bolus wizard calculation

  • Rendering insulin activity

  • Adjusting IOB predictions by autosense result

  • New support for patched Dexcom apks (2.4 folder)

  • Signature verifier

  • Allow to bypass objectives for OpenAPS users

  • New objectives - exam, application handling

    (If you started at least objective “Starting on an open loop” in previous versions exam is optional.)

  • Fixed bug in Dana* drivers where false time difference was reported

  • Fixed bug in SMS communicator

Version 2.3

Release date: 25-04-2019

Major new features

  • Important safety fix for Insight (really important if you use Insight!)
  • Fix History-Browser
  • Fix delta calculations
  • Language updates
  • Check for GIT and warn on gradle upgrade
  • More automatic testing
  • Fixing potential crash in AlarmSound Service (thanks @lee-b !)
  • Fix broadcast of BG data (works independently of SMS permission now!)
  • New Version-Checker

Version 2.2.2

Release date: 07-04-2019

Major new features

  • Autosens fix: deactivate TT raises/lowers target
  • New translations
  • Insight driver fixes
  • SMS plugin fix

Version 2.2

Release date: 29-03-2019

Major new features

  • DST fix
  • Wear Update
  • SMS plugin update
  • Go back in objectives.
  • Stop loop if phone disk is full

Version 2.1

Release date: 03-03-2019

Major new features

  • Accu-Chek Insight support (by Tebbe Ubben and JamOrHam)
  • Status lights on main screen (Nico Schmitz)
  • Daylight saving time helper (Roumen Georgiev)
  • Fix processing profile names comming from NS (Johannes Mockenhaupt)
  • Fix UI blocking (Johannes Mockenhaupt)
  • Support for updated G5 app (Tebbe Ubben and Milos Kozak)
  • G6, Poctech, Tomato, Eversense BG source support (Tebbe Ubben and Milos Kozak)
  • Fixed disabling SMB from preferences (Johannes Mockenhaupt)


  • If you are using non default smbmaxminutes value you have to setup this value again

Version 2.0

Release date: 03-11-2018

Major new features

  • oref1/SMB support (oref1 documentation) Be sure to read the documentation to know what to expect of SMB, how it will behave, what it can achive and how to use it so it can operate smoothly.
  • _Accu-Chek Combo pump support
  • Setup wizard: guides you through the process of setting up AndroidAPS

Settings to adjust when switching from AMA to SMB

  • Objective 10 must be started for SMBs to be enabled (SMB tab generally shows what restrictions apply)

  • maxIOB now includes _all_ IOB, not just added basal. That is, if given a bolus of 8 U for a meal and maxIOB is 7 U, no SMBs will be delivered until IOB drops below 7 U.

  • min_5m_carbimpact default has changed from 3 to 8 going from AMA to SMB. If you are upgrading from AMA to SMB, you have to change it manualy

  • Note when building AndroidAPS 2.0 apk: Configuration on demand is not supported by the current version of the Android Gradle plugin! If your build fails with an error regarding “on demand configuration” you can do the following:

    • Open the Preferences window by clicking File > Settings (on Mac, Android Studio > Preferences).
    • In the left pane, click Build, Execution, Deployment > Compiler.
    • Uncheck the Configure on demand checkbox.
    • Click Apply or OK.

Overview tab

  • Top ribbon gives access to suspend/disable loop, view/adjust profile and to start/stop temporary targets (TTs). TTs use defaults set in preferences. The new Hypo TT option is a high temp TT to prevent the loop from too aggressively overcorrection rescue carbs.
  • Treatment buttons: old treatment button still available, but hidden by default. Visibility of buttons can now be configured. New insulin button, new carbs button (including eCarbs/extended carbs)
  • Colored prediction lines
  • Option to show a notes field in insulin/carbs/calculator/prime+fill dialogs, which are uploaded to NS
  • Updated prime/fill dialog allows priming and creating careportal entries for site change and cartridge change


  • Separate build variant dropped, included in regular full build now. To use bolus controls from watch, enable this setting on the phone
  • Wizard now only asks for carbs (and percentage if enabled in watch settings). Which parameters are included in the calculation can be configured in the settings on the phone
  • confirmations and info dialogs now work on wear 2.0 as well
  • Added eCarbs menu entry

New plugins

  • PocTech app as BG source
  • Dexcom patched app as BG source
  • oref1 sensitivity plugin


  • App now uses drawer to show all plugins; plugins selected as visible in config builder are shown as tabs on top (favourites)
  • Overhaul for config builder and objectives tabs, adding descriptions
  • New app icon
  • Lots of improvements and bugfixes
  • Nightscout-independant alerts if pump is unreachable for a longer time (e.g. depleted pump battery) and missed BG readings (see _Local alerts_ in settings)
  • Option to keep screen on
  • Option to show notification as Android notification
  • Advanced filtering (allowing to always enable SMB and 6h after meals) supported with patched Dexcom app or xDrip with G5 native mode as BG source.