Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

ensure_xcode_build_version plugin

fastlane Plugin Badge

Gem Version CircleCI Code Climate Coverage Status Dependency Status Inline docs

Getting Started

This project is a fastlane plugin. To get started with fastlane-plugin-ensure_xcode_build_version, add it to your project by running:

fastlane add_plugin ensure_xcode_build_version

About ensure_xcode_build_version

Ensure the selected Xcode Build version with xcode-select matches a value.

If building your app requires a specific version of Xcode, you can invoke this command before using gym. For example, to ensure that a beta version is not accidentally selected to build, which would make uploading to TestFlight fail."

# If you want to make sure that you use Xcode 8 GM
ensure_xcode_build_version(build_version: "8A218a")
# Xcode 8.3.3
ensure_xcode_build_version(build_version: "8E3004b")
# Xcode 9 beta 4
ensure_xcode_build_version(build_version: "9M189t")


Check out the example Fastfile to see how to use this plugin. Try it by cloning the repo, running fastlane install_plugins and bundle exec fastlane test.

Run tests for this plugin

To run both the tests, and code style validation, run


To automatically fix many of the styling issues, use

rubocop -a

Issues and Feedback

For any other issues and feedback about this plugin, please submit it to this repository.


If you have trouble using plugins, check out the Plugins Troubleshooting doc in the main fastlane repo.

Using fastlane Plugins

For more information about how the fastlane plugin system works, check out the Plugins documentation.

About fastlane

fastlane is the easiest way to automate building and releasing your iOS and Android apps. To learn more, check out