CMAKE_TRY_COMPILE_PLATFORM_VARIABLES

从 3.6 版开始添加。

变量列表，try_compile() 命令源文件签名必须传播到测试项目中，以针对与主机项目相同的平台。

此变量不应该由项目代码设置。它应该由 CMake 的平台信息模块（针对当前工具链）设置，或者在与 CMAKE_TOOLCHAIN_FILE 一起使用时由工具链文件设置。

与 CMake 有意义的变量，比如 CMAKE_<LANG>_FLAGS，将自动传播。CMAKE_TRY_COMPILE_PLATFORM_VARIABLES 变量可以设置，以便传递对工具链文件有意义的自定义变量。例如，一个工具链文件可以包含

set(CMAKE_SYSTEM_NAME ...)
set(CMAKE_TRY_COMPILE_PLATFORM_VARIABLES MY_CUSTOM_VARIABLE)
# ... use MY_CUSTOM_VARIABLE ...

如果用户传递 -DMY_CUSTOM_VARIABLE=SomeValue 到 CMake，那么此设置将对工具链文件可见，用于主项目和 try_compile() 命令源文件签名生成的测试项目。

在 3.24 版中更改： 列出的变量会传播到 try_compile() whole-project 签名。查看 CMP0137。

在 3.24 版中添加： CMAKE_TRY_COMPILE_NO_PLATFORM_VARIABLES 变量可以设置为禁用将平台变量传递到测试项目中。