CMake 3.14 发行说明

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

新功能

生成器

• 添加了 Visual Studio 16 2019 生成器。此生成器为实验性的，基于“Visual Studio 2019 Preview 4”，因为此版本的 VS 尚未正式发布。

  VS 2019 生成器与早期版本的生成器不同之处在于，它不提供在生成器名称中指定目标平台的变体。而是必须使用 CMAKE_GENERATOR_PLATFORM，例如通过 -A 命令行选项。此外，默认目标平台（体系结构）现在基于*宿主*平台。VS 宿主工具集选择现在也基于宿主体系结构。

• Green Hills MULTI 生成器已更新

  • 现在支持 对象库。

  • 现在会对不受支持的项目类型（如共享库）发出警告。

  • 现在为每个调用 project() 命令的目录生成一个顶层 <PROJECT-NAME>.top.gpj 文件。不再创建顶层项目文件 default.gpj。

  • 现在会遵循目标重命名和输出目标控制属性，例如 RUNTIME_OUTPUT_DIRECTORY 和 OUTPUT_NAME。这也修复了 install() 生成的安装规则的支持。

  • 现在会遵循源文件属性 INCLUDE_DIRECTORIES、COMPILE_DEFINITIONS 和 COMPILE_OPTIONS。

  • 现在支持动态下载完整性应用程序，这些应用程序未通过 GHS_INTEGRITY_APP 集成文件并通过设置链接标志 -dynamic。

  • 项目文件内容现在按名称对源组和文件进行排序。设置 GHS_NO_SOURCE_GROUP_FILE 目标属性为 ON，以便为目标生成单个项目文件，而不是为每个源组生成一个项目文件。设置 CMAKE_GHS_NO_SOURCE_GROUP_FILE 变量以启用此功能的所有目标。

基于文件的 API

• 添加了用于客户端获取语义构建系统信息的基于文件的 API。请参阅 cmake-file-api(7) 手册。这旨在取代 IDE 使用的 cmake-server(7) 模式。

平台

• CMake 现在支持使用简单的工具链文件 为 iOS、tvOS 或 watchOS 进行交叉编译。

命令行

• cmake(1) 构建工具模式 （cmake --build）增加了 --verbose 和 -v 选项来指定详细的构建输出。某些生成器（如 Xcode）目前不支持此选项。

• cmake(1) -E compare_files 命令增加了新的 --ignore-eol 选项，用于在比较文件时忽略行尾差异（例如 LF 与 CRLF）。

• cmake-gui(1) 对话框增加了新的 -S 和 -B 参数，用于显式指定源目录和构建目录。

命令

• file() 命令增加了一个新的子命令 CREATE_LINK，用于创建硬链接或符号链接。

• file() 命令增加了一个新的子命令 READ_SYMLINK，用于确定符号链接指向的路径。

• file() 命令增加了一个 SIZE 模式，用于获取磁盘上文件的大小。

• find_package() 命令增加了可选解析包配置文件路径中符号链接的功能。请参阅 CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS 变量。

• get_filename_component() 命令增加了新的 LAST_EXT 和 NAME_WLE 变体，用于处理名称中最后一个 . 之后的文件扩展名。

• if() 命令增加了对使用 DEFINED CACHE{VAR} 语法检查缓存变量是否已定义的shupport。

• install(CODE) 和 install(SCRIPT) 命令增加了对生成器表达式的支持。请参阅策略 CMP0087。

• install(TARGETS) 命令学会了在没有 DESTINATION 参数的情况下，根据 GNUInstallDirs 模块的变量和内置默认值，为给定类型的目标安装到适当的默认目录。

• install(FILES) 和 install(DIRECTORY) 命令增加了一套新参数，用于将文件作为文件类型安装，根据 GNUInstallDirs 的相关变量和内置默认值设置目标目录，而无需 DESTINATION 参数。

• list() 操作 REMOVE_ITEM、REMOVE_DUPLICATES、SORT、REVERSE 和 FILTER 现在都可以接受一个不存在的变量作为列表，因为这些操作在空列表上结果也是空列表。

• list() 操作 REMOVE_AT 现在会指示给定的索引对于不存在的变量或空列表是无效的。

