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/v3.27/prop_tgt/INTERFACE_LINK_LIBRARIES.html
