target_link_directories

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

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–2020 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.15/command/target_link_directories.html