• try_compile() 和 try_run() 命令增加了新的 LINK_OPTIONS 选项。

变量

• 添加了 CMAKE_BUILD_RPATH_USE_ORIGIN 变量和相应的 BUILD_RPATH_USE_ORIGIN 目标属性，以启用相对运行时路径（RPATHs）的使用。这有助于实现可重定位且与构建目录无关的可重现构建。

• 为 Visual Studio 生成器 添加了 CMAKE_VS_PLATFORM_NAME_DEFAULT 变量，以便在未显式设置 CMAKE_GENERATOR_PLATFORM 时，报告它们使用的默认平台。

属性

• 添加了一个 CMAKE_ROLE 全局属性，允许脚本确定它们是在项目模式、脚本模式、find-package 模式、CTest 还是 CPack 中运行。

• 现在 CUDA_RESOLVE_DEVICE_SYMBOLS 目标属性也支持共享库、模块库和可执行目标。之前仅支持静态库。

• 创建了 EXCLUDE_FROM_ALL 目标属性来覆盖其目录的设置。如果目标的 EXCLUDE_FROM_ALL 属性设置为 OFF，即使其包含的目录被标记为 EXCLUDE_FROM_ALL，该目标现在也将被构建为“all”的一部分。

• INTERFACE_POSITION_INDEPENDENT_CODE 目标属性增加了对 生成器表达式 的支持。

模块

• 用于检查能力的模块系列（如 CheckCSourceCompiles）获得了管理 LINK_OPTIONS 的能力。

• 添加了 CheckFortranSourceRuns 模块，提供 check_fortran_source_runs() 命令，用于检查 Fortran 源片段是否可以编译和运行。

• CMakePackageConfigHelpers 模块的 write_basic_package_version_file() 命令增加了一个新的 ARCH_INDEPENDENT 选项，用于支持与体系结构无关的包。

• ExternalProject 模块的 ExternalProject_Add() 命令增加了 LOG_DIR 和 LOG_MERGED_STDOUTERR 选项来控制日志记录。

• ExternalProject 模块的 ExternalProject_Add() 命令增加了 LOG_PATCH 选项，用于可选地记录补丁步骤。

• ExternalProject 模块的 ExternalProject_Add() 命令学会了在也使用 BUILD_IN_SOURCE 时应用 SOURCE_SUBDIR。 BUILD_COMMAND 在 SOURCE_DIR 的给定 SOURCE_SUBDIR 中运行。

• FetchContent 模块增加了一个新的 FetchContent_MakeAvailable() 命令。它接受一个依赖项名称列表，然后遍历这些名称，使用规范模式填充并将其添加到主构建中。这大大减少了项目中所需的样板代码量。

• FindBISON 模块的 bison_target() 命令现在以 CMAKE_CURRENT_BINARY_DIR 作为工作目录来运行 bison。请参阅策略 CMP0088。

• FindCURL 模块增加了请求协议作为包组件的支持。

• 添加了 FindFontconfig 模块来查找 fontconfig。

• FindGDAL 模块现在提供导入的目标。

• FindGIF 模块现在提供导入的目标。

• FindGit 模块现在为 Git 可执行文件提供一个导入的目标。

• FindIce 模块学会查找 slice2confluence 和 slice2matlab。

• 添加了 FindLibinput 模块来查找 libinput。

• FindLibLZMA 模块现在提供导入的目标。

• FindMatlab 模块增加了新的选项 R2017b 和 R2018a，用于指定要使用的 MEX API 版本；这些选项镜像了 MATLAB R2018a 中 mex 命令的新选项。 MX_LIBRARY 选项不再需要。

• FindPostgreSQL 模块现在提供导入的目标。

• FindPython、FindPython2 和 FindPython3 模块增加了对 NumPy 组件的支持。

• FindPython2、FindPython3 和 FindPython 模块现在通过跳过导入的目标和辅助函数的创建来支持在脚本模式下运行。

• 添加了 FindSQLite3 模块来查找 SQLite v3.x 库。

