cmake-policies(7)¶

简介 ¶

CMake 策略引入行为变更，同时为现有项目版本保留兼容性。策略是弃用机制，而不是功能开关。每项策略都记录了已弃用的 OLD 行为和首选的 NEW 行为。项目必须随着时间的推移进行更新以使用 NEW 行为，但其现有版本将继续使用 OLD 行为。

当 CMake 版本新引入策略时，该版本及更高版本会立即弃用其 OLD 行为。项目应尽快更新以使用策略的 NEW 行为。

使用 cmake_minimum_required() 命令来记录项目已更新到的最新 CMake 版本。例如

cmake_minimum_required(VERSION 3.10...3.31)

这使用 <min>...<max> 语法来启用 CMake 3.31 及更早版本中引入的策略的 NEW 行为，同时仅要求最低 CMake 版本为 3.10。该项目预计可与这些版本之间引入的策略的 OLD 和 NEW 行为一起使用。

为了帮助项目按照自己的计划移植到策略的 NEW 行为，CMake 提供了过渡期

如果项目未设置策略，CMake 将使用其 OLD 行为，但可能会警告该策略尚未设置。
- 运行 CMake 的用户可以通过在 cmake(1) 命令行上将 CMAKE_POLICY_DEFAULT_CMP<NNNN> 变量设置为缓存条目来消除警告，而无需修改项目
```
cmake -DCMAKE_POLICY_DEFAULT_CMP0990=OLD ...
```
- 项目可以通过使用 cmake_policy() 命令显式地将策略设置为 OLD 或 NEW 行为来消除警告
```
if(POLICY CMP0990)
  cmake_policy(SET CMP0990 NEW)
endif()
```
  注意
  
  策略几乎永远不应设置为 OLD，除非是为了在其他方面冻结或稳定的代码库中消除警告，或暂时作为更大迁移路径的一部分。
如果项目将策略设置为 OLD，则在引入策略的版本之后至少 2 年发布的 CMake 版本可能会发出警告，提示策略的 OLD 行为将从未来的 CMake 版本中删除。
如果项目未将策略设置为 NEW，则在引入策略的版本之后至少 6 年发布的 CMake 版本，且其主版本号更高，可能会发出错误，提示策略的 OLD 行为已被删除。