// Collapsable Mobile Menus

Version Updates – is it Time?

This page reviews how to update your iPhone’s iOS by FIRST updating your Mac’s OS and Xcode versions.

Yes, Apple has released iOS 15.2, Xcode 13.2.1 and macOS 12.1, so it’s time to update.

Loop has been updated to be compatible with iOS 15.x and Xcode 13.x

Check your Loop app’s expiration date to decide how much time you have before you are required to rebuild. If you try to build Loop using incompatible versions of iOS, macOS, and Xcode, you’ll get the dreaded “iPhone is not available” error message.

If you’d like to update to iOS 15.2: 

  • iOS 15.x will only build using Xcode 13.x
  • Xcode 13.x requires macOS Big Sur or Monterey
  • Xcode 13.x will only build using Loop (Workspace)
  • We recommend that you use the Build Select Script 
  • For more information, please read this important update in Loopdocs

If you run into trouble trying to build Loop using the steps below, remember to use command+shift+3 to take screenshots of your error messages AND include detailed information about what went wrong and what steps you’ve taken. 

WARNING:  If you last built Loop with an Xcode version lower than 12.5, and you decide to upgrade to iOS 15.x without rebuilding, your Loop app will stop working.

To update to iOS 15.x:

Important:  Updating your iPhone is the very last step!

  • Log into your Apple developer account and make sure that there are no new agreements that need to be signed.
  • Update your Mac
    • macOS 11.6 Big Sur or macOS 12.1 Monterey.   If you cannot update to Big Sur -STOP, do not complete the remaining steps.  Your computer may be too old to update.  Check here for Big Sur compatibility.
    • Xcode 13.2  If you cannot update to Xcode 13, follow the instructions above about the detailed information needed to get assistance on FB.
  • Use the Build Select Script  Utility feature to Clean Profiles and Derived Data
  • Use the Build Select Script Build Loop feature to download fresh Loop code
  • Build Loop onto your phone
  • Verify that Loop has been updated on your phone by clicking Settings/Issue Report, and then scrolling down to see your BuildDateString.
  • If you have a build error – the first thing to do is make sure you selected Loop(Workspace) instead of the usual Loop at top left of Xcode
    • If that was correctly set, then exit out of Xcode and restart your Mac and try again
    • If you still have a build error or it does not install Loop, immediately STOP and do not upgrade your phone to iOS 15 until it is solved
    • If the error references RileyLink, you either didn’t get new code or you tried to build from the zip download. Re-read all the instructions and start again with the Build Select Script
  • FINALLY, you can update your iPhone to iOS 15.x


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 except for Loop’s ability to Read Carbohydrates (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

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 on “Automatic Downloads”
  3. 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. But please, update as soon as the all-clear is sounded.  Updates can provide very important security fixes as well as nifty new features.

More Information

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.

If you updated your iPhone to iOS 14.8 and then discovered that your Mac cannot update to Big Sur, you will have to take extra steps to rebuild – the information is on the Build-Select page. (Big Sur became a requirement for iOS 14.5).  This method does not work for iOS 15.

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.


Skip to content