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–2024 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