CMake 3.31 发行说明

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

新功能

预设 (Presets)

• cmake-presets(7) 文件现在可以在 JSON 对象内的任何级别使用 $comment 键包含注释，以提供文档。

• cmake-presets(7) 文件现在可以使用配置预设中的 graphviz 键请求 graphviz 输出。

生成器

• Ninja Generators 和 Makefile Generators 现在会生成一个 codegen 构建目标。请参阅策略 CMP0171。它驱动足以运行使用 add_custom_command() 的新 CODEGEN 选项创建的自定义命令的构建图的子集。

命令行

• cmake --workflow 模式现在接受预设名称作为第一个参数，允许使用更简单的命令行 cmake --workflow <preset>。

• 添加了 cmake -LR[A][H] 选项来列出名称与正则表达式匹配的缓存条目。

编译器

• 现在支持 LFortran 编译器，其 compiler id 为 LFortran。

命令

• 添加了 add_custom_command() 命令的 CODEGEN 选项，用于将自定义命令的输出标记为 codegen 目标的依赖项。请参阅策略 CMP0171。

• 添加了 cmake_pkg_config() 命令，作为使用 CMake 的原生 pkg-config 格式解析器的端点。在此版本中唯一支持的选项是 EXTRACT，它提供了对解析 pkg-config 文件产生的值的低级访问。对于大多数用户来说，这还不能很好地替代 FindPkgConfig 模块。

• file(ARCHIVE_CREATE) 命令添加了 WORKING_DIRECTORY 选项，用于指定归档过程的工作目录。

• file(MAKE_DIRECTORY) 命令添加了 RESULT 选项，用于捕获结果变量中的失败。

• install(FILES) 和 install(DIRECTORY) 命令的 TYPE 参数现在支持 LIBEXEC 类型。

变量

• 添加了 CMAKE_AIX_SHARED_LIBRARY_ARCHIVE 变量和相应的 AIX_SHARED_LIBRARY_ARCHIVE 目标属性，用于在 AIX 上创建共享库作为共享库归档。

• 添加了 CMAKE_EXPORT_BUILD_DATABASE 变量、相应的 CMAKE_EXPORT_BUILD_DATABASE 环境变量以及 EXPORT_BUILD_DATABASE 目标属性，以启用导出 C++ 模块编译命令。这仅支持 Ninja Generators。

• 添加了 CMAKE_HOST_EXECUTABLE_SUFFIX 变量，用于提供主机平台上可执行文件的后缀。

• 添加了 CMAKE_<LANG>_HOST_COMPILER_ID 和 CMAKE_<LANG>_HOST_COMPILER_VERSION 变量，其中 <LANG> 可以是 CUDA 或 HIP。当 CMAKE_<LANG>_COMPILER_ID 是 NVIDIA 时，它们会被填充以标识 NVCC 的主机编译器。

• 添加了 CMAKE_<LANG>_STANDARD_LINK_DIRECTORIES 变量。工具链文件可以设置此变量来控制始终传递给指定语言编译器的链接库目录路径。

• 添加了 CMAKE_LINK_LIBRARIES_STRATEGY 变量和相应的 LINK_LIBRARIES_STRATEGY 目标属性，以可选地指定 CMake 用于生成链接行的策略。

• 添加了 CMAKE_CONFIG_DIR 环境变量，用于为 cmake-file-api(7) 查询指定 CMake 用户范围的配置目录。

属性

• 添加了 MACOSX_FRAMEWORK_BUNDLE_NAME 目标属性，用于在 Apple 的 FRAMEWORK 的 Info.plist 文件中设置 CFBundleName 键。

• UNITY_BUILD 目标属性现在支持 CUDA 语言。

• 添加了 VS_FRAMEWORK_REFERENCES 目标属性，用于告知 Visual Studio Generators 添加框架引用。

模块

• 检查模块现在支持 CMAKE_REQUIRED_LINK_DIRECTORIES 变量。以下模块获得了此支持：

  • CMakePushCheckState

  • CheckCCompilerFlag

  • CheckCSourceCompiles

  • CheckCSourceRuns

  • CheckCXXCompilerFlag

  • CheckCXXSourceCompiles

  • CheckCXXSourceRuns

  • CheckCXXSymbolExists

  • CheckCompilerFlag

  • CheckFortranCompilerFlag

  • CheckFortranFunctionExists

  • CheckFortranSourceCompiles

  • CheckFortranSourceRuns

  • CheckFunctionExists

  • CheckIncludeFile

  • CheckIncludeFileCXX

  • CheckIncludeFiles

  • CheckOBJCCompilerFlag

  • CheckLibraryExists

  • CheckOBJCCompilerFlag

  • CheckOBJCSourceCompiles

  • CheckOBJCSourceRuns

  • CheckOBJCXXCompilerFlag

  • CheckOBJCXXSourceCompiles

  • CheckOBJCXXSourceRuns

  • CheckPrototypeDefinition

  • CheckSourceCompiles

  • CheckSourceRuns

  • CheckStructHasMember

  • CheckSymbolExists

  • CheckTypeSize

  • CheckVariableExists

