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.