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