link_directories

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

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

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

Каталоги добавляются в свойство каталога LINK_DIRECTORIES для текущего CMakeLists.txt файла, преобразуя относительные пути в абсолютные по мере необходимости. Команда будет применяться только к целям, созданным после её вызова.

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

Аргументы для link_directories могут использовать «генераторские выражения» с синтаксисом «$<…>». См. руководство cmake-generator-expressions(7) для доступных выражений. См. руководство cmake-buildsystem(7) для получения более подробной информации о определении свойств системы сборки.

Примечание

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

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

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

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