TEST_LAUNCHER — CMake 4.0.2 Documentation (original) (raw)

Added in version 3.29.

Use the given launcher to run executables. This command will be added as a prefix to add_test() commands for build target system executables and is meant to be run on the host machine.

It effectively acts as a run script for tests in a similar way to how CMAKE__COMPILER_LAUNCHER works for compilation.

If this property contains a semicolon-separated list, then the first value is the command and remaining values are its arguments.

Contents of TEST_LAUNCHER may usegenerator expressions.

This property is initialized by the value of theCMAKE_TEST_LAUNCHER variable if it is set when a target is created.