Spec-Zone.ru › CMake

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.

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

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

Spec-Zone.ru

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