xcodes

https://github.com/xcodesorg/xcodes
Admin
xcodes is a command-line tool to install and switch between multiple versions of Xcode.
Tokens:9,367
Snippets:88
Trust Score:9
License:MIT
Update:4 weeks ago
Show doc for...
Tokens:
Raw
### Installation Output Example

Source: https://github.com/xcodesorg/xcodes/blob/main/README.md

Shows the expected output during a successful installation, including progress steps and the final installation path. Requires superuser privileges to finish.

```sh
(1/6) Downloading Xcode 11.2.0: 100%
(2/6) Unarchiving Xcode (This can take a while)
(3/6) Moving Xcode to /Applications/Xcode-11.2.0.app
(4/6) Moving Xcode archive Xcode-11.2.0.xip to the Trash
(5/6) Checking security assessment and code signing
(6/6) Finishing installation
xcodes requires superuser privileges in order to finish installation.
macOS User Password:

Xcode 11.2.0 has been installed to /Applications/Xcode-11.2.0.app
```

--------------------------------

### Install xcodes via Mint

Source: https://github.com/xcodesorg/xcodes/blob/main/README.md

Install xcodes using Mint, a package manager for Swift command-line tools.

```sh
mint install XcodesOrg/xcodes
```

--------------------------------

### Install Xcode with xcodes

Source: https://github.com/xcodesorg/xcodes/blob/main/README.md

Install a specific version of Xcode using various options such as version, path, latest-prerelease, directory, and experimental-unxip. Prompts for Apple ID credentials, which can be provided via environment variables.

```sh
xcodes install 10.2.1
xcodes install 11 Beta 7
xcodes install 11.2 GM seed
xcodes install 9.0 --path ~/Archive/Xcode_9.xip
xcodes install --latest-prerelease
xcodes install --latest --directory "/Volumes/Bag Of Holding/"
xcodes install --latest --experimental-unxip
```

--------------------------------

### Build and run with Swift command line tools

Source: https://github.com/xcodesorg/xcodes/blob/main/README.md

Use these commands to build, run, and test xcodes using the Swift command line tools. Requires Xcode to be installed.

```sh
swift build
```

```sh
swift run
```

```sh
swift run xcodes list
```

```sh
swift test
```

--------------------------------

### Install xcodes via Homebrew

Source: https://github.com/xcodesorg/xcodes/blob/main/README.md

Install xcodes using Homebrew. This is the preferred method and provides Developer ID-signed and notarized release builds that don't require Xcode to be installed.

```sh
brew install xcodesorg/made/xcodes
```

--------------------------------

### Install a Specific Runtime

Source: https://github.com/xcodesorg/xcodes/blob/main/README.md

Install a specific runtime version, such as iOS 17.0-beta1.

```sh
xcodes runtimes install "iOS 17.0-beta1"
```

--------------------------------

### Build xcodes from source

Source: https://github.com/xcodesorg/xcodes/blob/main/README.md

Build xcodes from source. Requires Xcode 12.0 or later. The optional PREFIX variable allows installation to a custom directory if /usr/local/ is not in PATH.

```sh
git clone https://github.com/XcodesOrg/xcodes
cd xcodes
make install
# or, if /usr/local/ isn't in your PATH
PREFIX=/your/install/directory make install
```

--------------------------------

### Generate Zsh Completion Script

Source: https://github.com/xcodesorg/xcodes/blob/main/README.md

Commands to generate and install the completion script for zsh with oh-my-zsh. Run these commands to enable tab completion for xcodes.

```sh
mkdir ~/.oh-my-zsh/completions
xcodes --generate-completion-script > ~/.oh-my-zsh/completions/_xcodes
```

--------------------------------

### Build from source - error output

Source: https://github.com/xcodesorg/xcodes/blob/main/README.md

Example output when building from source fails because no Xcode version is selected. The error indicates that xcrun cannot find xctest. Select a version of Xcode using xcode-select or the Command Line Tools preferences.

```sh
swift build
error: terminated(72): xcrun --sdk macosx --find xctest output:
```

--------------------------------

### List Available Runtimes

Source: https://github.com/xcodesorg/xcodes/blob/main/README.md

Display the available runtimes, including betas when the --include-betas flag is used.

```sh
xcodes runtimes --include-betas
```

--------------------------------

### Sample .xcode-version file for pre-release 14.0b6

Source: https://github.com/xcodesorg/xcodes/blob/main/XCODE_VERSION.md

Defines a pre-release Xcode version 14.0b6. Pre-releases might be taken down from Apple's servers, so use with caution.

```txt
14.0b6
```

--------------------------------

### Sample .xcode-version file for official release 13.0

Source: https://github.com/xcodesorg/xcodes/blob/main/XCODE_VERSION.md

Defines an official Xcode release version 13.0. The file content is a simple string, optionally ending with a newline.

```txt
13.0
```

--------------------------------

### Sample .xcode-version file for official release 13.4.1

Source: https://github.com/xcodesorg/xcodes/blob/main/XCODE_VERSION.md

Defines an official Xcode release version 13.4.1. The file content is a simple string, optionally ending with a newline.

```txt
13.4.1
```

--------------------------------

### Sample .xcode-version file for pre-release 12.1 GM

Source: https://github.com/xcodesorg/xcodes/blob/main/XCODE_VERSION.md

Defines a pre-release Xcode version 12.1 GM. Note that GM release identifiers are not supported.

```txt
12.1 GM
```

--------------------------------

### Release a new version of xcodes

Source: https://github.com/xcodesorg/xcodes/blob/main/README.md

Commands to bump the version, tag it, and run the release automation. Includes manual steps for building, signing, notarizing, and publishing the release.

```sh
# Bump the version number in Version.swift, commit the change, and tag it
vim Sources/XcodesKit/Version.swift
git add Sources/XcodesKit/Version.swift
git commit -m "Bump version to $VERSION"
git tag -asm "$VERSION" "$VERSION"

# Run the release automation
./release.sh --version "$VERSION" --team-id "ABC123"

# Or run the release steps manually:
# Clean first
make clean

# Make a release build of xcodes, sign it, and zip it
make zip
# Create a Homebrew bottle
make bottle VERSION="$VERSION"

# Duplicate the Homebrew bottle for all expected platform filenames
cp "xcodes-$VERSION.mojave.bottle.tar.gz" "xcodes-$VERSION.arm64_mojave.bottle.tar.gz"
cp "xcodes-$VERSION.mojave.bottle.tar.gz" "xcodes-$VERSION.macos.i386.bottle.tar.gz"
cp "xcodes-$VERSION.mojave.bottle.tar.gz" "xcodes-$VERSION.macos.arm64.bottle.tar.gz"

# Notarize the release build
# This can take a while
make notarize \
    TEAMID="ABC123"

# Push the new version bump commit and tag when ready
git push --follow-tags

# Edit the draft release created by Release Drafter to point at the new tag
# Set the release title to the new version
# Add the xcodes.zip and xcodes-$VERSION.*.bottle.tar.gz files to the release
# Publish the release

# Update the Homebrew Bottle: https://github.com/XcodesOrg/homebrew-made/blob/master/Formula/xcodes.rb
```

--------------------------------

### Filter Xcode List by Architecture

Source: https://github.com/xcodesorg/xcodes/blob/main/README.md

Filter the list of Xcode versions or runtimes by architecture using the --architecture option. Supports arm64, x86_64, appleSilicon, and universal filters, and can be used multiple times.

```sh
xcodes list --architecture arm64
xcodes list --architecture universal
xcodes runtimes --architecture arm64 --architecture universal --include-betas
```
Tokens:
Raw