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