开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

Xcode::Install

Install and update your Xcodes automatically.

$ gem install xcode-install
$ xcversion install 6.3

This tool uses the Downloads for Apple Developer page.

Installation

$ gem install xcode-install

Note: unfortunately, XcodeInstall has a transitive dependency on a gem with native extensions and this is not really fixable at this point in time. If you are installing this on a machine without a working compiler, please use these alternative instructions instead:

$ curl -sL -O https://github.com/neonichu/ruby-domain_name/releases/download/v0.5.99999999/domain_name-0.5.99999999.gem
$ gem install domain_name-0.5.99999999.gem
$ gem install --conservative xcode-install
$ rm -f domain_name-0.5.99999999.gem

Usage

XcodeInstall needs environment variables with your credentials to access the Apple Developer Center, they are stored using the credentials_manager of fastlane:

XCODE_INSTALL_USER
XCODE_INSTALL_PASSWORD

List

To list available versions:

$ xcversion list
6.0.1
6.1
6.1.1
6.2 (installed)
6.3

Already installed versions are marked with (installed). (Use $ xcversion installed to only list installed Xcodes with their path).

To update the list of available versions, run:

$ xcversion update

Install

To install a certain version, simply:

$ xcversion install 8
###########################################################               82.1%
######################################################################## 100.0%
Please authenticate for Xcode installation...

Xcode 8
Build version 6D570

This will download and install that version of Xcode. Then you can start it from /Applications as usual. The new version will also be automatically selected for CLI commands (see below).

GMs and beta versions

Note: GMs and beta versions usually have special names, e.g.

$ xcversion list
7 GM seed
7.1 beta

They have to be installed using the full name, e.g. xcversion install '7 GM seed'.

.xcode-version

We recommend the creation of a .xcode-version file to explicitly declare and store the Xcode version to be used by your CI environment as well as your team.

12.5

Read the proposal of .xcode-version.

Select

To see the currently selected version, run

$ xcversion selected

To select a version as active, run

$ xcversion select 8

To select a version as active and change the symlink at /Applications/Xcode, run

$ xcversion select 8 --symlink

Command Line Tools

XcodeInstall can also install Xcode's Command Line Tools by calling xcversion install-cli-tools.

Simulators

XcodeInstall can also manage your local simulators using the simulators command.

$ xcversion simulators
Xcode 6.4 (/Applications/Xcode-6.4.app)
iOS 7.1 Simulator (installed)
iOS 8.1 Simulator (not installed)
iOS 8.2 Simulator (not installed)
iOS 8.3 Simulator (installed)
Xcode 7.2.1 (/Applications/Xcode-7.2.1.app)
iOS 8.1 Simulator (not installed)
iOS 8.2 Simulator (not installed)
iOS 8.3 Simulator (installed)
iOS 8.4 Simulator (not installed)
iOS 9.0 Simulator (not installed)
iOS 9.1 Simulator (not installed)
tvOS 9.0 Simulator (not installed)
watchOS 2.0 Simulator (installed)

To install a simulator, use --install and the beginning of a simulator name:

$ xcversion simulators --install='iOS 8.4'
###########################################################               82.1%
######################################################################## 100.0%
Please authenticate to install iOS 8.4 Simulator...

Successfully installed iOS 8.4 Simulator

Limitations

Unfortunately, the installation size of Xcodes downloaded will be bigger than when downloading via the Mac App Store, see #10 and feel free to dupe the radar.