CMAKE_POLICY_VERSION_MINIMUM

4.0 版本新增。

在不修改项目对 cmake_minimum_required(VERSION)cmake_policy(VERSION) 的调用情况下的情况下,指定项目的最低 策略版本

项目不应在 CMake 代码中设置此变量来设置其自身的策略版本。请为此使用 cmake_minimum_required(VERSION) 和/或 cmake_policy(VERSION)。此变量用于外部设置项目本身尚未更新的策略。

  • 运行 CMake 的用户可以在缓存中设置此变量,例如 -DCMAKE_POLICY_VERSION_MINIMUM=3.5,以尝试配置一个尚未自行设置至少该策略版本的项目。

    或者,用户可以设置 CMAKE_POLICY_VERSION_MINIMUM 环境变量,以便在新构建树中自动初始化缓存条目。

  • 项目可以在调用 add_subdirectory() 来添加第三方项目之前设置此变量,以便在不修改第三方代码的情况下设置其策略版本。

请参阅 CMAKE_POLICY_DEFAULT_CMP<NNNN> 来设置单个策略。