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