GitHub Build Overview
Build Loop with a Browser¶
The new GitHub build method is available with the release of Loop 3, as well as for development versions.
- Installation on your phone is via TestFlight
- This can be used by those who don't own a Mac but want to Loop
- The GitHub build method can be used even if you do use a Mac - the two methods do not interfere with each other
TestFlight is the only method available for installation to a phone when using the GitHub build method, but can also be used with the Mac/Xcode build method.
Pros and Cons¶
Advantages of GitHub Build¶
Developer quote: "This frees up the dependency of having the most recent Xcode to build to a [phone with a] new version of iOS. Xcode only needs to support the iOS version on your phone when you are building directly to the phone."
- Mac computer is not required
- Most recent version of Xcode is not required
- No more updating macOS then updating Xcode
- The time required for the initial setup for GitHub may take less time than one macOS/Xcode version update
- Updates take a few minutes of your time to start and are ready to install on your phone in less than an hour
Cons¶
- There are no instructions for applying customizations
- Stick with Mac / Xcode build (for now) if you want to customize
- Hint - when customization instructions are provided - you will be making more forks for every submodule you customize and you will be responsible for keeping those forks up to date
Requirements¶
Loop 3 requires iOS 15.1 or higher
The requirements for building and using the Loop app with the GitHub Build Actions method are given below.
- Compatible iPhone/iPod Touch
- Compatible Pump
- Compatible CGM
- RileyLink Compatible Device (not needed for Omnipod DASH)
- Free GitHub account (instructions included in First-Time with GitHub Actions)
- Apple Developer Membership
- Must be a paid developer account
- If building for a family member, review this section:
- If building for a child (age depends on the country), review this section:
First-Time GitHub Builder¶
There are a number of steps that must be completed the first time you use this method.
Deploy and Updates¶
- Instructions to deploy and make updates are found at:
- And of course, an errors page is under construction:
What if I get stuck?¶
Try to:
- Scroll back in the directions and see if you missed a paragraph or step.
- Compare your screen's display with the graphics in LoopDocs. Is something different or does yours have an error message? If you have an error message, does it guide you to the problem and solution?
- If you are still stumped - reach out for help: How to Find Help.