ccmake(1)

Синопсис

ccmake [<options>] {<path-to-source> | <path-to-existing-build>}

Описание

Исполняемый файл ccmake — это интерфейс CMake с использованием curses. Параметры конфигурации проекта могут быть заданы интерактивно через этот графический интерфейс. Краткое руководство предоставляется в нижней части терминала во время работы программы.

CMake — это кроссплатформенная система генерации билдов. Проекты задают свой процесс сборки с помощью независимых от платформы файлов CMakeLists.txt, включённых в каждый каталог дерева исходных кодов. Пользователи собирают проект, используя CMake для генерации системы сборки для целевой среды на своей платформе.

Параметры

-S <path-to-source>

Путь к корневому каталогу проекта CMake для сборки.

-B <path-to-build>

Путь к каталогу, который CMake будет использовать как корень каталога сборки.

Если каталог не существует, CMake создаст его.

-C <initial-cache>

Предварительная загрузка скрипта для заполнения кэша.

При первом запуске cmake в пустом дереве сборки создаётся файл CMakeCache.txt и заполняется настраиваемыми параметрами проекта. Этот параметр можно использовать для указания файла, из которого следует загрузить записи кэша перед первым проходом через файлы cmake проекта. Загруженные записи имеют приоритет над значениями по умолчанию проекта. Указанный файл должен быть скриптом CMake, содержащим команды SET с опцией CACHE, а не файлом формата кэша.

-D <var>:<type>=<value>, -D <var>=<value>

Создание или обновление записи кэша cmake.

При первом запуске cmake в пустом дереве сборки создаётся файл CMakeCache.txt и заполняется настраиваемыми параметрами проекта. Этот параметр можно использовать для указания параметра, который имеет приоритет над значением по умолчанию проекта. Параметр может быть повторён для любого количества записей кэша.

Если часть :<type> задана, она должна быть одним из типов, указанных в документации команды set() для её подписи CACHE. Если часть :<type> опущена, запись будет создана без типа, если она не существует с уже заданным типом. Если команда в проекте задаёт тип как PATH или FILEPATH, то <value> будет преобразован в абсолютный путь.

Этот параметр также может быть задан как один аргумент: -D<var>:<type>=<value> или -D<var>=<value>.

-U <globbing_expr>

Удаление соответствующих записей из кэша CMake.

Этот параметр может быть использован для удаления одной или нескольких переменных из файла CMakeCache.txt, поддерживаются выражения с подстановкой * и ?. Параметр может быть повторён для любого количества записей кэша.

Используйте с осторожностью, вы можете сделать ваш CMakeCache.txt неработоспособным.

-G <generator-name>

Указание генератора системы сборки.

CMake может поддерживать несколько систем сборки на определённых платформах. Генератор отвечает за генерацию конкретной системы сборки. Возможные имена генераторов указаны в руководстве cmake-generators(7).

-T <toolset-spec>

Указание набора инструментов для генератора, если поддерживается.

Некоторые генераторы CMake поддерживают указание набора инструментов, чтобы указать целевой системе сборки, как выбрать компилятор. Подробности см. в переменной CMAKE_GENERATOR_TOOLSET.

-A <platform-name>

Указание имени платформы, если поддерживается генератором.

Некоторые генераторы CMake поддерживают имя платформы, которое передаётся целевой системе сборки для выбора компилятора или SDK. Подробности см. в переменной CMAKE_GENERATOR_PLATFORM.

-Wno-dev

Отключение предупреждений для разработчиков.

Отключение предупреждений, предназначенных автору файлов CMakeLists.txt. По умолчанию это также отключает предупреждения о устаревших элементах.

-Wdev

Включение предупреждений для разработчиков.

Включение предупреждений, предназначенных автору файлов CMakeLists.txt. По умолчанию это также включает предупреждения о устаревших элементах.

-Werror=dev

Превращение предупреждений разработчиков в ошибки.

Превращение предупреждений, предназначенных автору файлов CMakeLists.txt, в ошибки. По умолчанию это также превращает предупреждения об устаревших элементах в ошибки.

-Wno-error=dev

Превращение предупреждений разработчиков не в ошибки.

Превращение предупреждений, предназначенных автору файлов CMakeLists.txt, не в ошибки. По умолчанию это также отключает предупреждения об устаревших элементах как ошибки.

-Wdeprecated

Включение предупреждений о устаревших функциях.

Включение предупреждений об использовании устаревших функций, предназначенных автору файлов CMakeLists.txt.

-Wno-deprecated

Отключение предупреждений об устаревших функциях.

Отключение предупреждений об использовании устаревших функций, предназначенных автору файлов CMakeLists.txt.

-Werror=deprecated

Превращение предупреждений о устаревших макросах и функциях в ошибки.

Превращение предупреждений об использовании устаревших макросов и функций, предназначенных автору файлов CMakeLists.txt, в ошибки.

-Wno-error=deprecated

Превращение предупреждений о устаревших макросах и функциях не в ошибки.

Превращение предупреждений об использовании устаревших макросов и функций, предназначенных автору файлов CMakeLists.txt, не в ошибки.

