ccmake(1)

Синопсис

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

Описание

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

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