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-name>

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

Некоторые генераторы CMake поддерживают имя набора инструментов, которое следует передать системе сборки, чтобы выбрать компилятор. Это поддерживается только для определённых генераторов:

Visual Studio >= 10
Xcode >= 3.0

См. документацию системы сборки для разрешённых имён наборов инструментов.

-A <platform-name>

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

Некоторые генераторы CMake поддерживают имя платформы, которое следует передать системе сборки, чтобы выбрать компилятор или SDK. Это поддерживается только для определённых генераторов:

Visual Studio >= 8

См. документацию системы сборки для разрешённых имён платформ.

-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, прежде чем задавать вопросы на этом списке.