CMake 3.9 发行说明

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

新功能

语言

• 对于 VS 2010 及以上版本的 Visual Studio 生成器，现在支持 CUDA。这补充了 Makefile 生成器 和 Ninja 生成器现有的支持。建议使用 CUDA 8.0.61 或更高版本，因为早期版本中存在 VS 集成的已知错误。

• CMake 现在了解以下 编译器 ID 的 C++ 标准 和 C 标准 及其关联的元特征：Cray、PGI 和 XL。

生成器

• 对于 VS 2010 及以上版本的 Visual Studio 生成器，当安装了 nasm 时，可以支持 ASM_NASM 语言。

• Xcode 生成器已学会创建 Xcode 模式文件。这是一个实验性功能，可以通过将 CMAKE_XCODE_GENERATE_SCHEME 变量设置为 TRUE 值来激活。

命令

• add_library() 命令的 IMPORTED 选项已学会支持 对象库。

• find_library() 命令已学会当构建目标是 x32 ABI 时搜索 libx32 路径。请参阅 FIND_LIBRARY_USE_LIBX32_PATHS 全局属性。

• include_external_msproject() 命令已学会使用 MAP_IMPORTED_CONFIG_<CONFIG> 目标属性将当前配置映射到外部配置。

• install(TARGETS) 命令获得了一个新的 OBJECTS 选项，用于指定安装 对象库 的位置。

• install(EXPORT) 命令已学会如何导出 对象库。

• project() 命令获得了一个可选的 DESCRIPTION 参数，用于设置 PROJECT_DESCRIPTION 变量。

• separate_arguments() 命令增加了一个 NATIVE_COMMAND 模式，该模式根据主机操作系统执行参数分隔。

变量

• 添加了一个 CMAKE_ANDROID_NDK_DEPRECATED_HEADERS 变量，用于在 使用 NDK 交叉编译 Android 时，即使存在统一的头文件，也请求使用已弃用的头文件。默认情况下，如果可用，现在将使用统一的头文件。

• 引入了一个 CMAKE_AUTOMOC_DEPEND_FILTERS 变量，允许 CMAKE_AUTOMOC 从源文件内容中提取额外的 moc 依赖文件名称。

• 引入了一个 CMAKE_AUTOUIC_SEARCH_PATHS 变量，允许 CMAKE_AUTOUIC 在 ui_foo.h 附近比其他地方搜索 foo.ui。

• 添加了一个 CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX 变量，用于在每个通常会搜索的 lib 目录之前，指示 find_library() 命令搜索 lib<suffix> 目录。

• 添加了一个 CMAKE_INTERPROCEDURAL_OPTIMIZATION 变量，用于初始化所有目标的 INTERPROCEDURAL_OPTIMIZATION 属性。

• 添加了一个 CMAKE_<LANG>_COMPILER_AR 变量，用于保存 GCC/Clang ar 包装器的路径。

• 添加了一个 CMAKE_<LANG>_COMPILER_RANLIB 变量，用于保存 GCC/Clang ranlib 包装器的路径。

• 添加了 CMAKE_SYSROOT_COMPILE 和 CMAKE_SYSROOT_LINK 变量，以便为编译和链接使用单独的 sysroots。

属性

• 引入了一个新的 AUTOGEN_BUILD_DIR 目标属性，用于为 AUTOMOC、AUTOUIC 和 AUTORCC 设置自定义输出目录。

• 引入了一个新的 AUTOMOC_DEPEND_FILTERS 目标属性，允许 AUTOMOC 从源文件内容中提取额外的 moc 依赖文件名称。

• 引入了一个新的 AUTOUIC_SEARCH_PATHS 目标属性，允许 AUTOUIC 在 ui_foo.h 附近比其他地方搜索 foo.ui。

• 引入了全局属性 AUTOGEN_SOURCE_GROUP、AUTOMOC_SOURCE_GROUP 和 AUTORCC_SOURCE_GROUP，以允许由 AUTOMOC 或 AUTORCC 生成的文件放置在 source_group() 中。

• 添加了 BUILD_WITH_INSTALL_NAME_DIR 目标属性和对应的 CMAKE_BUILD_WITH_INSTALL_NAME_DIR 变量，以控制是否在构建树中使用二进制文件的 INSTALL_NAME_DIR 目标属性值。这适用于 macOS 的 install_name，就像 BUILD_WITH_INSTALL_RPATH 适用于 RPATH 一样。

