Skip to content

Build

Xcode projects are usually built through Xcode's GUI or the xcodebuild command-line tool. Tuist provides a command, tuist build, to generate the project if needed, and then build it with the xcodebuild command-line tool.

Why Tuist over xcodebuild

You might wonder what's the value of using tuist build over generating the project with tuist generate and building it with raw xcodebuild.

  • Single command: tuist build ensures the project is generated if needed before compiling the project.
  • Beautified output: Tuist enriches the xcodebuild output using xcbeautify
  • Binary caching: If you are using Tuist Cloud, Tuist can reuse the binaries from the cache, speeding up the build process.

Tuist Cloud Analytics coming

Understanding the build process is crucial to optimize the build times. Unfortunately, Xcode doesn't provide a lot of insights into the build process. Therefore, we are working on a set of features that will allow you to understand the build process better. This will require the usage of tuist build, so if you are not using it yet, we recommend you start using it.

Building schemes

To build schemes of a project, you can use the tuist build command. This command will generate the project if needed, and then build it using the xcodebuild command-line tool. We support the use of the -- terminator to forward all subsequent arguments directly to xcodebuild. Arguments such as -workspaceor-project` cannot be used because tuist takes care of them.

bash
tuist build MyScheme
bash
tuist build MyScheme -- -configuration Debug
bash
tuist build --no-binary-cache

Released under the MIT License.