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() 的 完整專案 簽章。請參閱 CMP0137。

在 3.24 版本新增：可以設定 CMAKE_TRY_COMPILE_NO_PLATFORM_VARIABLES 變數以停用將平台變數傳遞到測試專案。