Ansible Role: Xcode

This role installs Xcode on MacOS based on the provided settings.

Requirements

This role can install Xcode version 8 and newer.

To install Xcode, you need to have an Xcode xip file already downloaded on the machine where you're working. You can find all available Xcode versions on the Apple Downloads Page.

You also need a user session open. This means the user running this role needs to be logged into the MacOS machine.

The role requires Spotlight to be turned on. It checks if Xcode is installed by searching with Spotlight.

Role Variables

Here are the variables you can use and their default values. You can find all default variables in defaults/main.yml

• xcode_xip_location:
  The location of the Xcode xip file on your machine.

• xcode_major_version:
  The major version of Xcode you want to install. It is important to know the major version because extra packages are installed differently depending on the version.

• xcode_build:
  /Applications/Xcode.app/Contents/Developer/usr/bin/xcodebuild
  The path to the xcodebuild tool.

• xcode_packages_location:
  /Applications/Xcode.app/Contents/Resources/Packages
  The folder where all additional Xcode packages to be installed are located.

• xcode_xip_extraction_timeout:
  The time limit for extracting the installation archive, in seconds.

Dependencies

There are no dependencies.

Example Playbook

Here’s an example of how to use the role:

- hosts: localhost
  vars:
    xcode_xip_location: '/Users/user/Downloads/Xcode_10.1.xip'
    xcode_major_version: 10
  roles:
    - xcode

License

This project is licensed under GPL-3.0.

Author Information

This role was created in 2019 by MacStadium, Inc.

Maintainer(s)

• Ivan Spasov