CMakeFindDependencyMacro

Этот модуль предоставляет команду, реализованную в виде макроса, который находит зависимость для пакета.

Загрузите этот модуль в файл конфигурации пакета CMake с помощью:

include(CMakeFindDependencyMacro)

Команды

Этот модуль предоставляет следующую команду:

find_dependency

Макрос find_dependency() оборачивает вызов find_package() для зависимости пакета:

find_dependency(<dep> [...])

Он предназначен для использования в файле конфигурации пакета (<PackageName>Config.cmake). find_dependency передаёт правильные параметры для QUIET и REQUIRED, которые были переданы исходному вызову find_package(). Все указанные дополнительные аргументы передаются в find_package().

Если зависимость не удалось найти, макрос задаёт информативное диагностическое сообщение и вызывает return(), чтобы завершить обработку вызывающего файла конфигурации пакета и вернуться к команде find_package(), которая загрузила этот файл.

Примечание

Вызов return() делает этот макрос непригодным для вызова из модулей Find.

Оптимизация поиска зависимостей пакета

Если find_dependency вызывается с аргументами, идентичными аргументам предыдущего вызова в том же каталоге, например, из-за зависимостей пакетов ромбовидной формы, базовый вызов find_package() оптимизируется и не выполняется. Эта оптимизация важна для поддержки больших графов зависимостей пакетов без комбинаторного взрыва повторных поисков. Однако эвристика не может учитывать переменные окружения, влияющие на поведение пакетов, например <PackageName>_USE_STATIC_LIBS, предоставляемые некоторыми пакетами. Поэтому файлам конфигурации пакетов следует избегать задания таких переменных перед вызовами find_dependency.