导航

  • 索引
  • 下一页 |
  • 上一页 |
  • CMake 4.1.0 »
  • 文档 »
  • cmake-properties(7) »
  • LINK_LIBRARIES_ONLY_TARGETS

LINK_LIBRARIES_ONLY_TARGETS¶

在版本 3.23 中添加。

强制要求可作为目标名称的链接项必须是实际存在的链接目标。

将此属性设置为 true 可对 LINK_LIBRARIES 和 INTERFACE_LINK_LIBRARIES 目标属性的内容启用额外的检查,这些属性通常由 target_link_libraries() 填充。检查也适用于通过其依赖项的 INTERFACE_LINK_LIBRARIES_DIRECT 属性添加到目标的库。CMake 将验证可能是目标名称的链接项是否确实命名了现有的目标。一个项被认为是可能的链接目标名称,如果:

  • 它不包含 / 或 \,且

  • 它不以 - 开头,且

  • (出于历史原因)它不以 $ 或 ` 开头。

此属性在创建非导入目标时,由 CMAKE_LINK_LIBRARIES_ONLY_TARGETS 变量的值初始化。此属性可以显式地在导入目标上启用,以检查其链接接口。

在以下示例中,CMake 将在配置时因 miLib 不是一个目标而停止并报错

set(CMAKE_LINK_LIBRARIES_ONLY_TARGETS ON)
add_library(myLib STATIC myLib.c)
add_executable(myExe myExe.c)
target_link_libraries(myExe PRIVATE miLib) # typo for myLib

为了通过名称链接工具链提供的库,同时仍强制执行 LINK_LIBRARIES_ONLY_TARGETS,请使用带有 IMPORTED_LIBNAME 目标属性的 导入的 接口库

add_library(toolchain::m INTERFACE IMPORTED)
set_property(TARGET toolchain::m PROPERTY IMPORTED_LIBNAME "m")
target_link_libraries(myExe PRIVATE toolchain::m)

另请参见策略 CMP0028。

注意

如果 INTERFACE_LINK_LIBRARIES 包含生成器表达式,其链接项的实际列表可能取决于使用目标的类型和属性。在这种情况下,CMake 可能无法总是检测到仅针对特定使用者出现的缺失目标名称。未来具有改进启发式的 CMake 版本可能会开始对先前版本的 CMake 接受的项目触发错误。

上一主题

LINK_LIBRARIES

下一主题

LINK_LIBRARIES_STRATEGY

本页

  • 显示源

快速搜索

导航

  • 索引
  • 下一页 |
  • 上一页 |
  • CMake 4.1.0 »
  • 文档 »
  • cmake-properties(7) »
  • LINK_LIBRARIES_ONLY_TARGETS
© 版权所有 2000-2025 Kitware, Inc. 和贡献者。使用 Sphinx 8.1.3 创建。