CMake 3.10 发行说明

自 CMake 3.9 以来所做的更改包括以下内容。

新功能

平台

  • 现在支持 flang Fortran 编译器，编译器 ID 为 Flang。

  • 为“Midipix”添加了一个新的最小平台文件。

  • 添加了对 MSVC ARM64 架构的支持。 Visual Studio 2017 Update 4 及更高版本提供了 ARM64 工具链。

  • 改进了对 IAR ARM 编译器的支持。

生成器

命令

  • cmake_host_system_information() 命令学习了更多密钥以获取有关处理器功能和主机操作系统版本的信息。

  • configure_file() 命令学会了支持缩进的``# cmakedefine`` 和``# cmakedefine01``。 # 字符和 cmakedefine/cmakedefine01 之间的空格和/或制表符现在可以理解并保留在输出中。

  • execute_process() 命令获得了一个 RESULTS_VARIABLE 选项，用于在给出多个 COMMAND 参数时收集进程管道中所有子进程的结果列表。

  • include_guard() 命令的引入是为了防止 CMake 脚本被多次包含。该命令支持 DIRECTORY 和 GLOBAL 选项来调整相应的包含保护范围。如果没有给出选项，则包含 guard 类似于基本的基于变量的检查。

  • string() 命令学习了一个新的 PREPEND 子命令。

  • string(TIMESTAMP) 命令现在支持完整工作日名称的 %A` 和完整月份名称的 %B``。

变量

特性

模块

  • FindCurses 模块获得了一个 CURSES_NEED_WIDE 选项来请求宽字符变体。

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

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

  • FindMPI 获得了许多新功能，包括：

    • 特定于语言的组件已添加到模块中。

    • 现在支持更多的 MPI 环境。

    • 改进了对 Fortran 的环境支持。

    • 用户现在可以细粒度地控制 MPI 选择过程，包括将自定义参数传递给 MPI 编译器。

    • 已实施的 MPI 标准的版本现已公开。

    • 现在可以检测 MPI-2 C++ 绑定，如果需要也可以抑制。

    • 现在正在检测和验证可用的 Fortran 绑定。

    • 可以请求各种 MPI-3 信息，包括各个绑定的库版本和 Fortran 功能。

    • 支持静态链接的 MPI 实现。

  • 添加了一个 FindOpenACC 模块来检测编译器对 OpenACC 的支持。目前仅支持 PGI、GNU 和 Cray 编译器。

  • FindOpenGL 模块在 Linux 上获得了对 GLVND 的支持。

  • FindOpenMP 模块获得了对特定语言组件的支持。

  • 添加了 FindPatch 模块以查找 patch 命令行可执行文件。

  • FindProtobuf 模块 protobuf_generate_cpp() 命令获得了一个 DESCRIPTORS 选项来生成描述符文件。

  • GoogleTest 模块获得了一个新命令 gtest_discover_tests() 实现动态（构建时）测试发现。与源解析方法不同，动态发现在构建时执行测试（以“列出可用测试”模式）以发现测试。这对于不寻常的标记测试方式非常稳健，为参数化测试等高级功能提供了更好的支持，并且不需要重新运行 CMake 来发现测试可执行文件中添加或删除的测试。请注意，在 CMake 3.10.3 中进行了一项重大更改，以解决 TIMEOUT 关键字的歧义（请参阅:ref:发行说明 3.10.3）。

  • InstallRequiredSystemLibraries 模块获得了对安装英特尔编译器运行时的支持。

自动生成器

  • 将 AUTOMOC 或 AUTOUIC 与多配置生成器（例如:generator:Xcode）一起使用时，包括 *.moc、moc_*.cpp 和 `` ui_*.h`` 文件在``<AUTOGEN_BUILD_DIR>/include_<CONFIG>`` 而不是``<AUTOGEN_BUILD_DIR>/include`` 中生成。

  • 使用 AUTOMOC 或 AUTOUIC 时，也会处理 GENERATED 的源文件。在早期版本中，它们被 AUTOMOC 和 AUTOUIC 忽略了。请参阅政策:policy:CMP0071。

  • 使用 AUTOMOC 时，CMake 在源文件中搜索字符串``Q_OBJECT``、Q_GADGET 或``Q_NAMESPACE`` 以确定是否需要对其进行``moc`` 处理。新的 CMAKE_AUTOMOC_MACRO_NAMES 变量和 AUTOMOC_MACRO_NAMES 目标属性可以设置为注册要搜索的其他字符串（宏名称）。

  • 使用 AUTOMOC 时，新的 CMAKE_AUTOMOC_COMPILER_PREDEFINES 变量和 AUTOMOC_COMPILER_PREDEFINES 目标属性指定是启用还是禁用编译器预定义文件``moc_predefs.h`` 的生成。

C测试

  • CTEST_LABELS_FOR_SUBPROJECTS CTest 模块变量和 CTest 脚本变量被添加以指定应被 CDash 视为子项目的标签列表。要在 CTest 模块和 ctest 命令行 仪表板客户端 模式（例如 ctest -S）中使用此值，请在 CTestConfig.cmake 配置文件中设置它。

包装

其他

  • cmake(1) -E 模式获得了对 sha1sum、sha224sum、sha256sum、sha384sum 和 sha512sum 的支持.

  • graphviz 输出现在区分不同的依赖类型“PUBLIC”、“PRIVATE”和“INTERFACE”，并在输出图中将它们表示为实线、虚线和点线边缘。

弃用和删除的功能

  • 不再支持使用 C++98 编译器构建 CMake 本身。 CMake 现在使用 C++11 实现。

  • 在 HP-UX 上构建 CMake 的支持已被删除，等待更好地支持 C++11 和 libuv 端口。请参阅`CMake 问题 17137`_。使用 CMake 3.9 或更低版本来支持 HP-UX。

其他变化

  • 在 FreeBSD 上，名为“c++”的 C++ 编译器现在是首选的默认编译器。

  • file(GENERATE) 命令现在解释相对于调用者的当前二进制文件和源目录分别赋予其 OUTPUT 和 INPUT 参数的相对路径。请参阅政策:policy:CMP0070。

  • get_filename_component() PROGRAM 模式语义已被修改为不允许在程序路径中出现未加引号的空格，同时也接受参数。虽然在技术上与旧行为不兼容，但预计在具有正确引用的命令行的典型用例下的行为不会改变。

更新

自 CMake 3.10.0 以来所做的更改包括以下内容。

3.10.1

  • cmake-server(7) codemodel 响应 crossReferences 由 3.10.0 添加的字段由于内存使用过多而被删除。将需要另一种方法来提供回溯信息。

3.10.3

  • CMake 3.10.1 在 GoogleTest 模块中的 gtest_discover_tests 添加了一个 TIMEOUT 选项。该关键字与 TIMEOUT 测试属性冲突，后者是使用命令的 PROPERTIES 关键字设置的常见属性之一，通常会导致合法但意外的行为。在 CMake 3.10.3 中将关键字更改为“DISCOVERY_TIMEOUT”以解决此问题。 gtest_discover_tests() 命令的 TIMEOUT 关键字在 3.10.1 和 3.10.2 中的不明确行为尚未保留。