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> 来设置单个策略。