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