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选项现在会打印日志消息，报告执行每次尝试编译检查的目录。
编译器¶
添加了对 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生成器在 scheme 的Metal: API Validation设置中放置什么。添加了
CMAKE_XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION变量和相应的XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION目标属性，以告知Xcode生成器在 scheme 的Metal: Shader Validation设置中放置什么。添加了
CMAKE_XCODE_SCHEME_LAUNCH_MODE变量和相应的XCODE_SCHEME_LAUNCH_MODE目标属性，以告知Xcode生成器在 scheme 的“Launch”模式设置中放置什么。添加了
CMAKE_XCODE_SCHEME_LAUNCH_CONFIGURATION变量和相应的XCODE_SCHEME_LAUNCH_CONFIGURATION目标属性，以告知Xcode生成器在 scheme 的 Launch 操作中放置什么配置。
属性¶
<LANG>_COMPILER_LAUNCHER目标属性现在支持生成器表达式。添加了
EXPORT_NO_SYSTEM目标属性，用于指定install(EXPORT)和export()命令将生成SYSTEM属性为OFF的导入目标。添加了
SYSTEM目标属性，用于指定是否应将目标视为系统库（即，其包含目录在编译使用者时自动为SYSTEM）。如果未设置，则默认行为与之前相同：对于导入目标为 on，对于其他目标为 off。
模块¶
FetchContent模块的FetchContent_Declare()命令新增了SYSTEM选项，该选项在SYSTEM子目录上设置SYSTEM目录属性，这些子目录由FetchContent_MakeAvailable()创建。FindCUDAToolkit模块现在为 CUDA 10.0+ 提供了 nvtx3 的目标，它取代了 nvToolsExt。如果项目需要 CMake 3.25 并且使用 CUDA 10.0+，则在使用nvToolsExt时会发出弃用警告。FindDoxygen模块的版本处理已得到改进如果需要满足版本约束，现在将考虑多个候选安装。以前，只会考虑遇到的第一个。
支持版本范围。
现在可以容忍 Doxygen 报告的版本格式的变化（例如，尾随 git 提交哈希）。
FindOpenAL模块现在提供导入的目标。添加了
FindOpenSP模块，用于查找 OpenSP 库。FindVulkan模块获得了对新组件的支持dxcDirectX Shader Compiler。
volkVolk 开源 vulkan 元加载器。
CPack¶
CPack Archive Generator新增了CPACK_ARCHIVE_FILE_EXTENSION变量，用于控制包文件名扩展名。CPack NSIS Generator新增了两个新变量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¶
此版本未对已记录的特性或接口进行任何更改。进行了一些实现更新以支持生态系统更改和/或修复回归。