• CMakePackageConfigHelpers 模块的 generate_apple_platform_selection_file() 函数增加了对 iOS Mac Catalyst 的支持。

• GoogleTest 模块的 gtest_discover_tests() 命令添加了一个新的 DISCOVERY_EXTRA_ARGS 关键字。它允许在查询测试列表时向命令行附加额外的参数。

• FindCUDAToolkit 模块现在提供了一个 CUDA::nvml_static 目标。

• FindOpenMP 模块现在支持 CUDA 语言。

CTest

• ctest_submit() 命令和 ctest -T Submit 步骤现在默认验证到 https:// URL 的连接的 TLS 服务器证书。有关详细信息，请参阅 CTEST_TLS_VERIFY 变量。

• ctest_submit() 命令和 ctest -T Submit 步骤现在默认要求到 https:// URL 的连接使用 TLS 1.2 或更高版本。有关详细信息，请参阅 CTEST_TLS_VERSION 变量。

CPack

• CPack DEB Generator 添加了 CPACK_DEBIAN_PACKAGE_MULTIARCH 选项来支持多架构包。

• CPack IFW Generator 添加了新的 CPACK_IFW_PACKAGE_PRODUCT_IMAGE_URLS 变量，用于指定与 CPACK_IFW_PACKAGE_PRODUCT_IMAGES 条目相关的图像。此功能适用于 QtIFW 4.0 及更高版本。

• CPack RPM Generator 支持将 zstd 作为 CPACK_RPM_COMPRESSION_TYPE 的值。

• CPack 模块在 CPack WIX Generator 中默认启用按机器安装。请参阅策略 CMP0172 和 CPACK_WIX_INSTALL_SCOPE 变量。

已弃用和已删除的功能

• 与 CMake 3.10 之前的版本的兼容性已被弃用，并将在未来版本中移除。调用 cmake_minimum_required() 或 cmake_policy() 将策略版本设置为更旧的值现在会发出弃用诊断。

• CMakeFindFrameworks 模块已通过 CMP0173 弃用。项目应改用 find_library()。

• 已移除 Visual Studio 12 2013 生成器。

其他更改

• 当静态库在链接行中被去重（根据策略 CMP0156）时，所有平台现在都保留第一个出现。请参阅策略 CMP0179。

• 在 TEST_LAUNCHER 和 CROSSCOMPILING_EMULATOR 目标属性中的空列表元素现在被以下命令保留：

  • 命令 add_test()。

  • 来自 ExternalData 模块的 ExternalData_Add_Test() 命令。

  • 来自 GoogleTest 模块的 gtest_add_tests() 和 gtest_discover_tests() 命令。这两个命令的 EXTRA_ARGS 关键字之后的空列表元素现在也得到了保留。

  请参阅策略 CMP0178。

• execute_process() 命令的 ENCODING 选项在 Windows 上有意义，现在默认为 UTF-8。请参阅策略 CMP0176。

• file(DOWNLOAD) 和 file(UPLOAD) 命令现在默认验证到 https:// URL 的连接的 TLS 服务器证书。有关详细信息，请参阅 CMAKE_TLS_VERIFY 变量。此更改是在没有策略的情况下进行的，以便即使在构建未更新的项目时也能保护用户。用户可以通过将 CMAKE_TLS_VERIFY 环境变量设置为 0 来恢复旧的默认行为。

• file(DOWNLOAD) 和 file(UPLOAD) 命令现在默认要求到 https:// URL 的连接使用 TLS 1.2 或更高版本。有关详细信息，请参阅 CMAKE_TLS_VERSION 变量。

• file(GET_RUNTIME_DEPENDENCIES) 命令已更新，以更紧密地匹配 Linux 上的动态加载器行为。

• install() 命令的 DESTINATION 参数现在会 进行规范化，除了 install(TARGETS) 中的 INCLUDES DESTINATION 参数。请参阅策略 CMP0177。

• project() 命令现在始终将 <PROJECT-NAME>_SOURCE_DIR、<PROJECT-NAME>_BINARY_DIR 和 <PROJECT-NAME>_IS_TOP_LEVEL 设置为普通变量和缓存条目。请参阅策略 CMP0180。

• cmake_parse_arguments(PARSE_ARGV) 命令现在会在单值关键字后定义一个空字符串变量。请参阅策略 CMP0174。

更新

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

3.31.1, 3.31.2, 3.31.3, 3.31.4, 3.31.5, 3.31.6, 3.31.7, 3.31.8, 3.31.9

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

3.31.10

• execute_process() 命令在其 TIMEOUT 到期时再次终止子进程。此行为在 CMake 3.29 中被意外回退。