CMake 4.2 版本说明

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

新特性

基于文件的 API

• cmake-file-api(7) “codemodel” 的 2.x 版本已将 version 字段更新为 2.9。

• cmake-file-api(7) “codemodel” 2.x 版本的 “target” 和 “directory” 对象新增了一个 codemodelVersion 字段。

• cmake-file-api(7) “codemodel” 2.x 版本现在在其响应中包含导入的目标和所有接口库目标。以前，导入的目标被省略，只包含那些参与构建系统的接口目标。以下更改支持这些新增内容：

  • “target” 对象新增了 imported、local 和 abstract 字段。

  • “target” 对象的 type 字段现在还可以包含 UNKNOWN_LIBRARY 值。

  • “codemodel” 对象的 configurations 条目新增了一个 abstractTargets 数组。

  • “codemodel” 对象的 configurations 条目的 directories 和 projects 数组中的条目新增了一个 abstractTargetIndexes 数组。

• cmake-file-api(7) “codemodel” 2.x 版本的 “target” 对象新增了 linkLibraries、interfaceLinkLibraries、compileDependencies、interfaceCompileDependencies、objectDependencies 和 orderDependencies 字段。

生成器

• 新增了 Visual Studio 18 2026 生成器。

• 新增了 FASTBuild 生成器。

平台

• CMake 现在支持使用简单的工具链文件进行 Emscripten 的交叉编译。

命令行

• cmake(1) 命令行工具现在支持 cmake -E copy_if_newer 和 cmake -E copy_directory_if_newer 子命令，通过时间戳比较而非内容比较来复制文件。这些命令仅在源文件比目标文件新时才复制文件，与比较文件内容的 copy_if_different 相比，为构建系统提供了更好的性能。

命令

• 新增了 cmake_language(TRACE) 命令，用于在脚本执行期间启用或禁用跟踪。

• 新增了 set(CACHE{<variable>}) 和 unset(CACHE{<variable>}) 命令，用于显式设置和取消设置缓存条目。

• 新增了 string(REGEX QUOTE) 命令，用于生成精确匹配字符串的正则表达式。

变量

• 新增了 CMAKE_CXX_STDLIB_MODULES_JSON 变量，用于设置标准库的 import std 元数据文件的路径，而不是使用编译器来发现其位置。

• 新增了 CMAKE_INTERMEDIATE_DIR_STRATEGY 变量和相应的 CMAKE_INTERMEDIATE_DIR_STRATEGY 环境变量，用于更改用于命名对象文件和其他相关目标元数据所使用的中间目录的策略。

• 新增了 CMAKE_AUTOGEN_INTERMEDIATE_DIR_STRATEGY 变量和相应的 CMAKE_AUTOGEN_INTERMEDIATE_DIR_STRATEGY 环境变量，用于更改用于命名 Qt Autogen 文件的中间目录的策略。

• 新增了 CMAKE_SKIP_LINTING 变量和相应的 SKIP_LINTING 目标属性，用于告知 命令行构建工具生成器 跳过对目标中所有源文件的 linting。

属性

• 新增了 INSTALL_OBJECT_NAME 源文件属性，用于控制特定编译源的已安装对象文件的名称。

• 新增了 INSTALL_OBJECT_NAME_STRATEGY 目标属性，用于控制已安装对象文件的命名策略。

• 新增了 INSTALL_OBJECT_ONLY_USE_DESTINATION 目标属性，用于更精确地控制对象文件的安装路径。

• 新增了 JOB_POOL_COMPILE 源文件属性，用于将单个源文件的编译分配给 JOB_POOLS。

• 新增了 OBJECT_NAME 源文件属性，用于控制编译源文件的对象名称。

• 新增了 UNITY_BUILD_FILENAME_PREFIX 目标属性，用于控制 UNITY_BUILD 生成的源文件的名称。

模块