• FindX11 模块重命名了以下变量，以便与库名匹配而不是头文件名。旧变量仍然提供以兼容。

  • X11_Xxf86misc_INCLUDE_PATH 而不是 X11_xf86misc_INCLUDE_PATH

  • X11_Xxf86misc_LIB 而不是 X11_xf86misc_LIB

  • X11_Xxf86misc_FOUND 而不是 X11_xf86misc_FOUND

  • X11_Xxf86vm_INCLUDE_PATH 而不是 X11_xf86vmode_INCLUDE_PATH

  • X11_Xxf86vm_LIB 而不是 X11_xf86vmode_LIB

  • X11_Xxf86vm_FOUND 而不是 X11_xf86vmode_FOUND

  • X11_xkbfile_INCLUDE_PATH 而不是 X11_Xkbfile_INCLUDE_PATH

  • X11_xkbfile_LIB 而不是 X11_Xkbfile_LIB

  • X11_xkbfile_FOUND 而不是 X11_Xkbfile_FOUND

  • X11_Xtst_INCLUDE_PATH 而不是 X11_XTest_INCLUDE_PATH

  • X11_Xtst_LIB 而不是 X11_XTest_LIB

  • X11_Xtst_FOUND 而不是 X11_XTest_FOUND

  • X11_Xss_INCLUDE_PATH 而不是 X11_Xscreensaver_INCLUDE_PATH

  • X11_Xss_LIB 而不是 X11_Xscreensaver_LIB

  • X11_Xss_FOUND 而不是 X11_Xscreensaver_FOUND

  由于它们本质上是重复的，以下变量已被完全弃用

  • X11_Xinput_INCLUDE_PATH (使用 X11_Xi_INCLUDE_PATH)

  • X11_Xinput_LIB (使用 X11_Xi_LIB)

  • X11_Xinput_FOUND (使用 X11_Xi_FOUND)

• FindX11 现在提供 X11_Xext_INCLUDE_PATH。

• FindX11 现在提供导入的目标。

• UseSWIG 模块学会了在定义文件属性 SWIG_MODULE_NAME 时，向 SWIG 编译器传递 -module <module_name>。请参阅策略 CMP0086。

• UseSWIG 模块增加了一个选项来指定 SWIG 源文件扩展名。

生成器表达式

• 添加了 $<Fortran_COMPILER_ID:...> 和 $<Fortran_COMPILER_VERSION:...> 生成器表达式。

• $<IN_LIST:...> 生成器表达式现在可以正确处理空参数。请参阅 CMP0085 了解详情。

自动生成

• 添加了 AUTOMOC_EXECUTABLE、AUTORCC_EXECUTABLE 和 AUTOUIC_EXECUTABLE 目标属性。它们都接受一个指向可执行文件的路径，并强制 automoc/autorcc/autouic 使用该可执行文件。

  设置这些属性还将阻止在配置时测试这些可执行文件。这主要在您自己构建这些工具时有用。

• 新的变量 CMAKE_GLOBAL_AUTOGEN_TARGET、CMAKE_GLOBAL_AUTOGEN_TARGET_NAME、CMAKE_GLOBAL_AUTORCC_TARGET 和 CMAKE_GLOBAL_AUTORCC_TARGET_NAME 控制全局 autogen 和 autorcc 目标的生成。

• 新的 CMAKE_AUTOGEN_ORIGIN_DEPENDS 变量和 AUTOGEN_ORIGIN_DEPENDS 目标属性可以设置，以启用或禁用将源目标的依赖关系转发给相应的 <ORIGIN>_autogen 目标。

CTest

• ctest(1) 增加了 --show-only=json-v1 选项，以机器可读的 JSON 格式显示测试列表。请参阅手册的 Show as JSON Object Model 部分。

• ctest_submit() 命令增加了 Done 部分，可以用于通知 CDash 构建已完成，并且不会再上传其他部分。

• CTest 学会了从单个变量接受仪表板服务器提交 URL。请参阅 ctest(1) 中的 SubmitURL 设置、CTEST_SUBMIT_URL 变量和 ctest_submit() 命令的 SUBMIT_URL 参数。

弃用和移除的功能

• 为策略 CMP0064 和 CMP0065 （CMP0063 及更早版本已弃用）添加了明确的弃用诊断。 cmake-policies(7) 手册解释说，所有策略的旧行为都已弃用，项目应迁移到新行为。

