Spec-Zone.ru › CMake 3.24

CMAKE_FIND_PACKAGE_REDIRECTS_DIR

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

Эта переменная только для чтения указывает каталог, который команда find_package() будет проверять в первую очередь перед поиском модуля или файла конфигурации пакета в любом другом месте. Файл конфигурации пакета в этом каталоге всегда будет найден в приоритете перед любым другим файлом модуля Find или файлом конфигурации пакета.

Основное назначение этой переменной заключается в облегчении интеграции между find_package() и FetchContent_MakeAvailable(). Последняя команда может создавать файлы в каталоге CMAKE_FIND_PACKAGE_REDIRECTS_DIR при заполнении зависимости. Это позволяет последующим вызовам find_package() для той же зависимости повторно использовать заполненное содержимое вместо попытки удовлетворить зависимость откуда-то внешнего по отношению к сборке. Проекты также могут захотеть записать файлы в этот каталог в некоторых ситуациях (см. Интеграция с find_package() для примеров).

Каталог, на который указывает CMAKE_FIND_PACKAGE_REDIRECTS_DIR, всегда будет удален и перезаполнен пустым при запуске каждого выполнения CMake. Любые файлы, записанные в этот каталог во время выполнения CMake, будут потеряны при следующем конфигурировании проекта.

CMAKE_FIND_PACKAGE_REDIRECTS_DIR устанавливается только в режиме проекта CMake. Он не устанавливается при запуске CMake в режиме сценария (т.е. cmake -P ...).

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

Spec-Zone.ru

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