• 向 对象库 添加了 CUDA_PTX_COMPILATION 目标属性，以支持编译为 .ptx 文件而不是主机对象文件。

• 添加了一个全局属性 GENERATOR_IS_MULTI_CONFIG，用于确定当前生成器是否是多配置生成器（例如 Visual Studio 生成器 或 Xcode）。

• 现在会强制执行 INTERPROCEDURAL_OPTIMIZATION 目标属性。CMake 将无条件地添加 IPO 标志，或者在不知道当前编译器的标志时产生错误。项目现在负责在启用目标属性之前使用 CheckIPOSupported 模块来检查 IPO 支持。请参阅策略 CMP0069。

• WINDOWS_EXPORT_ALL_SYMBOLS 目标属性现在可以与显式的 .def 文件结合使用，以从目标内的对象文件中导出所有符号，加上链接器在依赖项（例如 msvcrt.lib）中找到的显式符号列表。

模块

• 添加了 CheckIPOSupported 模块，以帮助项目检查当前工具链和 CMake 版本是否支持过程间优化 (IPO)。

• CMakeFindDependencyMacro 模块的 find_dependency 宏现在会将所有参数转发给底层的 find_package() 调用。现有用法将继续按原样运行，但调用者现在可以访问 find_package() 接受的完整参数集。

• FeatureSummary 模块的 feature_summary() 命令现在接受新的 DEFAULT_DESCRIPTION 选项，该选项将打印所选包类型的默认标题。

• FeatureSummary 模块增加了一个新的 FeatureSummary_<TYPE>_DESCRIPTION 变量，该变量可以为每个 <TYPE> 定义，以便在模块的输出字符串中使用包类型时，将其替换为指定的字符串。

• FindDoxygen 模块学会了使用 CMake 变量控制 Doxygen 的行为，并通过新添加的 doxygen_add_docs() 命令生成文档。Doxygen 输入文件 (Doxyfile) 会自动生成，并且 doxygen 作为自定义目标的一部分运行。可以指定附加组件来查找可选工具：dot、mscgen 和 dia。

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

• FindProtobuf 模块的 protobuf_generate_cpp() 命令获得了一个 EXPORT_MACRO 选项，用于指定 DLL 导出标记宏的名称。

• FindProtobuf 模块现在通过新的 Protobuf_USE_STATIC_LIBS 输入变量支持在 Unix 上使用静态库。

• FindProtobuf 模块在找到库时现在提供导入的目标。

• 添加了一个新的 GoogleTest 模块，用于提供 gtest_add_tests() 函数，该函数独立于 FindGTest 模块。该函数还更新以支持关键字参数，功能已扩展，允许指定测试名称前缀和后缀，使对源文件的依赖成为可选，并将发现的测试用例列表返回给调用者。

CTest

• ctest_submit() 命令获得了 HTTPHEADER 选项，用于指定提交期间要发送的自定义标头。

• ctest(1) 可执行文件获得了新选项，允许开发人员禁用自动添加测试以满足 fixture 依赖。 -FS 可阻止添加与提供的正则表达式匹配的 fixture 的设置测试，-FC 可阻止添加匹配 fixture 的清理测试，-FA 可阻止为匹配 fixture 添加任何测试。

• 添加了一个 DISABLED 测试属性，用于标记已配置但显式禁用的测试，以便它们不运行。

CPack

• CPack Archive Generator 已学会按组件修改文件名。请参阅 CPACK_ARCHIVE_FILE_NAME 变量及其按组件的版本 CPACK_ARCHIVE_<component>_FILE_NAME。

• CPackComponent 模块的 cpack_add_component() 命令获得了一个新的 PLIST <filename> 选项，用于在使用 productbuild 生成器时指定 pkgbuild 的 --component-plist 参数。

• CPackIFW 模块的 cpack_ifw_configure_component() 和 cpack_ifw_configure_component_group() 命令获得了对 DISPLAY_NAME 和 DESCRIPTION 选项的国际化支持。

• CPack IFW Generator 学习了新的提示 CPACK_IFW_ROOT 变量，用于查找安装在非标准位置的 QtIFW 工具套件。

• CPack productbuild Generator 获得了新的 CPACK_PRODUCTBUILD_RESOURCES_DIR 变量，用于指定要复制到 Resources 目录的资源。

