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/documentation

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

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

https://cmake.org/mailing-lists

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