CMP0112

添加于版本 3.19。

目标文件组件生成器表达式不添加目标依赖项。

以下基于目标的生成器表达式,用于查询目录或文件名组件,不再向评估的目标添加依赖项。

  • TARGET_FILE_NAME

  • TARGET_FILE_DIR

  • TARGET_LINKER_FILE_BASE_NAME

  • TARGET_LINKER_FILE_NAME

  • TARGET_LINKER_FILE_DIR

  • TARGET_SONAME_FILE_NAME

  • TARGET_SONAME_FILE_DIR

  • TARGET_PDB_FILE_NAME

  • TARGET_PDB_FILE_DIR

  • TARGET_BUNDLE_DIR

  • TARGET_BUNDLE_DIR_NAME

  • TARGET_BUNDLE_CONTENT_DIR

在 CMake 3.18 及更低版本中,总是会为上述生成器表达式的评估目标添加依赖项。CMake 3.19 及更高版本倾向于不添加此依赖项。此策略为尚未更新以预期新行为的项目提供兼容性。策略设置记录在每个目标创建时,并决定引用该目标的生成器表达式是否暗示对其的依赖性。

此策略的 OLD 行为是为上述生成器表达式的评估目标添加依赖项。此策略的 NEW 行为是不为上述生成器表达式的评估目标添加依赖项。

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

请参阅 CMAKE_POLICY_WARNING_CMP0112 变量的文档以控制警告。

注意

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