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.14/command/link_directories.html