CMP0158

在 3.29 版本中新增。

add_test() 僅在 cross-compiling 時才會使用 CMAKE_CROSSCOMPILING_EMULATOR。

在 CMake 3.28 及更早版本中，add_test() 會無條件使用 CROSSCOMPILING_EMULATOR 目標屬性（由 CMAKE_CROSSCOMPILING_EMULATOR 變數初始化）來執行命名可執行目標的測試命令。CMake 3.29 及以上版本傾向於僅在啟用 CMAKE_CROSSCOMPILING 變數時才使用模擬器。當不進行交叉編譯時，可以使用 CMAKE_TEST_LAUNCHER 變數代替。此策略為尚未更新的專案提供相容性。

此策略的 OLD 行為是讓 add_test() 無條件使用 CROSSCOMPILING_EMULATOR 目標屬性。此策略的 NEW 行為是讓 add_test() 僅在 cross-compiling 時才使用 CROSSCOMPILING_EMULATOR 目標屬性。

此策略在 CMake 3.29 版本中引入。可由 cmake_policy() 或 cmake_minimum_required() 設定。如果未設定，CMake 不會發出警告，並使用 OLD 行為。

注意

策略的 OLD 行為依定義為 已棄用，並可能在未來版本的 CMake 中移除。