Skip to content

Translation 🌍

You can translate or improve the translation of this page.

Contribute

tuist test

Tests a project

Arguments

scheme Optional

Environment variable TUIST_TEST_SCHEME

The scheme to be tested. By default it tests all the testable targets of the project in the current directory.

bash
tuist test [scheme]

clean Optional

Environment variable TUIST_TEST_CLEAN

When passed, it cleans the project before testing it.

bash
tuist test --clean
tuist test -c
tuist test --no-clean

no-upload Optional

Environment variable TUIST_TEST_NO_UPLOAD

When passed, the result necessary for test selection is not persisted to the server.

bash
tuist test --no-upload
tuist test -n
tuist test --no-no-upload

path Optional

Environment variable TUIST_TEST_PATH

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

bash
tuist test --path [path]
tuist test -p [path]

device Optional

Environment variable TUIST_TEST_DEVICE

Test on a specific device.

bash
tuist test --device [device]
tuist test -d [device]

platform Optional

Environment variable TUIST_TEST_PLATFORM

Test on a specific platform.

bash
tuist test --platform [platform]

os Optional

Environment variable TUIST_TEST_OS

Test with a specific version of the OS.

bash
tuist test --os [os]
tuist test -o [os]

rosetta Optional

Environment variable TUIST_TEST_ROSETTA

When passed, append arch=x86_64 to the 'destination' to run simulator in a Rosetta mode.

bash
tuist test --rosetta
tuist test --no-rosetta

configuration Optional

Environment variable TUIST_TEST_CONFIGURATION

The configuration to be used when testing the scheme.

bash
tuist test --configuration [configuration]
tuist test -C [configuration]

skip-ui-tests Optional

Environment variable TUIST_TEST_SKIP_UITESTS

When passed, it skips testing UI Tests targets.

bash
tuist test --skip-ui-tests
tuist test --no-skip-ui-tests

result-bundle-path Optional

Environment variable TUIST_TEST_RESULT_BUNDLE_PATH

Path where test result bundle will be saved.

bash
tuist test --result-bundle-path [result-bundle-path]
tuist test -T [result-bundle-path]

derived-data-path Optional Deprecated

Environment variable TUIST_TEST_DERIVED_DATA_PATH

Overrides the folder that should be used for derived data when testing a project.

bash
tuist test --derived-data-path [derived-data-path]

retry-count Optional Deprecated

Environment variable TUIST_TEST_RETRY_COUNT

Tests will retry <number> of times until success. Example: if 1 is specified, the test will be retried at most once, hence it will run up to 2 times.

bash
tuist test --retry-count [retry-count]

test-plan Optional

Environment variable TUIST_TEST_TEST_PLAN

The test plan to run.

bash
tuist test --test-plan [test-plan]

test-targets Optional

Environment variable TUIST_TEST_TEST_TARGETS

The list of test identifiers you want to test. Expected format is TestTarget[/TestClass[/TestMethod]]. It is applied before --skip-testing

bash
tuist test --test-targets [test-targets]

skip-test-targets Optional

Environment variable TUIST_TEST_SKIP_TEST_TARGETS

The list of test identifiers you want to skip testing. Expected format is TestTarget[/TestClass[/TestMethod]].

bash
tuist test --skip-test-targets [skip-test-targets]

filter-configurations Optional

Environment variable TUIST_TEST_CONFIGURATIONS

The list of configurations you want to test. It is applied before --skip-configuration

bash
tuist test --filter-configurations [filter-configurations]

skip-configurations Optional

Environment variable TUIST_TEST_SKIP_CONFIGURATIONS

The list of configurations you want to skip testing.

bash
tuist test --skip-configurations [skip-configurations]

binary-cache Optional

Environment variable TUIST_TEST_BINARY_CACHE

Ignore binary cache and use sources only.

bash
tuist test --binary-cache
tuist test --no-binary-cache

selective-testing Optional

Environment variable TUIST_TEST_SELECTIVE_TESTING

When --no-selective-testing is passed, tuist runs all tests without using selective testing.

bash
tuist test --selective-testing
tuist test --no-selective-testing

generate-only Optional

Environment variable TUIST_TEST_GENERATE_ONLY

When passed, it generates the project and skips testing. This is useful for debugging purposes.

bash
tuist test --generate-only
tuist test --no-generate-only

passthrough-xcode-build-arguments Optional

xcodebuild arguments that will be passthrough

bash
tuist test [passthrough-xcode-build-arguments]

help Optional

Show help information.

bash
tuist test -h
tuist test --help

Released under the MIT License.