Spec-Zone.ru › CMake

CMAKE_INSTALL_PREFIX

Каталог установки, используемый командой install().

Если вызывается make install или выполняется сборка INSTALL, этот каталог добавляется в начало всех каталогов установки.

По умолчанию для этой переменной задаётся следующее значение:

  • Добавлено в версии 3.29: Если задана переменная среды CMAKE_INSTALL_PREFIX, её значение используется в качестве значения по умолчанию для этой переменной.

  • c:/Program Files/${PROJECT_NAME} в Windows.
  • /usr/local на платформах UNIX.

Сведения о том, как проект может задать собственное значение по умолчанию, см. в CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT.

В UNIX можно использовать механизм DESTDIR, чтобы перенести всю установку в промежуточную область. Дополнительные сведения см. в описании переменной среды DESTDIR.

Префикс установки также добавляется в CMAKE_SYSTEM_PREFIX_PATH, чтобы команды find_package(), find_program(), find_library(), find_path() и find_file() выполняли поиск другого программного обеспечения в этом префиксе. Это поведение можно отключить, установив для CMAKE_FIND_NO_INSTALL_PREFIX значение TRUE до первого вызова project().

Примечание

Используйте модуль GNUInstallDirs, чтобы предоставить параметры в стиле GNU для размещения каталогов в установке.

При настройке дерева сборки можно определить CMAKE_INSTALL_PREFIX, чтобы задать префикс установки. При использовании режима --install инструмента командной строки cmake(1) можно указать другой префикс с помощью параметра --prefix:

cmake --install . --prefix /my/install/prefix

Примечание

Если проект использует модуль GNUInstallDirs, некоторые особые случаи обрабатываются с учётом значения переменной CMAKE_INSTALL_PREFIX на этапе конфигурирования. Полученные результаты сохраняются, даже если при установке используется альтернативный параметр --prefix.

См. также

  • Параметр --install-prefix.
  • Генераторное выражение $<INSTALL_PREFIX>.
  • Поле installDir в пресетах конфигурирования CMake.
  • Переменная CPACK_PACKAGING_INSTALL_PREFIX.

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

Spec-Zone.ru

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