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<pkg>.cmake, перед поиском пользовательской библиотеки, скомпилированной разработчиком.

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