Xcode Version
Install Required Xcode Version¶
Time Estimate
- 45 minutes to 2 hours, depending on internet connection...but you don't need to babysit the download.
- 0 minutes if you decide to use the Build with Browser method to build Loop
Summary
- Check iPhone iOS version
- The iOS version determines minimum Xcode version
- The minimum Xcode version determines minimum macOS version
- If necessary, update macOS first and then return to this step
- Download (or update) Xcode from your computer's App Store application
FAQs
- "Why isn't my Xcode installing?"
The two most common reasons are:- Lack of internet connection, or
- Not enough space on your hard drive
- Xcode is a large download, and needs at least 50GB of space to properly unpack and install itself
- If you do not have enough space on your hard drive, you will have installation failures
- Check the Space Available
- Although the download takes a long time, the good news is you can walk away once the download starts. If your laptop goes to sleep when you close the lid or when the screen saver starts, disable the screen saver and leave the laptop open.
- After Xcode has finished downloading (looks like the progress bar is almost completed), it takes a long time to unpack and install, be patient
- "Can I install Xcode on an external drive?" Unfortunately, no. Xcode needs to be on the Mac hard drive. But other things--like photos and documents--can be moved to an external drive to make room for macOS and Xcode updates.
What is Xcode?¶
Xcode is a free application for Apple computers. You will use Xcode to turn the "raw" Loop source code into an iOS application and install it onto your iPhone. Which version of Xcode you install on your computer depends on the iOS version you have on the iPhone you are going to be installing Loop on and the macOS version you have on your computer.
Because of the complexity of these dependencies, please read this entire page.
Or - look into Build with Browser - no Mac computer required, no need to worry about versions for Mac OS or Xcode - all done for you on GitHub (some configuration required).
Which version of Xcode do I need?¶
First, choose a version of Xcode appropriate for your iOS device. Then, determine the minimum macOS version required for that Xcode version. Update to at least that minimum macOS version. Then follow the instructions to download and install Xcode (or update an existing installation):
- Open the App Store on your computer and search for "Xcode"
- If the version number you need is bigger than what is shown in the App Store, you need to first update your macOS
- Do not rely on the version number in this graphic
Version Relationship Overview¶
Have you turned off automatic updates on your iOS device?
Loop and iOS Updates
Please Read: Turn Off Automatic Updates
Before manually accepting an iOS update, be sure you have compatible versions of Xcode and MacOS.
Minimum Xcode Version
The minimum version of Xcode you need depends on the iOS version you have on your phone.
Please Read: Minimum Version List
Can't find the required Xcode version
- If your computer is not running the required minimum macOS, the App Store won't show the required minimum Xcode version
- You must use iOS to determine which Xcode, which determines which macOS
- Update your computer to at least that minimum macOS first
Don't be the person who posts for help saying, "I'm trying to update my Loop app but am getting errors." When asked what Xcode version they have and if they've updated, they respond, "I don't have any Xcode updates available in the App Store, so I must be running the most current version."
Actually, they forgot to check for macOS updates and therefore cannot see the needed Xcode update yet.
After Update - Reboot¶
After any update of macOS or Xcode, it is always a good idea to reboot your computer.
How do all the minimum versions relate to each other?¶
This section is no longer updated.
We used to keep track of the minimum Xcode and macOS that enabled users to keep building with their (often older) Mac computer.
With the advent of browser build, this is no longer worth maintaining. If you don't or can't keep your Mac up to date, please use Build with Browser.
Compatible Versions¶
- Before the release of iOS 26, the version of iOS was 18.6.2 and could be built with Xcode 16.4 and macOS 15.6.1
- To build on an iOS 26 device, you must use Xcode 26 with macOS 15.6 or newer
- As an alternative, use Build with Browser, which supports iOS 15, 16, 17 and 18.
Wikipedia Chart for Apple Versions¶
This graphic (copied from Wikipedia and last updated March 2023) is provided as a map to read the minimum requirements.
Follow this link to Wikipedia and scroll down to the current version of this figure - the graphic shown below is a map of how to read the current version of this figure at Wikipedia.
What happens if you try using too old of Xcode?¶
It isn't some catastrophic failure if you try to build with an outdated Xcode without realizing it. If the build fails, nothing happens to your phone (or Loop on your phone if you are rebuilding). Nothing is copied from the computer to the phone until after you see the Build Succeeded message. You'll see a pretty obvious error message during your Loop build. Check Oh dear! Build errors?.
Some error messages that have shown up in earlier updates:
Package.resolved file corrupted or malformed
This is for trying to select an iOS 17 phone when building with Xcode 14:
Could not locate device support files
This is for building code with Xcode 14 instead of Xcode 15:
Loop Widget errors like:
Command SwiftCompile failed with a nonzero exit code
Cannot infer contextual base in reference to member 'widget'
Next Step: Xcode Settings¶
Now you are ready to set up Xcode Settings.