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