• CPack RPM Generator 已学会修改 debuginfo 包名称。请参阅 CPACK_RPM_DEBUGINFO_FILE_NAME 变量。

• CPack WIX Generator 的修补系统现在能够设置附加属性。这可以通过在 Id 属性后指定 CPackWiXFragment XML 标签的属性来完成。请参阅 CPACK_WIX_PATCH_FILE 变量。

• CPack WIX Generator 实现了一个新的 CPACK_WIX_ROOT_FOLDER_ID 变量，该变量允许使用自定义根文件夹 ID 而不是默认的 ProgramFilesFolder / ProgramFiles64Folder。

其他

• 现在支持 GNU 和 Clang 编译器使用链接时优化 (LTO) 标志的过程间优化 (IPO)。请参阅 INTERPROCEDURAL_OPTIMIZATION 目标属性和 CheckIPOSupported 模块。

• TARGET_OBJECTS 生成器表达式 现在受 add_custom_command() 和 file(GENERATE) 命令支持。

• 添加了两个新的信息性生成器表达式来检索 Apple Bundle 目录。第一个 $<TARGET_BUNDLE_DIR:tgt> 输出 Bundle 目录的完整路径，另一个 $<TARGET_BUNDLE_CONTENT_DIR:tgt> 输出 macOS Bundle 和 App Bundle 的 Contents 目录的完整路径。对于所有其他 Bundle 类型和 SDK，它与 $<TARGET_BUNDLE_DIR:tgt> 相同。新的表达式有助于独立于 macOS 和 iOS 上的不同 Bundle 类型和布局查询 Bundle 位置。

已弃用和移除的功能

• 为策略 CMP0036 及以下添加了明确的弃用诊断。 cmake-policies(7) 手册解释了所有策略的 OLD 行为已被弃用，项目应尽快移植到 NEW 行为。

• Visual Studio 8 2005 生成器现已弃用，将在 CMake 的未来版本中移除。

• Visual Studio 7 .NET 2003 生成器已被移除。

• Xcode 生成器已停止对 Xcode 3 以下版本的支持。

• FindDoxygen 模块已弃用多个变量。

• CMake 捆绑的 curl 版本不再接受 Windows 上的 file://c:/... 形式的 URL，因为上游 curl 7.52 进行了更改。请改用 file:///c:/... 形式，以便在所有版本上工作。

其他更改

• 当使用 AUTOMOC 时，CMake 现在会扫描 Q_PLUGIN_METADATA 宏的存在，并在宏的 FILE 参数中的文件更改时重新运行 moc。

• 当 AUTOMOC 检测到类似 #include "moc_<basename>.cpp" 的 include 语句时，现在会在目标 INCLUDE_DIRECTORIES 中搜索相应的头文件。

• 运行测试时，CTest 已学会将跳过的测试（使用 SKIP_RETURN_CODE 属性）与带有新 DISABLED 属性的测试进行相同处理。由于此更改，当所有测试都被跳过或通过时，CTest 不会指示失败。

• Ninja 生成器已放宽对象编译的依赖项。对象编译现在仅依赖于与对象目标所依赖的库关联的自定义目标和自定义命令，不再依赖于库本身。依赖目标中的源文件现在可能在等待其目标的依赖项链接之前进行编译。

• 在 macOS 上，RPATH 设置（如 BUILD_WITH_INSTALL_RPATH）不再影响 install_name 字段。请参阅策略 CMP0068。

• Visual Studio 14 2015 生成器已了解 VS 2015 更新对 v140 工具集的更改。VS 更改了它理解的 GenerateDebugInformation 链接器设置值，该设置会产生 -DEBUG 链接器标志变体。

更新

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

3.9.1

• 由于 <PackageName>_ROOT 变量的新使用引起的回归，CMake 3.9.0 添加的 find_ 命令 PACKAGE_ROOT 搜索路径组已被移除，不再适用于 3.9 系列。该行为将来可能会以更兼容的方式重新引入。

3.9.2

• 在 macOS 上，默认的应用程序捆绑包 Info.plist 文件不再像 3.9.0 和 3.9.1 中那样启用 Hi-DPI 支持。此更改已被撤销，因为它破坏了 iOS 应用程序。

• Xcode 生成器不再像 3.9.0 和 3.9.1 中那样将“outputPaths”添加到自定义脚本构建阶段。添加此项是为了支持 Xcode 9 的新构建系统，但它破坏了旧版和新版 Xcode 构建系统的增量重建。