Version Updates – is it Time ?


iOS 14.5 and Xcode 12.5 are expected to be released by the end of April 2021.  Once this happens, you will no longer have the option to download iOS 14.4.2 and Xcode 12.4, and  It may take 2-3 weeks for Loop’s developers and our most tech-savvy Loopers to validate that Xcode 12.5 and iOS 14.5 are compatible with both operating and building Loop.

Don’t be caught unprepared, update your iOS and Xcode now before iOS 14.5 and Xcode 12.5 are released. Both iOS 14.4.2 and Xcode 12.4 are good to go for Loop. Dexcom G6 app is also confirmed to work with iOS 14.4.2.  You can update just the iOS without needing to rebuild, but remember our mantra of best practice when a new iOS comes out:

  • Wait for the report that the new iOS or new Xcode still works with Loop
  • Wait for the report that your CGM works with the new iOS
  • Update your computer to the correct version of Xcode first
  • Update for phone iOS second

Bookmark this page!  Come back when you have a version question in the future.

This page will be kept up-to-date as new versions are released.  You can also sign up for the newsletter, but to keep from spamming people, new version updates may not always be included in the newsletter, especially if it is for a minor version update.  So, this page is going to be your best “one-stop shop” to answer the general question.

Turn off auto-update

You never want your Loop phone to auto-update the iOS version. If you have not already done so, do this now:

  1. In iPhone Settings, go to General / Software Update / Automatic Updates.
  2. Turn off “Automatic Updates”.

Even if you have a good backup of your phone, it can be very difficult, sometimes impossible, to downgrade your phone once you upgrade the iOS.

It’s a good idea to do the same on your computer.  Both the operating system and Xcode should have auto-update turned off.

More Information

iOS 14.4.2 is the most recent iOS version that is verified as compatible with building Loop. Both 14.3 and 14.4 seem to solve the issues with prior versions of 14.x related to the Health app data filling up. Apple reports that iOS 14.4, 14.4.1, and 14.4.2 fixed security problems.

You should always be in a position to build Loop, if necessary. The best practice is to upgrade your build computer (Mac) before upgrading the iOS on your iPhone.

Of course, that’s your choice.  There have been no reported issues with updating to 14.4.2; Loop just keeps working. But if something happens where you must build – you’ll need to do all these steps without a working Loop app. Best to do it in a low-stress environment.

Steps for updating:

  1. Update your Mac OS (Catalina or Big Sur) and update Xcode to 12.4 using these instructions
  2. Make sure your iPhone backup is current, or do a manual backup if you don’t have them going to iCloud automatically
  3. Screen shot and save (off the phone) ALL your Loop settings screens, (don’t forget the Override screen)
  4. Verify that your Loop and Pump time are in sync (Use this doc if you need help with this)
  5. Update the phone to the latest iOS
  6. It’s always good to confirm Loop settings after an update

Settings Confirmation:

  • In iPhone settings, open the Loop or FreeAPS settings.
    • Make sure Bluetooth, Background App Refresh and Cellular Data are turned on
    • If you have FreeAPS, make sure Adaptive Rate is turned off
  • In iPhone settings, open Dexcom
    • Make sure everything is on (four green sliders)
  • In iPhone settings, open Health
    • Click on “Data Access & Devices”
    • Ensure that Dexcom can write Blood Glucose
    • Ensure that Loop or FreeAPS has everything turned on (six or seven green sliders depending on your version)
  • If you had to change anything in your iPhone settings, force close the Loop app and force reboot the phone
  • In iPhone settings, go to General / Software Update / Automatic Updates
    • Turn off “Automatic Updates”
    • You never want your Loop phone to auto-update the iOS version

Steps for building:

If you are going to Build Loop now, try the Build-Select script. It’s an easy and fast way to build Loop (master or automatic-bolus) or FreeAPS.

If you are having issues with upgrading Xcode, picking a branch, understanding how to ask for help with building or many other issues with Loop, look at the menus at the top of this page for other useful articles.


Skip to content