ccmake(1)

Синопсис

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

Описание

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

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.