CMAKE_REQUIRE_FIND_PACKAGE_<PackageName>

Переменная для принудительного выполнения вызова find_package() REQUIRED.

Каждый вызов find_package() в проекте без REQUIRED может быть преобразован в REQUIRED, установив переменную CMAKE_REQUIRE_FIND_PACKAGE_<PackageName> в значение TRUE. Это можно использовать для подтверждения предположений о среде сборки и для обеспечения раннего сбоя сборки, если они не выполняются.

Обратите внимание, что установка этой переменной в значение «истина» нарушает некоторые часто используемые шаблоны. Иногда для получения другого порядка поиска, отличного от стандартного, используются несколько вызовов find_package(). Например, проекты могут принудительно проверить известный путь к определенному пакету перед поиском в стандартных каталогах:

find_package(something PATHS /some/local/path NO_DEFAULT_PATH)
find_package(something)

В приведенном выше примере первый вызов ищет пакет something в определенном каталоге. Если CMAKE_REQUIRE_FIND_PACKAGE_something установлено в «истина», то этот первый вызов должен быть успешным, иначе произойдет ошибка.

Второй вызов никогда не получит возможность использовать стандартные каталоги в качестве резервного варианта.

Аналогичный шаблон используется даже некоторыми собственными модулями поиска CMake для поиска пакета конфигурации в первую очередь:

find_package(something CONFIG QUIET)
if(NOT something_FOUND)
  # Fall back to searching using typical Find module logic...
endif()

Опять же, если CMAKE_REQUIRE_FIND_PACKAGE_something установлено в «истина», первый вызов должен быть успешным. Это фактически означает, что пакет конфигурации должен быть найден для зависимости, и логика модуля поиска никогда не используется.

См. также переменную CMAKE_DISABLE_FIND_PACKAGE_<PackageName>.