cmake 政策(7)

介绍

CMake 中的策略用于跨多个版本保留向后兼容的行为。当引入新策略时，较新的 CMake 版本将开始警告有关向后兼容的行为。可以通过使用 cmake_policy() 命令明确请求旧的或向后兼容的行为来禁用警告。也可以为策略请求“NEW”或非向后兼容行为，同时避免警告。每个策略也可以在命令行上使用 CMAKE_POLICY_DEFAULT_CMP<NNNN> 变量显式设置为 NEW 或 OLD 行为。

策略是一种弃用机制，而不是可靠的功能切换。策略几乎不应该设置为“旧”，除非在冻结或稳定的代码库中消除警告，或者暂时作为更大迁移路径的一部分。每个策略的“旧”行为都是不可取的，在未来的版本中将被替换为错误条件。

如果使用太旧版本的 CMake 构建项目，cmake_minimum_required 命令不仅仅会报告错误。它还将在该 CMake 版本或更早版本中引入的所有策略设置为“新”行为。要在不增加所需的最低 CMake 版本的情况下管理策略，可以使用 if(POLICY) 命令：

if(POLICY CMP0990)
  cmake_policy(SET CMP0990 NEW)
endif()

这具有将“NEW”行为与用户可能正在使用的较新 CMake 版本一起使用的效果，并且不会发出兼容性警告。

策略的设置在某些情况下被限制为不传播到父范围。例如，如果 include() 命令或 find_package() 命令读取的文件包含对 cmake_policy() 的使用，默认情况下该策略设置不会影响调用者。这两个命令都接受可选的 NO_POLICY_SCOPE 关键字来控制此行为。

CMAKE_MINIMUM_REQUIRED_VERSION 变量也可用于确定是否报告有关使用已弃用的宏或函数的错误。

CMake 3.26 引入的策略

• CMP0143：默认情况下，USE_FOLDERS 全局属性被视为开启。

CMake 3.25 引入的策略

• CMP0142：Xcode 生成器不会将 per-config 后缀附加到库搜索路径。
• CMP0141：MSVC 调试信息格式标志由抽象选择。
• CMP0140：return() 命令检查其参数。

CMake 3.24 引入的策略

• CMP0139：if() 命令支持使用 PATH_EQUAL 运算符进行路径比较。
• CMP0138：CheckIPOSupported 使用来自调用项目的标志。
• CMP0137：try_compile() 在项目模式下传递平台变量。
• CMP0136：Watcom 运行时库标志由抽象选择。
• CMP0135：对于 URL 下载方法，ExternalProject 默认忽略存档中的时间戳。
• CMP0134：当“TARGET”视图不可用时回退到“HOST”Windows 注册表视图。
• CMP0133：CPack 模块在 CPack DragNDrop 生成器中默认禁用 SLA。
• CMP0132：不要在首次运行时设置编译器环境变量。
• CMP0131：LINK_LIBRARIES 支持 LINK_ONLY 生成器表达式。
• CMP0130：while() 诊断条件评估错误。

CMake 3.23 引入的策略

• CMP0129：MCST LCC 编译器的编译器 ID 现在是 LCC，而不是 GNU。

CMake 3.22 引入的策略

• CMP0128：改进了语言标准和扩展标志的选择。
• CMP0127：cmake_dependent_option() 支持完整的条件语法。

CMake 3.21 引入的策略

• CMP0126：set(CACHE) 不会删除同名的普通变量。
• CMP0125：find_(path|file|library|program) 对高速缓存变量具有一致的行为。
• CMP0124：foreach() 循环变量仅在循环范围内可用。
• CMP0123：必须显式设置 ARMClang cpu/arch 编译和链接标志。
• CMP0122：UseSWIG 使用 csharp 语言的标准库名称约定。
• CMP0121：列表命令检测到无效索引。

CMake 3.20 引入的策略

• CMP0120：WriteCompilerDetectionHeader 模块已移除。
• CMP0119：LANGUAGE 源文件属性显式编译为语言。
• CMP0118：GENERATED 源文件属性现在在所有目录中可见。
• CMP0117：默认情况下，MSVC RTTI 标志 /GR 未添加到 CMAKE_CXX_FLAGS。
• CMP0116：Ninja 生成器从 add_custom_command() 转换 DEPFILE。
• CMP0115：源文件扩展名必须明确。

CMake 3.19 引入的策略

• CMP0114：ExternalProject 步骤目标完全采用其步骤。
• CMP0113：Makefile 生成器不重复来自目标依赖项的自定义命令。
• CMP0112：目标文件组件生成器表达式不添加目标依赖项。
• CMP0111：缺少其位置属性的导入目标在生成过程中失败。
• CMP0110：add_test() 支持测试名称中的任意字符。
• CMP0109：find_program() 需要执行权限而不是读取权限。

