INTERFACE_LINK_LIBRARIES
Список общедоступных библиотек интерфейса для библиотеки.
Это свойство содержит список транзитивных зависимостей по ссылкам. Когда целевой объект связан с другим целевым объектом с помощью команды target_link_libraries(), перечисленные библиотеки (и рекурсивно их библиотеки интерфейса ссылок) также будут предоставлены другому целевому объекту. Это свойство переопределяется свойством LINK_INTERFACE_LIBRARIES или LINK_INTERFACE_LIBRARIES_<CONFIG>, если политика CMP0022 имеет значение OLD или не задана.
Значение этого свойства используется генераторами при построении правила ссылки для зависимого целевого объекта. Прямые зависимости по ссылкам зависимого целевого объекта, указанные в его свойстве целевого объекта LINK_LIBRARIES, связываются в первую очередь, за которыми следуют косвенные зависимости из транзитивного замыкания прямых зависимостей в свойствах INTERFACE_LINK_LIBRARIES. См. политику CMP0022.
Содержимое INTERFACE_LINK_LIBRARIES может использовать «генераторские выражения» с синтаксисом $<...>. См. руководство cmake-generator-expressions(7) для доступных выражений. См. руководство cmake-buildsystem(7) для получения дополнительной информации об определении свойств системы сборки.
Примечание
Вызов target_link_libraries(<target> ...) может обновить это свойство в <target>. Если <target> не был создан в той же директории, что и вызов, то target_link_libraries() будет оборачивать каждую запись в форме ::@(directory-id);...;::@, где ::@ является литералом, а (directory-id) — неопределённым. Это сообщает генераторам, что указанные библиотеки должны быть найдены в области вызывающего объекта, а не в области, в которой <target> был создан. Действительные идентификаторы каталогов удаляются при экспорте командами install(EXPORT) и export().
INTERFACE_LINK_LIBRARIES добавляет транзитивные зависимости по ссылкам для зависимых от целевого объекта. В сложных случаях использования можно обновить прямые зависимости по ссылкам зависимых от целевого объекта, используя свойства целевого объекта INTERFACE_LINK_LIBRARIES_DIRECT и INTERFACE_LINK_LIBRARIES_DIRECT_EXCLUDE.
Создание переносимых пакетов
Обратите внимание, что не рекомендуется заполнять INTERFACE_LINK_LIBRARIES целевого объекта абсолютными путями к зависимостям. Это жёстко закодирует в установленных пакетах пути к файлам библиотек зависимостей так, как они были найдены на машине, на которой был создан пакет.
См. раздел «Создание переносимых пакетов» в руководстве Создание переносимых пакетов cmake-packages(7) для обсуждения дополнительных мер предосторожности, которые необходимо принять при указании требований к использованию при создании пакетов для распространения.
© 2000–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/latest/prop_tgt/INTERFACE_LINK_LIBRARIES.html
