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, чтобы зависимые проекты могли использовать их взаимозаменяемо.