Two Loop Build Methods¶
With the release of Loop 3, there are two Build Methods. If you have never built Loop before, you will probably find the GitHub process (also know as Browser Build) easiest. If you are a long time Looper, either method is fine. You only need to follow one of the Build methods, but you can use both methods if you want.
The Build Steps have been split into two tabs:
- Browser Build
- Build Loop using GitHub Actions (no computer required)
- Mac-Xcode Build
- Traditional, build Loop on a Mac with Xcode
There are some common requirements and then some different requirements for the two methods.
These requirements are independent of how you build the Loop app:
- Compatible iPhone/iPod Touch
- Compatible Pump
- Compatible CGM
- RileyLink Compatible Device (not needed for Omnipod DASH)
- Apple Developer Membership
- For Browser Build - must be a paid developer account
- If building for a child, be sure to read Loopers Need Their Own Apple ID
Added Requirements for Browser Build¶
In addition to the paid Apple Developer account, you also need a free GitHub account. The instructions for the GitHub account are included in the Browser Build instructions.
Added Requirements for Mac-Xcode Build¶
If you plan to build using the Mac-Xcode Build instructions, you also need:
- Compatible Computer
- Xcode (a free Apple application)
Getting Ready to Build¶
Go through the Common Requirements to see what you need to actually Loop.
If you want to test the Loop app without attaching CGM or pump hardware, you can run a simulated CGM or simulated pump. You can use actual CGM data using Dexcom Share or Nightscout as a Remote CGM.
These simulators are part of the Loop app and are available with either build method you choose.
Check out the Simulator page.
Once you have chosen your Build Method, go through the pages for that build method several times before beginning, especially if this is new to you.
When you are ready to proceed, work through the tasks on each page. Take your time. You can do one a day, take a week per page or blaze through them quickly. Just be sure to read carefully and if you are confused - reach out for help: How to Find Help.
After you build Loop on your phone, keep following along in the docs as you Set up and Operate your Loop app.
Review the Common Requirements¶
Before you start either build method, review the Common Requirements. First one is Compatible iPhone/iPod Touch. On each page, keep clicking Next (or n) until you've finished with the Intro pages and are ready to Build.
Click here if you want to build with GitHub Build Actions: Browser Build
Click here if you want to build on a Mac using Xcode: Mac-Xcode Build