CMP0171

在版本 3.31 中添加。

codegen 是一个保留的目标名称。

CMake 3.30 及更早版本未将 codegen 保留为内置目标名称,允许项目自由创建具有该名称的目标。CMake 3.31 及更高版本倾向于将 codegen 保留为内置目标名称,以驱动使用 add_custom_command()CODEGEN 选项创建的自定义命令。为了支持在脚本化环境中构建 codegen 目标,例如 cmake --build . --target codegen,即使没有自定义命令使用 CODEGEN 选项,也需要生成 codegen 目标。此策略为尚未更新以避免创建名为 codegen 的目标的项目提供了兼容性。

此策略的 OLD 行为允许项目创建名为 codegen 的目标。如果创建了名为 codegen 的目标,NEW 行为将以致命错误终止。

此策略在 CMake 3.31 版本中引入。它可以通过 cmake_policy()cmake_minimum_required() 设置。如果未设置,CMake 将发出警告并使用 OLD 行为。

注意

策略的 OLD 行为已根据定义弃用,并可能在 CMake 的未来版本中删除。