How to Update Loop

When a new version of Loop is released, you can click HERE to read what features or fixes were a part of the new release.

The process to update is very similar to the original building of Loop app, except you get to skip several of the first steps. The basic steps are:

  • Update iOS, macOS, Xcode, and/or watchOS
  • Download new Loop source code
  • Add any customizations
  • Sign all four targets
  • Build app

Update Apple devices

Between Loop app builds, there's a high liklihood that Apple has updated one or more of the systems involved in your Loop app; your Apple Developer license agreement, your iPhone's iOS, your computer's macOS, your Xcode app, and/or your watchOS. If you miss some of the updates, you may run into build problems. You can check for macOS and Xcode updates using the App Store link under the apple logo in your computer display's upper left corner. Check below to make sure your equipment is running the current versions of the various OS.

Download new Loop source code

You can use these links to download new versions of the Loop source code. These links will always provide the most recent version of Loop:

Loop: Master branch source code


Loop: Dev branch source code

FYI: The Loop source code resides in GitHub within a repository. A repository is kind of like a project's bookshelf, holding various books (aka branches) of a project. The master branch is considered a stable version. Any new features or options are first tested in a dev (short for "development") branch of the Loop. New or inexperienced users should not build from the dev branch of Loop. So if you hear of "new features in dev", these are things that may be eventually merged into the master branch once any bugs are worked out.

IMPORTANT NOTES: Best practice is to leave your Loop source code in your Downloads folder. If you store your Loop code a different folder than Downloads (such as your Documents folder or Desktop), make sure the specified folder is not an iCloud drive. Storing your Loop code in an iCloud drive folder will prevent Loop from building successfully. How do you know if a folder is an iCloud drive? Check your System Preferences. If your System Preferences for iCloud is set as shown below, your Documents and Desktop folders are iCloud drives and NOT appropriate places to save your Loop download.

Depending on your browser and settings, your Loop download may or may not automatically unzip. If it does not unzip automatically, you can right-click on the zip file and choose to "Open With" Archive Utility. This will create a blue folder called Loop-master. HOWEVER, if you already have an existing Loop-master folder from a previous download, the name of the next download will be something like Loop-master (1). The problem with that folder name is that it contains a space...and spaces in the name will cause your Loop build to fail. So, either delete old copies of Loop before downloading/unzipping or rename the folder(s) to ensure that NO SPACES are in the folder name.

Add customizations

Add or redo any customizations, if needed. These will not be carried over automatically from the old app. Be sure to read up in the code customizations section before building, as there may be new customizations available since the previous build.

Sign Targets and Build

Sign the four targets and rebuild. Just make sure to pick your paid developer team, if you have one.

Build Errors

If you get any build errors, please check this section for fixes.