CMake 3.25 版本發行說明¶
自 CMake 3.24 以來所做的變更包括以下內容。
新功能¶
預設集¶
cmake-presets(7)結構描述版本已提升至6。cmake-presets(7)格式現在支援packagePresets欄位，以指定cpack --preset的預設集。cmake-presets(7)格式現在支援workflowPresets欄位，以指定cmake --workflow的預設集。cmake-presets(7)格式現在支援outputJUnitFile欄位，以在測試預設集中指定 JUnit 輸出。
語言¶
現在可以透過
CXX_STANDARD、CUDA_STANDARD、HIP_STANDARD或OBJCXX_STANDARD目標屬性指定 C++26 編譯器模式。CUDA語言支援現在包含使用nvcc時的裝置連結時間最佳化。CMAKE_INTERPROCEDURAL_OPTIMIZATION變數和相關聯的INTERPROCEDURAL_OPTIMIZATION目標屬性將啟用裝置 LTO。
命令列¶
新增了
cmake --workflow --preset模式，以透過單一命令驅動配置、建置、測試和封裝操作序列。cmake -E capabilities命令新增了tls欄位，用於告知是否已啟用 TLS。cmake -E env命令列工具新增了--modify旗標，以支援ENVIRONMENT_MODIFICATION操作。cmake --debug-trycompile選項現在會列印日誌訊息，報告每個 try-compile 檢查所在的目錄。
編譯器¶
新增了對 Tasking 編譯器工具鏈 (SmartCode、TriCore、Standalone: ARM、MCS、8051) 的支援，編譯器 ID 為
Tasking。請參閱CMAKE_TASKING_TOOLSET變數。
命令¶
add_subdirectory()命令新增了SYSTEM選項，以在子目錄中啟用SYSTEM目錄屬性。新增了
block()和endblock()命令，以管理包含命令區塊的特定範圍（原則或變數）。cmake_language()命令新增了GET_MESSAGE_LOG_LEVEL子命令。它可用於查詢目前的訊息記錄層級。find_file()、find_path()、find_library()和find_program()命令新增了VALIDATOR選項，以指定要針對每個候選項目呼叫以驗證它的函式。find_package()命令現在在搜尋套件組態檔時，會考量<prefix>/<name>*/(cmake|CMake)/<name>*/形式的路徑。try_compile()和try_run()命令新增了新的簽章，這些簽章更一致地使用關鍵字分派，並且不需要指定二進位目錄。此外，這些簽章為每次調用使用唯一的目錄，這允許在使用cmake --debug-trycompile時保留多個輸出。try_compile()和try_run()命令新增了NO_CACHE選項，以將結果儲存在一般變數中。try_run()命令新增了RUN_OUTPUT_STDOUT_VARIABLE和RUN_OUTPUT_STDERR_VARIABLE選項，以從編譯程式的輸出中分別擷取 stdout 和 stderr。
變數¶
當目標或主機系統分別為 BSD 時，
BSD和CMAKE_HOST_BSD變數現在設定為字串值。當目標或主機系統分別為 Linux 時，
LINUX和CMAKE_HOST_LINUX變數現在設定為 true。引入了
CMAKE_MSVC_DEBUG_INFORMATION_FORMAT變數和MSVC_DEBUG_INFORMATION_FORMAT目標屬性，以選擇以 MSVC ABI 為目標的編譯器的偵錯資訊格式。請參閱原則CMP0141。新增了
CMAKE_XCODE_SCHEME_ENABLE_GPU_API_VALIDATION變數和對應的XCODE_SCHEME_ENABLE_GPU_API_VALIDATION目標屬性，以告知Xcode產生器在方案的Metal: API Validation設定中放入什麼。新增了
CMAKE_XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION變數和對應的XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION目標屬性，以告知Xcode產生器在方案的Metal: Shader Validation設定中放入什麼。新增了
CMAKE_XCODE_SCHEME_LAUNCH_MODE變數和對應的XCODE_SCHEME_LAUNCH_MODE目標屬性，以告知Xcode產生器在方案的「啟動」模式設定中放入什麼。新增了
CMAKE_XCODE_SCHEME_LAUNCH_CONFIGURATION變數和對應的XCODE_SCHEME_LAUNCH_CONFIGURATION目標屬性，以告知Xcode產生器在方案的啟動動作中放入哪個配置。
屬性¶
<LANG>_COMPILER_LAUNCHER目標屬性現在支援產生器運算式。新增了
EXPORT_NO_SYSTEM目標屬性，以指定install(EXPORT)和export()命令將產生具有SYSTEM屬性OFF的匯入目標。新增了
SYSTEM目標屬性，以指定是否應將目標視為系統程式庫（即，其包含目錄在編譯消費者時會自動成為SYSTEM）。如果未設定，預設值為先前的行為：匯入目標為 on，其他目標為 off。
模組¶
FetchContent模組的FetchContent_Declare()命令新增了SYSTEM選項，該選項在SYSTEM由FetchContent_MakeAvailable()建立的子目錄上設定目錄屬性。FindCUDAToolkit模組現在為 CUDA 10.0+ 提供了 nvtx3 的目標，它取代了 nvToolsExt。當專案需要 CMake 3.25 且使用 CUDA 10.0+ 時，使用nvToolsExt時會發出棄用警告。FindDoxygen模組的版本處理已得到改進如果需要滿足版本約束，現在將考慮多個候選安裝。先前，只會考慮遇到的第一個。
支援版本範圍。
現在可以容忍 Doxygen 報告的版本格式的變體（例如，尾隨 git commit 雜湊）。
FindOpenAL模組現在提供匯入的目標。新增了
FindOpenSP模組，以尋找 OpenSP 程式庫。FindVulkan模組增加了對新組件的支援dxcDirectX Shader Compiler。
volkVolk 開源 vulkan meta-loader。
CPack¶
CPack 封存產生器新增了CPACK_ARCHIVE_FILE_EXTENSION變數，以控制套件檔案名稱副檔名。CPack NSIS 產生器新增了兩個新變數CPACK_NSIS_EXECUTABLE_PRE_ARGUMENTS和CPACK_NSIS_EXECUTABLE_POST_ARGUMENTS，以提供 nsis 可執行檔調用的引數。CPack模組新增了CPACK_READELF_EXECUTABLE、CPACK_OBJCOPY_EXECUTABLE和CPACK_OBJDUMP_EXECUTABLE變數，以控制cpack(1)使用的 binutils 的位置。
已棄用和移除的功能¶
IMPORTED_NO_SYSTEM目標屬性已被棄用，改用SYSTEM和EXPORT_NO_SYSTEM。Visual Studio 10 2010產生器已被移除。Visual Studio 11 2012產生器現在已被棄用，並將在 CMake 的未來版本中移除。
其他變更¶
現在可以使用
SSL_CERT_FILE和SSL_CERT_DIR環境變數來覆寫在何處尋找 TLS/SSL 操作的憑證授權單位。如果
<LANG>_CLANG_TIDY包含-p引數，則完整編譯器命令列不再附加在--之後。Xcode產生器不再將每個配置的後綴$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)新增至程式庫搜尋路徑。請參閱原則CMP0142。
更新¶
自 CMake 3.25.0 以來所做的變更包括以下內容。
3.25.1¶
在 Windows 上，當以 MSVC ABI 為目標時，
find_library()命令不再接受.a檔案名稱。此行為是在 CMake 3.25.0 中新增的，但由於在我們之前沒有的案例中找到 GNU-ABI 程式庫，因此已還原。
3.25.2¶
NVCC 12.0 及更高版本現在支援 CUDA 語言層級 20（對應於 C++20）。
在 Windows 上，Intel oneAPI 2023.0 及更高版本現在提供的
icpx編譯器不再被選取，因為 CMake 尚不支援其類似 GNU 的命令列。
3.25.3¶
此版本未對已記錄的功能或介面進行任何變更。進行了一些實作更新，以支援生態系統變更和/或修復回歸。