• 几乎所有的 find 模块现在都提供一个 <PackageName>_VERSION 结果变量，其大小写与模块名称匹配。现有的变体，如 <PackageName>_VERSION_STRING 和大写的 <PACKAGENAME>_VERSION 已被弃用。详情请参阅每个 find 模块的文档。

• CheckTypeSize 模块的 check_type_size() 命令新增了一个 RESULT_VARIABLE 关键字，用于自定义结果变量名，而不是默认的 HAVE_<size-var>。

• ExternalProject 模块的 ExternalProject_Add() 和 ExternalProject_Add_Step() 命令现在提供了设置 configure、build、install 和 test 步骤环境变量的选项。

• FindPython3、FindPython2 和 FindPython 模块不再使 NumPy 依赖于 Development.Module。请参阅策略 CMP0201。

• GoogleTest 模块的 gtest_discover_tests() 命令现在为每个发现的测试设置 DEF_SOURCE_LINE 测试属性，前提是 gtest 支持 --gtest_output=json 选项。此测试属性可供某些 IDE 用于定位每个测试的源文件。

• UseSWIG 模块的 swig_add_library() 命令新增了一个 DEBUG_POSTFIX 选项，用于控制 DEBUG_POSTFIX 目标属性。

生成器表达式

• 新增了 <LANG>_COMPILER_LINKER_ID 和 <LANG>_COMPILER_LINKER_FRONTEND_VARIANT 系列生成器表达式，用于访问相关 CMAKE_<LANG>_COMPILER_LINKER_ID 和 CMAKE_<LANG>_COMPILER_LINKER_FRONTEND_VARIANT 变量的值。

• TARGET_FILE_BASE_NAME、TARGET_IMPORT_FILE_BASE_NAME、TARGET_LINKER_FILE_BASE_NAME、TARGET_LINKER_LIBRARY_FILE_BASE_NAME、TARGET_LINKER_IMPORT_FILE_BASE_NAME 和 TARGET_PDB_FILE_BASE_NAME 生成器表达式新增了一个 POSTFIX 选项，用于控制在相应文件的基本名称中包含 <CONFIG>_POSTFIX 目标属性。

• 新增了 TARGET_INTERMEDIATE_DIR 生成器表达式，用于引用构建树中目标的中间文件目录。

CPack

• CPACK_PACKAGE_CHECKSUM 变量现在支持多个值。

• CPack NSIS Generator 新增了 CPACK_NSIS_CRC_CHECK 变量，用于设置 CRCCheck 属性。

• CPack WIX Generator 新增了 CPACK_WIX_CAB_PER_COMPONENT 变量，用于为每个组件启用一个 .cab 文件。

已弃用和移除的功能

• 所有 find 模块现在都提供一个 <PackageName>_FOUND 结果变量，其大小写与模块名称匹配。现有的变体，如大写的 <PACKAGENAME>_FOUND，在适当的情况下已弃用。详情请参阅每个 find 模块的文档。

• FindwxWidgets 模块的结果变量 wxWidgets_USE_FILE 已被弃用，建议直接包含 UsewxWidgets 模块。

• Visual Studio 14 2015 生成器已被弃用，将在 CMake 的未来版本中移除。

其他更改

• 对于导入的目标，$<CONFIG:cfgs> 生成器表达式的匹配已修复，使其仅匹配实际正在使用的配置。请参阅策略 CMP0199。

• 导入目标的配置和位置选择现在更加一致。请参阅策略 CMP0200。

• 在处理 CMakeLists.txt 文件时，CMAKE_PARENT_LIST_FILE 变量不再被定义。请参阅策略 CMP0198。

• 对于针对 MSVC ABI 的构建，所有生成器在编译源文件时都会添加 _MBCS 预处理器定义，除非找到 _UNICODE 或 _SBCS。请参阅策略 CMP0204。

• 对于针对 MSVC ABI 的构建，所有生成器在编译共享库中的源文件时都会添加 _WINDLL 预处理器定义。请参阅策略 CMP0203。