# CROSSCOMPILING_EMULATOR

Added in version 3.3.

Use the given emulator to run executables created when crosscompiling. This command will be added as a prefix to `add_test()`, `add_custom_command()`, and `add_custom_target()` commands for built target system executables.

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

Added in version 3.29: Contents of `CROSSCOMPILING_EMULATOR` may use `generator expressions`.

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

This property is not supported when using the old form of `add_test()` (i.e. without the `NAME` and `COMMAND` keywords).