CMake 3.7 发行说明

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

新特性

平台

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

• Clang 编译器现在在 AIX 上受支持。

生成器

• Ninja 生成器学会了在使用具有必要功能的 ninja 工具时有条件地支持 Fortran。 有关详细信息，请参阅生成器文档。

• Ninja 生成器学会了生成 sub/dir/{test,install,package} 形式的虚假目标，以驱动子目录安装、测试或打包目标的构建。 这等效于使用 Makefile 生成器 的 cd sub/dir; make {test,install,package}。

• Visual Studio 15 2017 生成器已添加。 这是实验性的，并且基于 “Visual Studio 2017 RC”，因为此版本的 VS 尚未发布。

• 用于 VS 2010 及更高版本的 Visual Studio 生成器 学会了正确地将 .natvis 源文件放入 VS 项目文件中。

• Xcode 生成器的基本 Swift 语言支持学会了遵守新的 CMAKE_Swift_LANGUAGE_VERSION 变量，以告知 Xcode 源代码使用的 Swift 版本。

• CodeLite 生成器获得了一个新的 CMAKE_CODELITE_USE_TARGETS 选项，用于将项目创建从项目更改为目标。

命令

• add_custom_command() 命令获得了一个新的 DEPFILE 选项，该选项与 Ninja 生成器一起使用，以向构建工具提供隐式依赖关系信息。

• cmake_parse_arguments() 命令获得了一个新的 PARSE_ARGV 模式，用于直接从 function() 主体内的 ARGC 和 ARGV# 变量读取参数。

• export() 命令获得了一个 ANDROID_MK 选项，用于生成 Android.mk 文件，该文件将 CMake 构建的库作为 Android NDK 构建系统的预构建库进行引用。

• file(DOWNLOAD) 和 file(UPLOAD) 命令获得了 HTTPHEADER <HTTP-header> 和 USERPWD <username>:<password> 选项。

• find_library() 和 find_package() 命令学会了在构建目标为 32 位架构时在 lib32/ 目录中搜索。 请参阅 FIND_LIBRARY_USE_LIB32_PATHS 全局属性。

• find_package() 命令获得了按 NAME 或按 NATURAL 排序兼容库的可能性，方法是设置两个新变量 CMAKE_FIND_PACKAGE_SORT_ORDER 和 CMAKE_FIND_PACKAGE_SORT_DIRECTION。

• if() 命令获得了新的布尔比较运算 LESS_EQUAL、GREATER_EQUAL、STRLESS_EQUAL、STRGREATER_EQUAL、VERSION_LESS_EQUAL 和 VERSION_GREATER_EQUAL。

• install() 命令获得了一个 EXPORT_ANDROID_MK 子命令，用于安装 Android.mk 文件，该文件将已安装的库作为 Android NDK 构建系统的预构建库进行引用。

• string(TIMESTAMP) 和 file(TIMESTAMP) 命令获得了对 %a 和 %b 占位符的支持。 这些是工作日和月份名称的缩写。

• try_compile() 命令源文件签名现在遵守配置特定的标志（例如 CMAKE_<LANG>_FLAGS_DEBUG），在生成的测试项目中。 以前仅使用当前工具链的默认此类标志。 请参阅策略 CMP0066。

变量

• 添加了变量 CMAKE_FIND_PACKAGE_SORT_ORDER 以控制 find_package() 命令的排序模式。

• 添加了变量 CMAKE_FIND_PACKAGE_SORT_DIRECTION 以控制 find_package() 命令的排序方向。

• 工具链 文件 现在可以设置 CMAKE_<LANG>_FLAGS_INIT 变量，以在首次在构建树中启用语言时初始化 CMAKE_<LANG>_FLAGS 缓存条目。

