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