xcutils

A collection of utilities that aid with the use of the Xcode CLI, packaged as a single SwiftPM Package.

Usage

xcutils can be used as an executable, or you can include the provided frameworks to aid with your own workflow.

xcutils Executable

The SwiftPM Package provides a single executable, xcutils, which contains subcommands for each of the utilities provided.

All flags can be passed as either --flagName or -flagName, although short names must be in the format -f.

xcutils test

xcutils test makes running tests against simulators and the local Mac more concistent and easy:

swift run xcutils test iOS --project MyFramework.xcodeproj --scheme MyFramework

This will test the MyFramework scheme from the MyFramework.xcodeproj project using an iOS simulator with the newest version of iOS installed, prioritising simulators that are already running.

Configuration

Usage: xcutils test <platform> [options]

Argument	Required	Type	Default Value	Description
platform	Yes	iOS | macOS | tvOS	N/A	The platform to test on.
--project, -p	Yes	String	N/A	The path to the project to test.
--scheme, -s	Yes	String	N/A	The name of the scheme to test.
--version, -v	No	String	latest	See version specifiers.

xcutils select

xcutils select makes finding and changing the changing the Xcode version used by the command line easy:

swift run xcutils select latest

This will run xcode-select to select the latest version of Xcode installed in /Applications.

Configuration

Usage: xcutils select [options] <version specifier>

Argument	Required	Type	Default Value	Description
version	Yes	String	latest	See version specifiers.
--printVersions, -p	No	Bool	false	Only print found version(s), sorted in version order.
--searchPath, -P	No	URL	/Applications	The path to search for Xcode versions.

Version Specifiers

Special cases can be provided when specifying a version. These specifiers work against the locally installed versions, rather than the latest version published by Apple.

Case	Explanation
latest	The latest stable version
last-major	The last major stable version, e.g. 10.x.x if the latest version is 11.x.x
last-minor	The last minor stable version, e.g. 11.1.x if the latest version is 11.2.x
beta	The latest beta version
11.3.1	The exact version 11.3.1
11.3	The latest version 11.3 available (any patch)
11	The latest version 11 available (any minor; any patch)