ccmake(1)

Синопсис

ccmake [<options>] (<path-to-source> | <path-to-existing-build>)

Описание

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

CMake — это кроссплатформенная система генерации систем сборки. Проекты указывают свой процесс сборки с помощью независимых от платформы файлов CMake, включённых в каждом каталоге дерева исходных файлов с именем CMakeLists.txt. Пользователи собирают проект, используя 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/Wiki/CMake_FAQ

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

Онлайн-документация

https://cmake.org/documentation

На этой странице есть ссылки на доступную документацию.

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

https://cmake.org/mailing-lists

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