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