CMake 3.18 引入的策略

• CMP0108：目标无法通过别名链接到自身。
• CMP0107：ALIAS 目标无法覆盖另一个目标。
• CMP0106：文档模块已删除。
• CMP0105：设备链接步骤使用链接选项。
• CMP0104：现在为 NVCC 检测到 CMAKE_CUDA_ARCHITECTURES，不允许为空 CUDA_ARCHITECTURES。
• CMP0103：不允许在没有 APPEND 的情况下使用相同 FILE 的多个 export()。

CMake 3.17 引入的策略

• CMP0102：如果缓存条目不存在，mark_as_advanced() 将不执行任何操作。
• CMP0101：target_compile_options 在所有范围内都遵循 BEFORE 关键字。
• CMP0100：让 AUTOMOC 和 AUTOUIC 处理 .hh 头文件。
• CMP0099：链接属性可通过对静态库的私有依赖进行传递。
• CMP0098：FindFLEX 在执行时在 CMAKE_CURRENT_BINARY_DIR 中运行 flex。

CMake 3.16 引入的策略

• CMP0097：带有 GIT_SUBMODULES“”的 ExternalProject_Add 未初始化任何子模块。
• CMP0096：project() 保留版本组件中的前导零。
• CMP0095：RPATH 条目已在中间 CMake 安装脚本中正确转义。

CMake 3.15 引入的策略

• CMP0094：FindPython3、FindPython2 和 FindPython 使用 LOCATION 作为查找策略。
• CMP0093：FindBoost 以 x.y.z 格式报告 Boost_VERSION。
• CMP0092：默认情况下，MSVC 警告标志不在 CMAKE_{C,CXX}_FLAGS 中。
• CMP0091：MSVC 运行时库标志由抽象选择。
• CMP0090：export(PACKAGE) 默认不填充包注册表。
• CMP0089：基于 IBM Clang 的 XL 编译器的编译器 ID 现在是 XLClang。

CMake 3.14 引入的策略

• CMP0088：FindBISON 在执行时在 CMAKE_CURRENT_BINARY_DIR 中运行 bison。
• CMP0087：install(SCRIPT | CODE) 支持生成器表达式。
• CMP0086：UseSWIG 通过 -module 标志支持 SWIG_MODULE_NAME。
• CMP0085：IN_LIST 生成器表达式处理空列表项。
• CMP0084：FindQt 模块对于 find_package() 不存在。
• CMP0083：链接可执行文件时添加 PIE 选项。
• CMP0082：来自 add_subdirectory() 的安装规则与调用者中的规则交错。

CMake 3.13 引入的策略

• CMP0081：LINK_DIRECTORIES 目标属性中不允许使用相对路径。
• CMP0080：无法在配置时包含 BundleUtilities。
• CMP0079：target_link_libraries 允许与其他目录中的目标一起使用。
• CMP0078：UseSWIG 生成标准目标名称。
• CMP0077：option() 支持普通变量。
• CMP0076：target_sources() 命令将相对路径转换为绝对路径。

CMake 3.12 引入的策略

• CMP0075：包含文件检查宏以支持 CMAKE_REQUIRED_LIBRARIES。
• CMP0074：find_package 使用 PackageName_ROOT 变量。
• CMP0073：不生成遗留 _LIB_DEPENDS 缓存条目。

CMake 3.11 引入的策略

• CMP0072：FindOpenGL 在可用时默认首选 GLVND。

CMake 3.10 引入的策略

• CMP0071：让 AUTOMOC 和 AUTOUIC 处理生成的文件。
• CMP0070：为相对路径定义文件 (GENERATE) 行为。

CMake 3.9 引入的策略

• CMP0069：启用时强制执行 INTERPROCEDURAL_OPTIMIZATION。
• CMP0068：macOS 上的 RPATH 设置不影响 install_name。

CMake 3.8 引入的策略

• CMP0067：遵守 try_compile() 源文件签名中的语言标准。

CMake 3.7 引入的策略

• CMP0066：尊重 try_compile() 源文件签名中的每个配置标志。

CMake 3.4 引入的策略

• CMP0065：不要添加标志以从没有 ENABLE_EXPORTS 目标属性的可执行文件中导出符号。
• CMP0064：支持新的 TEST if() 运算符。

CMake 3.3 引入的策略

