CMP0137

在 3.24 版本中新增。

try_compile() 在專案模式中傳遞平台變數。

try_compile() 命令的原始碼檔案簽章會將包含平台設定的 CMake 變數，以及由CMAKE_TRY_COMPILE_PLATFORM_VARIABLES變數指定的變數，傳遞到產生的測試專案中。這有助於測試專案以與調用專案相同的方式驅動工具鏈。在 CMake 3.23 及更早版本中，整個專案簽章不會自動傳遞平台變數。CMake 3.24 及更高版本偏好在整個專案簽章中傳遞平台變數。此策略提供了與尚未更新以預期此行為的專案的相容性。

此策略的 OLD 行為是不向整個專案簽章傳遞任何額外的變數。此策略的 NEW 行為是傳遞與原始碼檔案簽章相同的變數。

無論策略設定如何，都可以設定CMAKE_TRY_COMPILE_NO_PLATFORM_VARIABLES變數來抑制透過任一簽章傳遞平台變數。

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

注意

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