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 的未来版本中删除。