• 工具链 文件 现在可以设置 CMAKE_EXE_LINKER_FLAGS_INIT、CMAKE_SHARED_LINKER_FLAGS_INIT 和 CMAKE_MODULE_LINKER_FLAGS_INIT 变量，以在首次在构建树中启用语言时初始化 CMAKE_EXE_LINKER_FLAGS、CMAKE_SHARED_LINKER_FLAGS 和 CMAKE_MODULE_LINKER_FLAGS 缓存条目。

属性

• 在 Apple 平台上，BUNDLE_EXTENSION 目标属性现在也适用于框架和应用程序包。

• 添加了 BINARY_DIR 目录属性，以获取与读取属性的源目录对应的二进制目录的绝对路径。

• 添加了 BUILDSYSTEM_TARGETS 目录属性，以获取项目在目录中添加的逻辑构建系统目标名称的列表。

• 引入了 LINK_WHAT_YOU_USE 目标属性和支持的 CMAKE_LINK_WHAT_YOU_USE 变量，以检测（在 UNIX 上）已链接但运行 ldd -r -u 不需要的共享库。

• 添加了 SOURCE_DIR 目录属性，以获取与目录关联的源目录的绝对路径。

• 添加了 SUBDIRECTORIES 目录属性，以获取项目在目录中添加的子目录列表。

• 添加了 VS_SDK_REFERENCES 目标属性，以告知 Visual Studio 生成器 引用命名的 SDK。

• 创建了 VS_TOOL_OVERRIDE 源文件属性，以告知 Visual Studio 生成器 要对源文件使用什么工具。

• WINDOWS_EXPORT_ALL_SYMBOLS 目标属性现在适用于设置了 ENABLE_EXPORTS 属性的可执行目标。

• 添加了 XCODE_FILE_ATTRIBUTES 源文件属性，以告知 Xcode 生成器在文件的 Xcode 项目属性中生成自定义内容。

模块

• 添加了 AndroidTestUtilities 模块，以管理测试数据到 Android 设备的传输。

• CheckFortranSourceCompiles 模块宏 CHECK_Fortran_SOURCE_COMPILES 获得了一个 SRC_EXT 选项，用于指定自定义的测试 Fortran 源文件扩展名。

• ExternalProject 模块获得了 HTTP_USERNAME 和 HTTP_PASSWORD 选项，用于设置 http 下载凭据。

• ExternalProject 模块获得了一个 HTTP_HEADER 选项，用于添加 http 下载标头。

• FindBISON 模块 BISON_TARGET 宏学习了一个新的 REPORT_FILE 选项，用于指定 bison --report-file= 选项。

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

• 引入了 FindICU 模块，以查找 Unicode 国际组件 (ICU) 库和程序。

• FindMatlab 模块学会了查找 SIMULINK 和 MAT 组件。

• FindMatlab 模块 matlab_add_mex() 命令学会了添加可执行文件和模块。

• FindMatlab 模块 matlab_add_unit_test() 命令学会了支持内联 Matlab 测试代码。

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

• FindOpenMP 模块学会了从编译器检测 OpenMP 版本（规范日期）。

• 添加了 FindVulkan 模块。

• GenerateExportHeader 模块学习了一个新的 CUSTOM_CONTENT_FROM_VARIABLE 选项，用于指定包含自定义内容的变量，以包含在生成的标头中。

• GNUInstallDirs 模块获得了一个新的 GNUInstallDirs_get_absolute_install_dir() 命令。

• UseJava 模块获得了用于 “导出” jar 目标以供外部 CMake 项目使用的 API。 请参阅 install_jar_exports 和 export_jars 函数。

CTest

• CTest 现在通过新的 FIXTURES_SETUP、FIXTURES_CLEANUP 和 FIXTURES_REQUIRED 测试属性支持测试装置。 当使用正则表达式或 --rerun-failed 限制要运行的测试时，如果任何测试需要该装置，则装置的设置和清理测试将自动添加到执行集中。

