CMAKE_TRY_COMPILE_PLATFORM_VARIABLES

3.6 版本新增。

变量列表，try_compile() 命令源文件签名必须将这些变量传播到测试项目中，以便目标与主机项目是同一个平台。

项目代码不应设置此变量。它 meant to be set by CMake's platform information modules for the current toolchain, or by a toolchain file when used with 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() 命令源文件签名生成的测试项目。

Changed in version 3.24: 列出的变量也会传播到 try_compile() whole-project 签名。请参阅 CMP0137。

Added in version 3.24: 可以设置 CMAKE_TRY_COMPILE_NO_PLATFORM_VARIABLES 变量来禁用将平台变量传递到测试项目。