CMake 3.21 发行说明

自 CMake 3.20 以来的更改包括以下内容。

新增功能

预设 (Presets)

• cmake-presets(7) 增加了在配置预设中指定安装前缀 (install prefix) 的支持。

• cmake-presets(7) 增加了条件化启用预设 (conditional enabling of presets) 的支持。

• cmake-presets(7) 增加了对 ${hostSystemName} 宏的支持。

• cmake-presets(7) 增加了省略 generator 和 binaryDir 字段的支持。

生成器

• 增加了 Visual Studio 17 2022 生成器。

• Makefile Generators 和 Ninja 生成器学会了在链接器旁边为 C, CXX, OBJC, 和 OBJCXX 语言添加链接器启动器工具 (linker launcher tools)。有关详细信息，请参见 CMAKE_<LANG>_LINKER_LAUNCHER 变量和 <LANG>_LINKER_LAUNCHER 目标属性。

语言

• CMake 学会了支持 HIP 作为一级语言，可以通过 project() 和 enable_language() 命令启用。

• C_STANDARD, OBJC_STANDARD, 和 Compile Features 功能增加了对 C17 和 C23 的支持。

• 源文件扩展名 .ixx 和 .cppm 现在被视为 C++。

命令行

• cmake(1) 增加了 --install-prefix 命令行选项来指定安装前缀的位置。

• cmake(1) 增加了 --toolchain 命令行选项来指定工具链文件 (toolchain file)。

• cmake(1) 的 -E capabilities 输出，对于某些生成器，现在可能包含一个 supportedPlatforms 字段，列出了在 CMAKE_GENERATOR_PLATFORM 中已知的受支持平台。

• 现在，打印到终端的消息可能会根据消息类型着色。

编译器

• 现在支持 Fujitsu 编译器，在传统模式 (Trad) 下使用编译器 ID Fujitsu，在 Clang 模式下使用编译器 ID FujitsuClang。

平台

• CMake 现在支持 MSYS 运行时环境，类似于 CYGWIN。

基于文件的 API

• cmake-file-api(7) "codemodel" 版本 2 的 version 字段已更新至 2.3。

• cmake-file-api(7) "codemodel" 版本 2 增加了一个新的 "directory" 对象，其中包含目录级别的​​信息。这包括由 install() 命令生成的安装程序列表。

命令

• add_custom_command() 命令的 DEPFILE 选项

  • 现在可以使用 生成器表达式 (generator expressions)，

  • 现在得到了 VS 2012 及以上版本的 Visual Studio Generators 的支持，并且

  • 现在得到了 Xcode 生成器的支持。

• add_custom_command(TARGET) 命令（用于 Build Events）增加了对解析目标依赖的生成器表达式的支持。

• build_command() 命令增加了 PARALLEL_LEVEL 选项。

• 增加了 file(COPY_FILE) 命令来复制单个文件。

• file(GET_RUNTIME_DEPENDENCIES) 命令增加了新的 POST_INCLUDE_FILES 和 POST_EXCLUDE_FILES 参数。

• file(REAL_PATH) 命令增加了 EXPAND_TILDE 选项，用于将任何前导波浪号替换为用户主目录的路径。

• file(RENAME) 命令学会了选择性地将失败捕获到结果变量中。它还增加了一个 NO_REPLACE 选项，如果目标已存在则失败。

• install() 命令增加了新的 IMPORTED_RUNTIME_ARTIFACTS 模式，可用于安装导入目标的运行时工件。

• install() 命令增加了新的 RUNTIME_DEPENDENCY_SET 模式，可用于使用 file(GET_RUNTIME_DEPENDENCIES) 来安装运行时依赖项。

• install(TARGETS) 命令增加了新的 RUNTIME_DEPENDENCIES 和 RUNTIME_DEPENDENCY_SET 参数，可用于使用 file(GET_RUNTIME_DEPENDENCIES) 来安装运行时依赖项。

• install(SCRIPT|CODE) 命令支持新的 ALL_COMPONENTS 选项，允许相应的代码在按组件安装的每个组件上运行。

• project() 命令现在设置变量 PROJECT_IS_TOP_LEVEL 和 <PROJECT-NAME>_IS_TOP_LEVEL 来指示是否在顶层 CMakeLists.txt 文件中调用。

变量

• 增加了 CMAKE_TOOLCHAIN_FILE 环境变量，以提供 CMAKE_TOOLCHAIN_FILE 变量的默认值。

属性

• 增加了 IMPORTED_TARGETS 目录属性，用于获取当前目录中创建的 Imported Targets 列表。

• 增加了 XCODE_EMBED_APP_EXTENSIONS 目标属性，用于告知 Xcode 生成器嵌入应用扩展（例如 iMessage 贴纸包）。嵌入的各个方面可以通过 XCODE_EMBED_APP_EXTENSIONS_PATH、XCODE_EMBED_APP_EXTENSIONS_CODE_SIGN_ON_COPY 和 XCODE_EMBED_APP_EXTENSIONS_REMOVE_HEADERS_ON_COPY 属性进行自定义。

模块

• FindBLAS 和 FindLAPACK 模块学会了支持串行 Fujitsu_SSL2 和并行 Fujitsu_SSL2BLAMP 库。

• FindDevIL 模块现在提供了导入目标 (imported targets)。

• FindIconv 模块现在支持版本。

• FindIntl 模块现在支持版本。

• FindMPI 模块学会了在主机和交叉编译模式下支持 Fujitsu 和 FujitsuClang。

• 增加了 FindMsys 模块来查找 MSYS 安装。与 FindCygwin 类似，它被一些其他查找模块自动用于在 Windows 上定位类 UNIX 工具。

• FindOpenMP 模块学会了支持 Fujitsu 和 FujitsuClang。