• CMP0063：尊重所有目标类型的可见性属性。
• CMP0062：禁止 export() 结果的 install()。
• CMP0061：默认情况下，CTest 不会告诉 make 忽略错误 (-i)。
• CMP0060：即使在隐式目录中也按完整路径链接库。
• CMP0059：不要将 DEFINITIONS 视为内置目录属性。
• CMP0058：Ninja 要求自定义命令副产品是显式的。
• CMP0057：支持新的 IN_LIST if() 运算符。

CMake 3.2 引入的策略

• CMP0056：尊重 try_compile() 源文件签名中的链接标志。
• CMP0055：严格检查 break() 命令。

CMake 3.1 引入的策略

• CMP0054：仅在未加引号时将 if() 参数解释为变量或关键字。
• CMP0053：简化变量引用和转义序列评估。
• CMP0052：拒绝安装的 INTERFACE_INCLUDE_DIRECTORIES 中的源和构建目录。
• CMP0051：在 SOURCES 目标属性中列出 TARGET_OBJECTS。

CMake 3.0 引入的策略

• CMP0050：不允许 add_custom_command SOURCE 签名。
• CMP0049：不要扩展目标源条目中的变量。
• CMP0048：project() 命令管理 VERSION 变量。
• CMP0047：将 QCC 编译器 ID 用于 QNX 上的 qcc 驱动程序。
• CMP0046：add_dependencies 中不存在的依赖项出错。
• CMP0045：get_target_property 中不存在的目标出错。
• CMP0044：区分大小写的 Lang_COMPILER_ID 生成器表达式。
• CMP0043：忽略 COMPILE_DEFINITIONS_Config 属性。
• CMP0042：默认启用 MACOSX_RPATH。
• CMP0041：生成器表达式的相关包含错误。
• CMP0040：add_custom_command() 的 TARGET 签名中的目标必须存在。
• CMP0039：实用程序目标可能没有链接依赖性。
• CMP0038：目标不能直接链接到它们自己。
• CMP0037：目标名称不应保留且应与有效性模式相匹配。
• CMP0036：不应调用 build_name 命令。
• CMP0035：不应调用 variable_requires 命令。
• CMP0034：不应调用 utility_source 命令。
• CMP0033：不应调用 export_library_dependencies 命令。
• CMP0032：不应调用 output_required_files 命令。
• CMP0031：不应调用 load_command 命令。
• CMP0030：不应调用 use_mangled_mesa 命令。
• CMP0029：不应调用 subdir_depends 命令。
• CMP0028：目标名称中的双冒号表示 ALIAS 或 IMPORTED 目标。
• CMP0027：有条件地链接导入的目标，但缺少包含目录。
• CMP0026：不允许使用 LOCATION 目标属性。
• CMP0025：Apple Clang 的编译器 ID 现在是 AppleClang。
• CMP0024：不允许包含导出结果。

CMake 2.8 引入的策略

• CMP0023：普通签名和关键字 target_link_libraries 签名不能混合。
• CMP0022：INTERFACE_LINK_LIBRARIES 定义链接接口。
• CMP0021：INCLUDE_DIRECTORIES 目标属性中的相对路径发生致命错误。
• CMP0020：自动将 Qt 可执行文件链接到 Windows 上的 qtmain 目标。
• CMP0019：不要重新扩展包含和链接信息中的变量。
• CMP0018：忽略 CMAKE_SHARED_LIBRARY_Lang_FLAGS 变量。
• CMP0017：从那里包含时，首选 CMake 模块目录中的文件。
• CMP0016：如果 target_link_libraries() 的唯一参数不是目标，则报告错误。
• CMP0015：link_directories() 处理相对于源目录的路径。
• CMP0014：输入目录必须有 CMakeLists.txt。
• CMP0013：不允许重复的二进制目录。
• CMP0012：if() 识别数字和布尔常量。

CMake 2.6 引入的策略

• CMP0011：包含的脚本执行自动 cmake_policy PUSH 和 POP。
• CMP0010：错误的变量引用语法是一个错误。
• CMP0009：默认情况下，FILE GLOB_RECURSE 调用不应遵循符号链接。
• CMP0008：通过完整路径链接的库必须具有有效的库文件名。
• CMP0007：列表命令不再忽略空元素。
• CMP0006：安装 MACOSX_BUNDLE 目标需要 BUNDLE DESTINATION。
• CMP0005：预处理器定义值现在自动转义。
• CMP0004：链接的库可能没有前导或尾随空格。
• CMP0003：通过完整路径链接的库不再生成链接器搜索路径。
• CMP0002：逻辑目标名称必须全局唯一。
• CMP0001：不应再使用 CMAKE_BACKWARDS_COMPATIBILITY。
• CMP0000：必须指定所需的最低 CMake 版本。