| CMP0158 |
| ------- |
| |
| .. versionadded:: 3.29 |
| |
| :command:`add_test` honors :variable:`CMAKE_CROSSCOMPILING_EMULATOR` only |
| when :variable:`cross-compiling <CMAKE_CROSSCOMPILING>`. |
| |
| In CMake 3.28 and below, :command:`add_test` unconditionally used the |
| :prop_tgt:`CROSSCOMPILING_EMULATOR` target property (initialized by the |
| :variable:`CMAKE_CROSSCOMPILING_EMULATOR` variable) to run test commands |
| naming executable targets. CMake 3.29 and above prefer to use the emulator |
| only when the :variable:`CMAKE_CROSSCOMPILING` variable is enabled. The |
| :variable:`CMAKE_TEST_LAUNCHER` variable may be used instead when not |
| cross-compiling. This policy provides compatibility for projects that |
| have not been updated. |
| |
| The ``OLD`` behavior for this policy is for :command:`add_test` to use |
| the :prop_tgt:`CROSSCOMPILING_EMULATOR` target property unconditionally. |
| The ``NEW`` behavior for this policy is for :command:`add_test` to use |
| the :prop_tgt:`CROSSCOMPILING_EMULATOR` target property only when |
| :variable:`cross-compiling <CMAKE_CROSSCOMPILING>`. |
| |
| .. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.29 |
| .. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn |
| .. include:: STANDARD_ADVICE.txt |
| |
| .. include:: DEPRECATED.txt |