• ctest_configure()、ctest_build()、ctest_test()、ctest_coverage() 和 ctest_upload() 命令获得了一个新的 CAPTURE_CMAKE_ERROR 选项，用于捕获命令运行时发生的任何错误，并避免影响 ctest(1) 进程的返回代码。

CPack

• CPack 在 OS X 上获得了 CPack productbuild 生成器。

• CPack 获得了一个新的 CPACK_PACKAGE_CHECKSUM 变量，以启用为每个软件包文件生成校验和文件。

• CPack DEB 生成器 学会了在存档格式设置为 GNU tar 时支持长文件名。 请参阅 CPACK_DEBIAN_ARCHIVE_TYPE

• CPackIFW 模块获得了一个新的 cpack_ifw_add_package_resources() 命令，以在安装程序二进制文件中包含其他资源。

• The CPackIFW 模块 cpack_ifw_configure_component() 和 cpack_ifw_configure_component_group() 命令新增了一个 USER_INTERFACES 选项，用于向 IFW 安装程序添加额外的页面列表。

• The CPack RPM Generator 学会了按需生成 debuginfo 包。请参阅 CPACK_RPM_DEBUGINFO_PACKAGE 及其每个组件的版本。

• The CPack RPM Generator 学会了按需生成 source rpm (SRPM) 包。请参阅 CPACK_RPM_PACKAGE_SOURCES, CPACK_RPM_SOURCE_PKG_BUILD_PARAMS and CPACK_RPM_SOURCE_PKG_PACKAGING_INSTALL_PREFIX。

• The CPack NSIS Generator 现在支持 CPACK_NSIS_<compName>_INSTALL_DIRECTORY。这可以用于设置组件特定的安装目录。

• The CPack WIX Generator 现在支持 CPACK_WIX_SKIP_PROGRAM_FOLDER，以允许在 ProgramFiles 文件夹之外指定自定义的绝对安装前缀。

• The CPack WIX Generator 现在支持 CPACK_COMPONENT_<compName>_DISABLED。这可以用于取消默认安装某个组件。

• The CPack WIX Generator 现在支持用于 Feature 元素的 CPACK_WIX_PATCH_FILE 片段。

• The CPack WIX Generator 现在支持 CPACK_WIX_ROOT_FEATURE_TITLE 和 CPACK_WIX_ROOT_FEATURE_DESCRIPTION，以允许为根 feature 元素指定自定义的标题和描述。

Other

• cmake(1) 新增了一个 -E capabilities 选项，用于提供 cmake 工具功能（可用生成器等）的机器可读（JSON）描述。

• A new cmake-server(7) 模式被添加，用于通过 JSON 协议向客户端提供关于 CMake 生成的构建系统的语义信息。目前，所有协议都处于实验阶段，可能会发生更改。

• The cmake(1) 命令新增了一个 --trace-source=<file> 选项。

• ccmake(1) 学会了支持类似 vim 的导航绑定。

• cmake-gui(1) 新增了一个按钮，用于打开 Visual Studio Generators 和 Xcode 生成器生成的项目文件。

Deprecated and Removed Features

• 对于新版本的 CMake，我们不再提供从 cmake.org 下载的 Linux i386 二进制文件。

• Vim 支持文件 cmake-indent.vim, cmake-syntax.vim, 和 cmake-help.vim 已被移除，取而代之的是现在由 vim-cmake-syntax 项目提供的文件。

• 放弃了使用某些编译器构建 CMake 本身的支持

  • Visual Studio 7.1 和 2005 -- 已被 VS 2008 及更高版本取代

  • MinGW.org mingw32 -- 已被 MSYS2 mingw32 和 mingw64 取代

  CMake 仍然支持使用这些编译器为其他项目生成构建系统。

Other Changes

• Fortran 依赖扫描器学会了支持 Fortran 子模块的语法。

• 来自 vim-cmake-syntax 项目的 Vim 支持文件 indent/cmake.vim 和 syntax/cmake.vim 现在随 CMake 一起分发。