The easiest way to install and switch between multiple versions of Xcode.
This repository is a maintained fork of XcodesOrg/XcodesApp. Fork history includes upstream release v4.0.5b40. It keeps the visible Xcodes.app name and workflow as a drop-in replacement while using fork-owned bundle, helper, update, signing, and release identities.
If you need a command-line tool, see the upstream xcodes project.
- Lists available Xcode versions from Xcode Releases or Apple Developer.
- Downloads and installs Xcode, with resumable multi-connection downloads through
aria2. - Selects the active version using
xcode-select. - Shows release notes, OS compatibility, SDKs, and compilers.
- Installs supported simulator platforms and runtimes.
- Supports Apple silicon and universal Xcode variants.
- Supports Apple ID and security-key authentication where Apple requires sign-in.
- Supports stable and prerelease update channels through Sparkle.
The optional unxip experiment builds on saagarjha/unxip. It can reduce extraction time, at the cost of higher memory use on some systems.
Fork releases use the same Xcodes.app application name as upstream. The fork has a distinct bundle ID and helper identity, so macOS can distinguish its settings and privileged helper.
- Download
Xcodes.zipfrom the latest fork release. - Expand the archive.
- Move
Xcodes.appto/Applications.
The release process distributes fork assets only after Developer ID signing and notarization. GitHub Releases is the supported binary distribution path. This fork does not publish a Homebrew cask.
On first launch, non-secret preferences can migrate from upstream Xcodes. Apple credentials, cookies, Keychain items, and the privileged helper do not migrate. Sign in again. When Xcodes prompts you, approve helper installation.
Clone the maintained fork:
git clone https://github.com/jacobcxdev/XcodesApp.git
cd XcodesApp
open Xcodes.xcodeprojUse the Xcode version configured by CI (DEVELOPER_DIR in .github/workflows/ci.yml) or a newer compatible release. Xcode resolves Swift package dependencies when the project opens. To build without signing from the command line:
xcodebuild build \
-project Xcodes.xcodeproj \
-scheme Xcodes \
-configuration Debug \
CODE_SIGNING_ALLOWED=NORun the test suite with:
xcodebuild test -project Xcodes.xcodeproj -scheme Xcodes -configuration Test CODE_SIGNING_ALLOWED=NOThe repository release workflow automates packaging and notarization. Release documentation defines protected-environment setup, secret formats, local verification, immutable tag format, and recovery procedures.
Report fork bugs and request features in fork issues. See CONTRIBUTING.md before opening a pull request.
Normal fork development and portable upstream contributions use separate branch lanes. FORKING.md documents exact remote and branch commands.
The upstream README named these localisation contributors. This fork preserves their credits.
| Language | Contributor |
|---|---|
| French | @dompepin |
| Italian | @gualtierofrigerio |
| Spanish | @cesartru88 |
| Korean | @ryan-son |
| Russian | @alexmazlov |
| Turkish | @egesucu |
| Hindi | @KGurpreet |
| Simplified Chinese | @megabitsenmzq |
| Finnish | @marcusziade |
| Traditional Chinese | @itszero |
| Ukrainian | @gelosi |
| Japanese | @tatsuz0u |
| German | @drct |
| Dutch | @jfversluis |
| Brazilian Portuguese | @brunomunizaf |
| Polish | @jakex7 |
| Catalan | @ferranabello |
| Greek | @alladinian |
| Thai | @neetrath |
Robots and Pencils, XcodesOrg, Matt Kiazyk, and many community contributors and translators created and maintained Xcodes. Repository history, licence notices, and the app's acknowledgements retain their credits. JacobCXDev maintains this fork independently.
xcode-install, fastlane/spaceship, and the project's open-source dependencies deserve credit for the foundations Xcodes builds on.
Xcodes is available under the MIT Licence. Original copyright notices are preserved alongside the fork copyright.