Xcode 26.3 download stuck indefinitely at "Step 2 of 7: Downloading"
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 48/100
Research direction
Start with the Xcodes installation flow at “Step 2 of 7: Downloading” and reproduce the stalled Xcode 26.3 download on macOS. Check how the UI receives download state and handles Apple CDN failures, then verify that size, progress, connection or retry status, and a useful failure state are shown when the download stalls.
Written by the indexing model from the issue text.
Description
Describe the bug
I am trying to install Xcode 26.3 (17C529) using Xcodes.
After signing in with my Apple ID successfully, the installation starts, but it remains indefinitely at:
Step 2 of 7: Downloading
The progress bar does not show an actual percentage or downloaded size. It only displays an indeterminate blue animation moving back and forth.
I have waited for a long time, but there is no indication of whether the download is actually progressing, stalled, retrying, or waiting for Apple's CDN.
This makes it very difficult to determine whether Xcodes is working normally or whether the download has completely stalled.
It would be extremely helpful if Xcodes could show:
- Downloaded size / total size
- Current download speed
- Percentage completed
- Current Apple CDN/download URL or connection status
- Retry / timeout status
- A useful error message if no data has been received for an extended period
At the moment, the UI simply stays on "Downloading" indefinitely.
To Reproduce
Steps to reproduce the behavior:
- Open Xcodes.
- Sign in with an Apple ID.
- Expand Xcode 26.
- Select Xcode 26.3 (17C529).
- Click Install.
- Wait until the process reaches
Step 2 of 7: Downloading. - The progress indicator remains indeterminate for a very long time with no useful download information.
Expected behavior
Xcodes should display real download progress, including at least the number of bytes downloaded and the total file size.
If the Apple download server is not responding, the connection has stalled, authentication has expired, or the CDN is unavailable, Xcodes should report that condition instead of showing an endless "Downloading" animation.
Ideally, there should also be a timeout/retry mechanism with visible status information.
Additional context
I am specifically trying to install Xcode 26.3 because Homebrew reports that my current Command Line Tools are outdated and recommends:
Command Line Tools for Xcode 26.3
Unfortunately, Apple's own Developer Downloads website has repeatedly been returning:
503 Service Temporarily Unavailable
so downloading the standalone CLT package directly from Apple is currently not a reliable fallback.
This makes tools such as Xcodes particularly important. When both Apple's Developer Downloads website is unavailable and Xcodes provides no meaningful progress/error information during a large Xcode download, troubleshooting becomes unnecessarily difficult.
I understand that Apple's server/CDN availability is outside the control of the Xcodes project. However, Xcodes could make this situation much easier to diagnose by exposing real download progress and network/error state instead of an indefinitely animated progress bar.
Screenshots
The Xcodes UI remains at:
Xcode 26.3 (17C529)
Step 2 of 7: Downloading
with an indeterminate progress indicator.
Things get worse when switching to other account, which directly deny any downloading process.
Version
- OS: macOS Sequoia 15.7.9 (24G830)
- Architecture: Apple Silicon (M1)
- Xcodes: 4.0.5 (40)
- Xcode being installed: 26.3 (17C529)
- Current Command Line Tools: 16.4
- Dominant language
- Swift
- Stars
- 8.6k
- Forks
- 387
- Avg merge
- 6d 7h
- Merged PRs (30d)
- 3
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from XcodesOrg/XcodesApp
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
bug
Difficulty 4/5 3-5 days Newbie friendliness 45/100
-
bug
Difficulty 4/5 3-5 days Newbie friendliness 35/100
-
bug
Difficulty 4/5 3-5 days Newbie friendliness 15/100
All issues in XcodesOrg/XcodesApp
Similar issues
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
type: docs
Difficulty 1/5 Under an hour Newbie friendliness 95/100
googleapis/google-cloud-swift#971 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
bitcoindevkit/bdk-ffi#1125 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
mozilla-mobile/firefox-ios#35743 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
manaflow-ai/cmux#13417 ·