--help,-help,-usage,-h,-H,/?

Вывести информацию об использовании и выйти.

Информация об использовании описывает базовый интерфейс командной строки и его опции.

--version,-version,/V [<f>]

Показать баннер с именем/версией программы и выйти.

Если указан файл, версия записывается в него. Справка выводится в указанный файл <f>айл, если задан.

--help-full [<f>]

Вывести все руководства справки и выйти.

Все руководства выводятся в удобочитаемом текстовом формате. Справка выводится в указанный файл <f>айл, если задан.

--help-manual <man> [<f>]

Вывести одно руководство справки и выйти.

Указанное руководство выводится в удобочитаемом текстовом формате. Справка выводится в указанный файл <f>айл, если задан.

--help-manual-list [<f>]

Вывести список доступных руководств справки и выйти.

Список содержит все руководства, справка по которым может быть получена с помощью опции --help-manual и последующего имени руководства. Справка выводится в указанный файл <f>айл, если задан.

--help-command <cmd> [<f>]

Вывести справку по одной команде и выйти.

Запись справки cmake-commands(7) по <cmd> выводится в удобочитаемом текстовом формате. Справка выводится в указанный файл <f>айл, если задан.

--help-command-list [<f>]

Вывести список команд со справкой и выйти.

Список содержит все команды, справка по которым может быть получена с помощью опции --help-command и последующего имени команды. Справка выводится в указанный файл <f>айл, если задан.

--help-commands [<f>]

Вывести руководство справки cmake-commands и выйти.

Руководство cmake-commands(7) выводится в удобочитаемом текстовом формате. Справка выводится в указанный файл <f>айл, если задан.

--help-module <mod> [<f>]

Вывести справку по одному модулю и выйти.

Запись справки cmake-modules(7) по <mod> выводится в удобочитаемом текстовом формате. Справка выводится в указанный файл <f>айл, если задан.

--help-module-list [<f>]

Вывести список модулей со справкой и выйти.

Список содержит все модули, справка по которым может быть получена с помощью опции --help-module и последующего имени модуля. Справка выводится в указанный файл <f>айл, если задан.

--help-modules [<f>]

Вывести руководство справки cmake-modules и выйти.

Руководство cmake-modules(7) выводится в удобочитаемом текстовом формате. Справка выводится в указанный файл <f>айл, если задан.

--help-policy <cmp> [<f>]

Вывести справку по одной политике и выйти.

Запись справки cmake-policies(7) по <cmp> выводится в удобочитаемом текстовом формате. Справка выводится в указанный файл <f>айл, если задан.

--help-policy-list [<f>]

Вывести список политик со справкой и выйти.

Список содержит все политики, справка по которым может быть получена с помощью опции --help-policy и последующего имени политики. Справка выводится в указанный файл <f>айл, если задан.

--help-policies [<f>]

Вывести руководство справки cmake-policies и выйти.

Руководство cmake-policies(7) выводится в удобочитаемом текстовом формате. Справка выводится в указанный файл <f>айл, если задан.

--help-property <prop> [<f>]

Вывести справку по одному свойству и выйти.

Записи справки cmake-properties(7) по <prop> выводятся в удобочитаемом текстовом формате. Справка выводится в указанный файл <f>айл, если задан.

--help-property-list [<f>]

Вывести список свойств со справкой и выйти.

Список содержит все свойства, справка по которым может быть получена с помощью опции --help-property и последующего имени свойства. Справка выводится в указанный файл <f>айл, если задан.

--help-properties [<f>]

Вывести руководство справки cmake-properties и выйти.

Руководство cmake-properties(7) выводится в удобочитаемом текстовом формате. Справка выводится в указанный файл <f>айл, если задан.

--help-variable <var> [<f>]

Вывести справку по одной переменной и выйти.

Запись справки cmake-variables(7) по <var> выводится в удобочитаемом текстовом формате. Справка выводится в указанный файл <f>айл, если задан.

--help-variable-list [<f>]

Вывести список переменных со справкой и выйти.

Список содержит все переменные, справка по которым может быть получена с помощью опции --help-variable и последующего имени переменной. Справка выводится в указанный файл <f>айл, если задан.

--help-variables [<f>]

Вывести руководство справки cmake-variables и выйти.

Руководство cmake-variables(7) выводится в удобочитаемом текстовом формате. Справка выводится в указанный файл <f>айл, если задан.

См. также

Следующие ресурсы доступны для получения справки по использованию CMake:

Главная страница

https://cmake.org

Основная отправная точка для изучения CMake.

Онлайн-документация и ресурсы сообщества

https://cmake.org/documentation

Ссылки на доступную документацию и ресурсы сообщества можно найти на этой веб-странице.

Список рассылки

https://cmake.org/mailing-lists

Для получения помощи и обсуждения использования cmake предоставляется список рассылки по адресу cmake@cmake.org. Список предназначен только для участников, но зарегистрироваться можно на веб-странице CMake. Сначала, пожалуйста, ознакомьтесь с полной документацией по адресу https://cmake.org, прежде чем задавать вопросы на этом списке.