Spec-Zone.ru › CMake 3.23

CMAKE_FIND_PACKAGE_PREFER_CONFIG

Новое в версии 3.15.

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

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

© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.20/variable/CMAKE_FIND_PACKAGE_PREFER_CONFIG.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API