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.