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