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 целевого объекта абсолютными путями к зависимостям. Это встроит в установленные пакеты пути к файлам библиотек зависимостей так, как они были найдены на машине, на которой был создан пакет.
См. раздел «Создание переносимых пакетов» в руководстве Создание переносимых пакетов руководства cmake-packages(7) для обсуждения дополнительных мер предосторожности, которые необходимо принять при указании требований к использованию при создании пакетов для перераспределения.
© 2000–2022 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.23/prop_tgt/INTERFACE_LINK_LIBRARIES.html
