tuist build

Build your Tuist project

Overview

The tuist build command provides a set of commands to build your Tuist projects. It generates the Xcode workspace if needed and builds the specified scheme or all buildable schemes.

Usage

tuist build [options] [scheme]

Options

--path · string · default: "."

The path to the directory that contains the project to be built.

-p · string

Short form of --path.

--generate · boolean · default: "false"

Force the generation of the project before building.

--clean · boolean · default: "false"

Clean the project before building it.

--configuration · string

The configuration to be used when building the scheme (e.g., Debug, Release).

-C · string

Short form of --configuration.

--device · string

Build on a specific device.

-d · string

Short form of --device.

--platform · string

Build for a specific platform (iOS, macOS, tvOS, visionOS, watchOS).

--os · string

Build with a specific version of the OS.

-o · string

Short form of --os.

--rosetta · boolean · default: "false"

Append arch=x86_64 to the destination to run the simulator in Rosetta mode.

--build-output-path · string

The directory where build products will be copied to when the project is built.

--generate-only · boolean · default: "false"

Generate the project and skip building. Useful for debugging purposes.

--no-binary-cache · boolean · default: "false"

Ignore binary cache and use sources only.

Arguments

scheme · string

The scheme to be built. By default, it builds all the buildable schemes of the project in the current directory.

-- · string[]

Arguments after -- are passed through to xcodebuild. Example: tuist build -- -destination 'platform=iOS Simulator,name=iPhone 15' -sdk iphonesimulator

Examples

Build default schemes

tuist build

Builds all buildable schemes in the current project.

Build specific scheme

tuist build MyApp

Builds the MyApp scheme.

Build with generation

tuist build --generate MyApp

Generates the workspace first, then builds the MyApp scheme.

Clean build

tuist build --clean MyApp

Cleans and builds the MyApp scheme.

Build for specific device

tuist build --device "iPhone 15 Pro" MyApp

Builds MyApp for the iPhone 15 Pro simulator.

Build with configuration

tuist build --configuration Release MyApp

Builds MyApp using the Release configuration.

Build with Rosetta

tuist build --rosetta MyApp

Builds MyApp in Rosetta mode for Intel architecture on Apple Silicon Macs.

Pass arguments to xcodebuild

tuist build MyApp -- -destination 'platform=iOS Simulator,name=iPhone 15' -sdk iphonesimulator

Builds MyApp and passes additional arguments to xcodebuild.

Subcommands

tuist build list

List previous build runs and their status.

tuist build list

tuist build show

Show details about a specific build run.

tuist build show [build-id]

Binary caching

By default, tuist build uses binary cache to speed up build times. Use --no-binary-cache to disable caching and build from sources only.

Related

• Generate command
• Test command
• Cache command