LINK_LIBRARY_OVERRIDE_<LIBRARY>¶
在 3.24 版本中添加。
覆盖与 <LIBRARY>
关联的库特性,该特性来自 LINK_LIBRARY
生成器表达式。这可以用于解决由于在不同的 LINK_LIBRARY
生成器表达式中为 <LIBRARY>
指定不同的特性而导致的不兼容库特性。
当在目标上设置此属性时,它包含一个单一的库特性名称,该名称将在链接该目标时应用于 <LIBRARY>
。
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_lib1 feature2)
# lib1 will now be associated with feature2 instead when linking lib3
也可以使用预定义的 DEFAULT
库特性来覆盖任何特性。这实际上会丢弃该链接项的任何特性,仅针对该目标(本例中的 lib3
)。
# When linking lib3, discard any library feature for lib1
set_property(TARGET lib3 PROPERTY LINK_LIBRARY_OVERRIDE_lib1 DEFAULT)
有关一次性覆盖多个库特性的另一种方法,请参见 LINK_LIBRARY_OVERRIDE
目标属性。如果这两个属性都已定义并指定了相同链接项的覆盖,则 LINK_LIBRARY_OVERRIDE_<LIBRARY>
优先于 LINK_LIBRARY_OVERRIDE
。
LINK_LIBRARY_OVERRIDE_<LIBRARY>
的内容可以使用 生成器表达式
。
有关库特性的更多信息,请参阅 CMAKE_<LANG>_LINK_LIBRARY_USING_<FEATURE>
和 CMAKE_LINK_LIBRARY_USING_<FEATURE>
变量。