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