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