Navigation

  • index
  • next |
  • previous |
  • CMake »
  • 3.24.0-rc1 Documentation »
  • cmake-properties(7) »
  • LINK_LIBRARY_OVERRIDE_<LIBRARY>

LINK_LIBRARY_OVERRIDE_<LIBRARY>ΒΆ

New in version 3.24.

To resolve incompatible features introduced by LINK_LIBRARY generator expression, this property offers the possibility to override, for a link-item (CMake target or external library) involved in the link step, any defined features with a new one.

This property takes a feature name which will be applied to the link-item specified by <LIBRARY> suffix property. For example:

add_library(lib1 ...)
target_link_libraries(lib1 PUBLIC "$<LINK_LIBRARY:feature1,external>")

add_library(lib2 ...)
target_link_libraries(lib2 PUBLIC "$<LINK_LIBRARY:feature2,lib1>")

add_library(lib3 ...)
target_link_libraries(lib3 PRIVATE lib1 lib2)
# Here, lib1 has two different features which prevents to link lib3
# So, define LINK_LIBRARY_OVERRIDE_lib1 property to ensure correct link
set_property(TARGET lib3 PROPERTY LINK_LIBRARY_OVERRIDE_lib1 feature2)
# The lib1 will be used with feature2 to link lib3

It is also possible to override any feature with the pre-defined feature DEFAULT to get the standard behavior (i.e. no feature):

set_property(TARGET lib3 PROPERTY LINK_LIBRARY_OVERRIDE_lib1 DEFAULT)
# The lib1 will be used without any feature to link lib3

Contents of LINK_LIBRARY_OVERRIDE_<LIBRARY> may use generator expressions.

This property takes precedence over LINK_LIBRARY_OVERRIDE target property.

For more information about features, see CMAKE_<LANG>_LINK_LIBRARY_USING_<FEATURE> and CMAKE_LINK_LIBRARY_USING_<FEATURE> variables.

Previous topic

LINK_LIBRARY_OVERRIDE

Next topic

LINK_OPTIONS

This Page

  • Show Source

Quick search

Navigation

  • index
  • next |
  • previous |
  • CMake »
  • 3.24.0-rc1 Documentation »
  • cmake-properties(7) »
  • LINK_LIBRARY_OVERRIDE_<LIBRARY>
© Copyright 2000-2022 Kitware, Inc. and Contributors. Created using Sphinx 4.4.0.