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> 以设置各个策略。