CMake 3.7 发行说明

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

新功能

平台

• CMake 现在支持 安卓交叉编译 和简单的工具链文件。

• AIX 现在支持 Clang 编译器。

生成器

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

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

• 添加了 Visual Studio 15 2017 生成器。这是实验性的，基于“Visual Studio 2017 RC”，因为这个版本的 VS 还没有发布。

• Visual Studio 生成器 for VS 2010 and above learned to place .natvis source files into VS project files properly.

• 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> 选项。

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

• find_package 命令通过设置两个新变量 CMAKE_FIND_PACKAGE_SORT_ORDER 和 CMAKE_FIND_PACKAGE_SORT_DIRECTION 获得了按 NAME 或 NATURAL 排序兼容库的可能性。

• 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() 命令源文件签名现在支持生成的测试项目中特定于配置的标志（例如:variable:CMAKE_<LANG>_FLAGS_DEBUG）。以前只使用当前工具链的默认此类标志。请参阅政策:policy: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_FL AGS， CMAKE_SHARED_LINKER_FLAGS `, 和 :variable:`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 module 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 模块获得了 API 以“导出”jar 目标以供外部 CMake 项目使用。请参阅``install_jar_exports`` 和``export_jars`` 函数。

C测试

• 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 在 OS X 上获得了 CPack productbuild Generator。

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

• 当存档格式设置为 GNU tar 时， CPack DEB Generator 学会了支持长文件名。请参阅 CPACK_DEBIAN_ARCHIVE_TYPE

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

• CPackIFW 模块 cpack_ifw_configure_component() 和 cpack_ifw_configure_component_group() 命令获得了一个新的 USER_INTERFACES 选项，用于将附加页面列表添加到 IFW 安装程序。

• CPack RPM Generator 学会了按需生成调试信息包。请参阅 CPACK_RPM_DEBUGINFO_PACKAGE 及其每个组件版本。

• CPack RPM Generator 学会了按需生成源 rpm (SRPM) 包。请参阅 CPACK_RPM_PACKAGE_SOURCES、 CPACK_RPM_SOURCE_PKG_BUILD_PARAMS 和 CPACK_RPM_SOURCE_PKG_PACKAGING_INSTALL_PREFIX。

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

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

• CPack WIX Generator 现在支持 CPACK_COMPONENT_<compName>_DISABLED。这可用于取消选择默认安装的组件。

• CPack WIX 生成器 现在支持特征元素的 CPACK_WIX_PATCH_FILE 片段。

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

其他

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

• 添加了一个新的 cmake-server(7) 模式，以通过 JSON 协议向客户端提供有关 CMake 生成的构建系统的语义信息。目前所有的协议都是实验性的，可能会发生变化。

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

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

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

弃用和删除的功能

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

• Vim 支持文件 cmake-indent.vim、cmake-syntax.vim 和 cmake-help.vim 已被删除，以支持现在从 `vim-cmake-语法`_项目。

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

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

  • MinGW.org mingw32——被 MSYS2 mingw32 和 mingw64 取代

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

其他变化

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

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