The Loop app can be built using GitHub workflows in the cloud from a browser on any computer or using a Mac with Xcode.
- Non-developers may prefer the GitHub workflow method, which does not require a mac.
- Developers or Loopers who want full build control may prefer the local Mac/Xcode method.
The GitHub Build Instructions are at this link and further expanded in LoopDocs: Browser Build.
The rest of this README contains information needed for Mac/Xcode build. Additonal instructions are found in LoopDocs: Mac/Xcode Build.
This repository uses git submodules to pull in the various workspace dependencies.
To clone this repo:
git clone --branch=<branch> --recurse-submodules https://github.com/LoopKit/LoopWorkspace
Replace <branch> with the initial LoopWorkspace repository branch you wish to checkout.
Change to the cloned directory and open the workspace in Xcode:
cd LoopWorkspace
xed .
You should be able to build to a simulator without changing anything. But if you wish to build to a real device, you'll need a developer account, and you'll need to tell Xcode about your team id, which you can find at https://developer.apple.com/.
Select the LoopConfigOverride file in Xcode's project navigator, uncomment the LOOP_DEVELOPMENT_TEAM, and replace the existing team id with your own id.
Select the "LoopWorkspace" scheme (not the "Loop" scheme) and Build, Run, or Test.