target_link_directories

Новое в версии 3.13.

Добавление каталогов ссылок для целевого объекта.

target_link_directories(<target> [BEFORE]
  <INTERFACE|PUBLIC|PRIVATE> [items1...]
  [<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])

Указывает пути, в которых компоновщик должен искать библиотеки при компоновке заданного целевого объекта. Каждый элемент может быть абсолютным или относительным путем, при этом последний интерпретируется как относительный к текущей директории исходного кода. Эти элементы будут добавлены в команду компоновки.

Названный <target> объект должен быть создан командой, такой как add_executable() или add_library(), и не должен быть целевым объектом-псевдонимом.

Ключевые слова INTERFACE, PUBLIC и PRIVATE необходимы для указания области действия следующих элементов. Элементы PRIVATE и PUBLIC заполнят свойство LINK_DIRECTORIES объекта <target>. Элементы PUBLIC и INTERFACE заполнят свойство INTERFACE_LINK_DIRECTORIES объекта <target> (импортированные целевые объекты поддерживают только INTERFACE элементы). Каждый элемент указывает каталог ссылок и будет преобразован в абсолютный путь, если необходимо, перед добавлением в соответствующее свойство. Повторные вызовы для одного <target> добавляют элементы в порядке вызова.

Если BEFORE указано, содержимое будет добавлено в начало соответствующего свойства, а не в конец.

Аргументы для target_link_directories могут использовать "генераторские выражения" с синтаксисом $<...>. См. руководство cmake-generator-expressions(7) для доступных выражений. См. руководство cmake-buildsystem(7) для получения дополнительной информации о определении свойств системы сборки.

Примечание

Эта команда редко необходима и должна быть избегаема, когда есть другие варианты. Предпочтительно передавать полные абсолютные пути к библиотекам, когда это возможно, так как это гарантирует, что будет связана правильная библиотека. Команда find_library() предоставляет полный путь, который, как правило, можно использовать непосредственно в вызовах target_link_libraries(). Ситуации, когда может потребоваться путь поиска библиотеки, включают:

Генераторы проектов, такие как Xcode, где пользователь может переключаться между архитектурами целевых объектов во время сборки, но полный путь к библиотеке использовать нельзя, потому что он предоставляет только одну архитектуру (т.е. это не универсальный двоичный файл).
Библиотеки могут иметь собственные зависимости от других частных библиотек, которые ожидают быть найдены с помощью механизмов RPATH, но некоторые компоновщики не могут полностью расшифровать эти пути (например, из-за наличия таких вещей, как $ORIGIN).

© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.20/command/target_link_directories.html