target_link_directories
Добавлено в версии 3.13.
Добавляет каталоги поиска библиотек для цели.
target_link_directories(<target> [BEFORE]
{INTERFACE|PUBLIC|PRIVATE} <dir>...
[{INTERFACE|PUBLIC|PRIVATE} <dir>...]...)
Задает пути, в которых компоновщик должен искать библиотеки при компоновке указанной цели. Каждый элемент может быть абсолютным или относительным путем; относительные пути трактуются как указанные относительно текущего каталога исходного кода. Эти элементы будут добавлены в команду компоновки.
Именованная <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).
См. также
link_directories()target_compile_definitions()target_compile_features()target_compile_options()target_include_directories()target_link_libraries()target_link_options()target_precompile_headers()target_sources()
© 2000–2026 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/latest/command/target_link_directories.html
