CMP0048

project() 命令管理 VERSION 变量。

CMake 3.0 版引入了 project() 命令的 VERSION 选项来指定项目版本和名称。为了保持 PROJECT_VERSION 和相关变量与变量 PROJECT_NAME 一致，当没有 VERSION 给 :command 时，有必要将 VERSION 变量设置为空字符串：项目。但是，这可能会改变现有项目的行为，这些项目本身设置了 VERSION 变量，因为 project() 现在可以清除它们。此策略控制与此类项目兼容的行为。

此策略的“旧”行为是保持“VERSION”变量不变。此策略的“新”行为是设置“版本”，如 :command:“项目”命令所记录。

此策略是在 CMake 3.0 版中引入的。 CMake 版本 |发布|当未设置策略并使用“旧”行为时发出警告。使用 cmake_policy() 命令将其显式设置为 OLD 或 NEW。

备注

策略的“旧”行为是 :manual:根据定义 <cmake-policies(7)> 已弃用，并且可能会在未来版本的 CMake 中删除。