link_directories

Добавляет каталоги, в которых компоновщик будет искать библиотеки.

link_directories([AFTER|BEFORE] directory1 [directory2 ...])

Добавляет пути, по которым компоновщик должен искать библиотеки. Относительные пути, указанные в этой команде, интерпретируются относительно текущего каталога исходного кода; см. CMP0015.

Команда применяется только к целям, созданным после её вызова.

Добавлено в версии 3.13: Каталоги добавляются в свойство каталога LINK_DIRECTORIES для текущего файла CMakeLists.txt; относительные пути при необходимости преобразуются в абсолютные. Дополнительные сведения об определении свойств системы сборки см. в руководстве cmake-buildsystem(7).

Добавлено в версии 3.13: По умолчанию указанные каталоги добавляются в конец текущего списка каталогов. Это поведение по умолчанию можно изменить, задав для CMAKE_LINK_DIRECTORIES_BEFORE значение ON. Явное использование AFTER или BEFORE позволяет выбрать добавление в конец или в начало независимо от поведения по умолчанию.

Добавлено в версии 3.13: В аргументах link_directories можно использовать «генераторные выражения» с синтаксисом "$<...>". Доступные выражения описаны в руководстве cmake-generator-expressions(7).

Примечание

Эта команда редко бывает необходима, и её следует избегать, если есть другие варианты. По возможности предпочтительно передавать библиотекам полные абсолютные пути, поскольку это гарантирует, что будет скомпонована нужная библиотека. Команда find_library() возвращает полный путь, который обычно можно использовать напрямую при вызовах target_link_libraries(). К ситуациям, в которых может потребоваться путь поиска библиотек, относятся:

Генераторы проектов, такие как Xcode, в которых пользователь может переключать архитектуру цели во время сборки, но нельзя использовать полный путь к библиотеке, поскольку она поддерживает только одну архитектуру (то есть не является универсальным двоичным файлом).
Сами библиотеки могут иметь другие частные зависимости от библиотек, которые предполагается находить с помощью механизмов RPATH, но некоторые компоновщики не способны полностью обработать такие пути (например, из-за наличия элементов вроде $ORIGIN).

Если необходимо указать путь поиска библиотек, по возможности ограничьте область его действия, используя команду target_link_directories() вместо link_directories(). Команда, применяемая к конкретной цели, также позволяет управлять распространением каталогов поиска на другие зависимые цели.

См. также

© 2000–2026 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/latest/command/link_directories.html