target_link_directories

Добавить каталоги ссылок к цели.

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

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

Именованная <target> должна быть создана командой, такой как add_executable() или add_library() и не должна быть целью ALIAS.

Ключевые слова 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–2020 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.14/command/target_link_directories.html