• Xcode 生成器弃用了对 Xcode 5 之前版本的支持。对这些版本的支持将在 CMake 的未来版本中删除。

• FindQt 模块不再被 find_package() 命令用作查找模块。这允许 Qt Project 上游可选地提供自己的 QtConfig.cmake 包配置文件，并让应用程序通过 find_package(Qt) 而不是 find_package(Qt CONFIG) 来使用它。请参阅策略 CMP0084。

• 已删除对在 Windows XP 和 Windows Vista 上运行 CMake 的支持。在 cmake.org 上提供的预编译 Windows 二进制文件现在需要 Windows 7 或更高版本。

• CTest 不再支持通过 ftp、scp、cp 和 xmlrpc 进行提交。CDash 是 CTest 唯一维护的测试仪表板，它只支持通过 http 和 https 进行提交。

• MacroAddFileDependencies 模块已弃用。请将项目迁移到直接使用 set_property()。

其他更改

• 已修复对象库链接，以将对象库的私有链接库传播给消耗目标。

• 在 add_subdirectory() 下的安装规则现在会与调用目录中的规则交错。请参阅策略 CMP0082 了解详情。

• CMake 现在施加了最大递归限制，以防止脚本无限递归导致堆栈溢出。可以在运行时使用 CMAKE_MAXIMUM_RECURSION_DEPTH 调整限制。

• 当通过 CMAKE_<LANG>_CPPCHECK 变量或 <LANG>_CPPCHECK 属性使用 cppcheck 时，如果 cppcheck 根据其命令行选项返回非零值，构建现在将失败。

• 当设置 POSITION_INDEPENDENT_CODE 时，现在会添加管理独立于位置的可执行文件的必需链接选项。项目负责使用 CheckPIESupported 模块来检查 PIE 支持，以确保 POSITION_INDEPENDENT_CODE 目标属性在链接时对于可执行文件将被遵守。此行为由策略 CMP0083 控制。

• Visual Studio 生成器（支持 VS 2010 及以上版本）学会了支持通过 add_custom_target() 创建的目标上的 VS_DEBUGGER_* 属性。

• CPack 模块不再默认使用 CPACK_DEBIAN_ARCHIVE_TYPE 变量中的 paxr 值，因为 dpkg 从未支持 PAX tar 格式。 paxr 值将被映射到 gnutar 并发出弃用消息。

• CMake 不再发出警告，如果 install(TARGETS) 命令中列出的目标将其 EXCLUDE_FROM_ALL 属性设置为 true。

更新

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

3.14.1

• 3.14.0 添加的 FindFontconfig 模块意外地使用了大写 FONTCONFIG_* 变量名，这不符合我们的约定。3.14.1 修订了该模块以使用 Fontconfig_* 变量名。这与 3.14.0 不兼容，但由于该模块是 3.14 系列的新增功能，因此使用量应该还不大。

3.14.3

• 添加了 CMAKE_VS_PLATFORM_NAME_DEFAULT 变量，以帮助工具链文件与 Visual Studio 16 2019 生成器配合使用，其中默认平台现在取决于宿主平台。

3.14.4

• 在 CMake 3.14.0 到 3.14.3 中，调用 target_link_libraries() 为在另一个目录中创建的静态库添加 PRIVATE 依赖项（在策略 CMP0079 NEW 行为下）会错误地将这些依赖项的使用要求传播给链接该静态库的依赖项。此问题已修复。此 bug 也存在于 3.13.0 到 3.13.4 中，并在 3.13.5 中得到修复。

3.14.5

• 在 CMake 3.14.0 到 3.14.4 中，CPATH 环境变量的条目不再被排除在通过 include_directories() 和 target_include_directories() 进行显式使用之外。

3.14.6

• 在 CMake 3.14.0 到 3.14.5 中，FindBISON 模块策略 CMP0088 NEW 行为错误地将 .y 输入文件的相对路径解释为相对于构建目录而不是源目录。此问题已修复。

3.14.7

• 在 CMake 3.14.0 到 3.14.6 中，EXCLUDE_FROM_ALL 目录属性相比 3.14 之前的行为有所回归，导致目录内的目标即使从其自身的“all”中也被排除。此问题已修复。