INTERFACE_LINK_DEPENDS¶
Additional public interface files on which a target binary depends for linking.
This property is supported only by Ninja
and
Makefile Generators.
It is intended to specify dependencies on “linker scripts” for
custom Makefile link rules.
When target dependencies are specified using target_link_libraries()
,
CMake will read this property from all target dependencies to determine the
build properties of the consumer.
Contents of INTERFACE_LINK_DEPENDS
may use “generator expressions”
with the syntax $<...>
. See the cmake-generator-expressions(7)
manual for available expressions. See the cmake-buildsystem(7)
-manual for more on defining buildsystem properties.
Link dependency files usage requirements commonly differ between the build-tree
and the install-tree. The BUILD_INTERFACE
and INSTALL_INTERFACE
generator expressions can be used to describe separate usage requirements
based on the usage location. Relative paths are allowed within the
INSTALL_INTERFACE
expression and are interpreted relative to the
installation prefix. For example:
set_property(TARGET mylib PROPERTY INTERFACE_LINK_DEPENDS
$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/mylinkscript>
$<INSTALL_INTERFACE:mylinkscript> # <prefix>/mylinkscript
)