LINK_LIBRARY_OVERRIDE

在 3.24 版本加入.

从 LINK_LIBRARY 生成器表达式覆盖与库关联的库功能。这可用于解决因在不同 LINK_LIBRARY 生成器表达式中为同一库指定不同功能而导致的不兼容库功能。

此属性支持覆盖多个库和功能。它需要一个 分号分隔的列表，其中每个列表项具有以下形式

feature[,link-item]*

对于每个以逗号分隔的“link-item”，对于设置此属性的目标，与其关联的任何现有库功能都将被忽略。该项目将改为与指定的“功能”相关联。每个 link-item 都可以是在 LINK_LIBRARY` 生成器表达式中被接受为 library-list 一部分的任何东西。

add_library(lib1 ...)
add_library(lib2 ...)
add_library(lib3 ...)

target_link_libraries(lib1 PUBLIC "$<LINK_LIBRARY:feature1,external>")
target_link_libraries(lib2 PUBLIC "$<LINK_LIBRARY:feature2,lib1>")
target_link_libraries(lib3 PRIVATE lib1 lib2)

# lib1 is associated with both feature2 and no feature. Without any override,
# this would result in a fatal error at generation time for lib3.
# Define an override to resolve the incompatible feature associations.
set_property(TARGET lib3 PROPERTY LINK_LIBRARY_OVERRIDE "feature2,lib1,external")

# lib1 and external will now be associated with feature2 instead when linking lib3

也可以使用预定义的 DEFAULT 库功能覆盖任何功能。这有效地丢弃了该链接项的任何功能，仅针对该目标（本例中为 lib3）：

# When linking lib3, discard any library feature for lib1, and use feature2 for external
set_property(TARGET lib3 PROPERTY LINK_LIBRARY_OVERRIDE
  "DEFAULT,lib1"
  "feature2,external"
)

上面的示例还演示了如何为不同的链接项指定不同的功能覆盖。请参阅 LINK_LIBRARY_OVERRIDE_<LIBRARY> 目标属性，了解覆盖单个库的库功能的替代方法，这在某些情况下可能更简单。如果定义了两个属性并为同一链接项指定了覆盖，LINK_LIBRARY_OVERRIDE_<LIBRARY>` 优先于 LINK_LIBRARY_OVERRIDE。

LINK_LIBRARY_OVERRIDE 的内容可以使用 generator expressions。

有关库功能的更多信息，请参阅 CMAKE_<LANG>_LINK_LIBRARY_USING_<FEATURE> 和 CMAKE_LINK_LIBRARY_USING_<FEATURE> 变量。