Skip to main content

Xcode Select (Version)

This step is used to specify the Xcode version to be used during the build process. All available versions of Xcode can be seen in the Configuration tab.



Always use this step before CocoaPods Install and Xcodebuild for Devices. If you have other Xcode related steps, such as Xcodebuild for iOS Simulators and Xcodebuild for Unit and UI Tests, don't forget to use before them.


Please don't forget to select the Xcode version from Configuration first.

Version Change

  • To select an Xcode version, open Configuration in the build profile.
  • After opening the configuration, you will see the Xcode Version section. Now you can select a version for Xcode.

Appcircle provides new versions of Xcode (including beta versions) within 24 hours after they are released.


Pool-Based Xcode Version Selection

A version other than the Xcode versions on the configuration page should not be entered manually as the Xcode select workflow argument. Because the Xcode versions on the configuration page are the versions installed on runners. Entering an unavailable Xcode version may cause the build to fail. You can review the documentation for detailed information about the Xcode version selection here.

Input Variables

You can find all the parameters required for this step in the table below, with their descriptions in detail.

Variable NameDescriptionStatus
$AC_XCODE_LIST_DIRSpecifies the directory with the Xcode versions. Xcode versions are located under the /Volumes directory and selected according to the given version.Required
$AC_XCODE_VERSIONSpecifies the xcode version. This variable comes from Configuration.Required

To access the source code of this component, please use the following link:

Preview of GitHub - appcircleio/appcircle-xcode-select-component