Why this happens
Xcode installations from the Mac App Store often appear to freeze at 75–80% because the final stages — expanding packages, verifying signatures, and writing thousands of small files — are I/O intensive and can take hours on slower disks or congested networks. The App Store progress bar does not update granularly during this phase, so it looks stuck even when work continues in the background. Network throttling, App Store server load, and Spotlight indexing of the new bundle can all extend the apparent hang.
How to fix it
1. Verify real progress in Console (most reliable check)
The accepted community workaround is to watch the App Store daemon’s own logs. This tells you whether the install is actually advancing.
- Keep the App Store window open (closing it may pause the download).
- Open Console.app (press ⌘Space, type “Console”).
- In the search field (top-right), type
App Storeand press Return. - Click Start (or the play button) to begin streaming logs.
- Look for lines containing
Completed: <number> of <total>— e.g.Completed: 825 of 1000. - If the counter increments every few minutes, the install is alive; wait it out. If it does not move for 30+ minutes, proceed to the next fix.
Tip: You can also filter by process
storedorinstalldfor lower-level package activity.
2. Install via .dmg from Apple Developer (bypasses App Store)
Downloading the full installer image avoids the App Store’s incremental unpacking and is often faster.
- Sign in to developer.apple.com/download/all/ with your Apple ID.
- Search for the exact Xcode version you need (e.g., “Xcode 12.5”).
- Download the
.xipor.dmgfile (≈8–12 GB). Use a stable wired connection if possible. - When the download finishes, double-click the archive to expand it — this may take 20–40 minutes.
- Drag the resulting Xcode.app into
/Applications(or another location). - Launch Xcode once to accept the license and install additional components.
# Optional: verify the download signature before expanding
spctl -a -v /path/to/Xcode_12.5.xip
3. Clear App Store caches and restart the download
If you prefer to stay on the App Store path, a clean slate sometimes helps.
- Quit App Store completely (⌘Q).
- In Terminal, remove the download cache:
bash
rm -rf ~/Library/Caches/com.apple.appstore
rm -rf ~/Library/Containers/com.apple.appstore/Data/Library/Caches/* - Restart the Mac.
- Reopen App Store and resume the Xcode update.
4. Free disk space and disable Spotlight indexing temporarily
Low free space (<30 GB) or active Spotlight indexing can stall the final copy phase.
- Ensure at least 40 GB free on the startup volume.
- Temporarily exclude
/Applications/Xcode.appfrom Spotlight: System Settings → Siri & Spotlight → Spotlight Privacy → + and add the Xcode bundle (or the whole Applications folder). Re-enable after install.
How to prevent it
- Prefer .xip/.dmg installs for major Xcode versions; they are more predictable.
- Keep 50 GB+ free on the startup disk before starting an Xcode update.
- Use a wired Ethernet connection or 5 GHz Wi-Fi for large downloads.
- Avoid running other heavy I/O tasks (Time Machine backup, large compiles) during install.
- Check Apple’s system status page for App Store outages before beginning.
FAQ
Why does Console show “Completed: 825 of 1000” but the App Store bar doesn’t move?
The App Store progress bar aggregates many sub-tasks into coarse percentages. Each “Completed” line in Console represents one of thousands of internal file operations; the bar only refreshes when a milestone percentage is crossed.
Can I install multiple Xcode versions side by side?
Yes. Rename the existing /Applications/Xcode.app to /Applications/Xcode_12.4.app before moving the new version into place. Use xcode-select -s to switch the active command-line tools.
What if the .xip expansion fails with “Operation not permitted”?
Gatekeeper may be blocking the unsigned expanded app. Run xattr -d com.apple.quarantine /path/to/Xcode.app after expansion, or re-download the .xip to ensure a clean signature.
Parts of this guide are adapted from content licensed under CC BY-SA 4.0; this article is shared under the same license.
