CMAKE_FIND_PACKAGE_PREFER_CONFIG

Указать find_package() попробовать режим «Config» перед режимом «Module», если режим не был указан.

Команда find_package() работает без явного режима, когда используется сокращенная сигнатура без опции MODULE. В этом случае по умолчанию CMake сначала пробует режим Module, выполняя поиск модуля Find<pkg>.cmake. Если поиск не удается, CMake затем ищет пакет в режиме Config.

Установить CMAKE_FIND_PACKAGE_PREFER_CONFIG в TRUE чтобы указать find_package() в первую очередь искать в режиме Config, прежде чем переходить к режиму Module.

Эта переменная может быть полезной, когда разработчик скомпилировал собственную версию общей библиотеки и хочет связать её с зависимым проектом. Если эта переменная установлена в значение TRUE, это предотвратит выбор зависимым проектом в результате вызова find_package() по умолчанию библиотеки, найденной модулем системы Find<pkg>.cmake, прежде чем найти собственно скомпилированную библиотеку разработчика.

После установки этой переменной ответственность за экспортированные <pkg>Config.cmake файлы заключается в предоставлении тех же переменных результата, что и модули Find<pkg>.cmake, чтобы зависимые проекты могли использовать их взаимозаменяемо.