• FindVulkan 模块增加了导入目标 Vulkan::Headers 和 Vulkan::glslangValidator。

• UseJava 模块命令 add_jar 增加了 RESOURCES 选项，允许使用非可选命名空间显式命名资源。

• UseSWIG 模块现在为 CSharp 语言使用了标准库命名约定。请参见策略 CMP0122。

• UseSWIG 模块现在使用 swig 工具为 Xcode 生成器生成隐式依赖项。

生成器表达式

• 增加了一个新的 TARGET_RUNTIME_DLLS 生成器表达式。

CTest

• ctest(1) 增加了关于其捕获 Additional Test Measurements 能力的文档。

• ctest(1) 学会了在运行时识别附加到测试的文件。以前只能在配置时使用 ATTACHED_FILES 或 ATTACHED_FILES_ON_FAIL 测试属性来附加文件。有关更多信息，请参见 Additional Test Measurements。

• ctest(1) 增加了 --output-junit 选项，用于将测试结果写入 JUnit XML 文件。

• ctest_build() 命令增加了 PARALLEL_LEVEL 选项。

CPack

• CPack DragNDrop Generator 增加了 CPACK_DMG_FILESYSTEM 选项来控制 .dmg 文件系统。

• CPack IFW Generator 现在支持在传递给 cpack_ifw_configure_component() 或 cpack_ifw_configure_component_group() 的 DEPENDS 或 DEPENDENCIES 参数的名称中使用连字符。这需要 QtIFW 3.1 或更高版本。

• CPack NSIS Generator 增加了新的 CPACK_NSIS_EXECUTABLE 变量，用于指定要使用的 makensis 可执行文件，而不是默认的。

• 增加了 CPACK_CUSTOM_INSTALL_VARIABLES 变量，用于在 CPack 调用 cmake_install.cmake 脚本时设置变量。

已弃用和移除的功能

• 未文档化的 CMAKE_SYSTEM_NAME 版本剥离行为已被完全移除。如果它由 -D 标志或 工具链文件 设置，它将保持不变，即使它仍然包含版本号。类似的未文档化的 CMAKE_HOST_SYSTEM_NAME 版本剥离行为已被提前，在调用 project() 或 enable_language() 之前。

• 不再基于 CMAKE_SYSTEM_PROCESSOR 变量或未文档化的 CMAKE_SYSTEM_ARCH 变量自动添加 ARMClang 的 CPU/Arch 编译和链接标志。它们必须显式指定。请参见策略 CMP0123。

其他更改

• find_file()、find_path()、find_program() 和 find_library() 命令以相同的方式处理缓存变量，无论它们是如何定义的。有关详细信息，请参见策略 CMP0125。

• find_file()、find_path()、find_program() 和 find_library() 命令增加了 NO_CACHE 选项，用于将查找结果存储在普通变量中。

• foreach() 命令现在将循环变量隔离在循环作用域中。有关详细信息，请参见策略 CMP0124。

• list() 命令的 GET, INSERT, SUBLIST, 和 REMOVE_AT 子命令，如果提供了无效（即非整数）值作为任何索引参数，现在会根据策略 CMP0121 的设置报错。

• set(CACHE) 命令不再删除同名（如果存在）的普通变量。请参见策略 CMP0126。

• target_link_libraries() 调用通过 TARGET_OBJECTS 生成器表达式引用对象库时，现在将对象文件放在链接行上所有库之前，无论其指定的顺序如何。有关详细信息，请参见关于 Linking Object Libraries via $<TARGET_OBJECTS> 的文档。

• Ninja Generators 现在使用绝对路径将源文件和包含目录传递给编译器。这使得诊断消息和调试符号更加一致，并与 Makefile Generators 匹配。

• NMake Makefiles 生成器在使用 VS 9 或更高版本的 nmake 时，现在将生成的 makefiles 编码为 UTF-8（带 BOM）。

• VS 2010 及以上版本的 Visual Studio Generators 现在将每个源的预处理器定义放在目标范围内的预处理器定义之后。这使得 VS 与 Ninja Generators 和 Makefile Generators 一致。

• 在 cmake.org 上提供的预编译二进制文件现在支持 liblzma 多线程。请参见 CPACK_THREADS 和 CPACK_ARCHIVE_THREADS 变量。

更新

自 CMake 3.21.0 以来的更改包括以下内容。

3.21.1

• Visual Studio 17 2022 生成器现在基于 "Visual Studio 2022 Preview 2"。以前是基于 "Preview 1.1"。

3.21.2

• 启用了 CUDA_SEPARABLE_COMPILATION 的 CUDA 目标现在可以在非根目录中正确生成。

• Visual Studio 17 2022 生成器现在基于 "Visual Studio 2022 Preview 3.1"。以前是基于 "Preview 2"。

3.21.3

• Visual Studio 17 2022 生成器现在基于 "Visual Studio 2022 Preview 4"。以前是基于 "Preview 3.1"。

• AMD ROCm 平台 hipcc 编译器在 CMake 3.21.0 到 3.21.2 中被识别为具有 ID ROCMClang 的独立编译器。这已被移除，因为它导致了回归。改为

  • hipcc 可能不再用作 HIP 编译器，因为它会干扰 CMake 需要传递给 Clang 的标志。请直接使用 Clang。

  • hipcc 可以再次用作 CXX 编译器，并被视为其底层选择的任何编译器，这与 CMake 3.20 及更早版本相同。

3.21.4

• Visual Studio 17 2022 生成器现在基于 "Visual Studio 2022" 的发布候选版本。以前是基于预览版本。

3.21.5, 3.21.6, 3.21.7

这些版本未对已记录的功能或接口进行任何更改。为了支持生态系统更改和/或修复回归，进行了一些实现更新。