ccmake(1)

Синопсис

ccmake [<options>] {<path-to-source> | <path-to-existing-build>}

Описание

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

CMake — это кроссплатформенная система генерации систем сборки. Проекты определяют процесс сборки с помощью независимых от платформы файлов CMake, включённых в каждый каталог дерева исходных файлов с именем CMakeLists.txt. Пользователи собирают проект, используя CMake для генерации системы сборки для целевого инструмента на их платформе.

Опции

-S <path-to-source>

Путь к корневому каталогу проекта CMake для сборки.

-B <path-to-build>

Путь к каталогу, который CMake будет использовать в качестве корня каталога сборки.

Если каталог еще не существует, CMake создаст его.

-C <initial-cache>

Предварительная загрузка скрипта для заполнения кэша.

Когда CMake впервые запускается в пустом дереве сборки, он создаёт файл CMakeCache.txt и заполняет его настраиваемыми настройками для проекта. Эта опция может быть использована для указания файла, из которого следует загрузить записи кэша перед первым проходом через файлы CMake проекта. Загруженные записи имеют приоритет над значениями по умолчанию проекта. Указанный файл должен быть скриптом CMake, содержащим команды set(), использующие опцию CACHE, а не файл в формате кэша.

Ссылки на CMAKE_SOURCE_DIR и CMAKE_BINARY_DIR в скрипте соответствуют верхнему уровню дерева исходных и бинарных файлов.

-D <var>:<type>=<value>, -D <var>=<value>

Создание или обновление записи CMake CACHE.

Когда CMake впервые запускается в пустом дереве сборки, он создаёт файл CMakeCache.txt и заполняет его настраиваемыми настройками для проекта. Эта опция может быть использована для указания настройки, которая имеет приоритет над значением по умолчанию проекта. Опцию можно повторять для любого количества CACHE записей.

Если указана часть :<type>, она должна соответствовать одному из типов, указанных в документации команды set() для её CACHE сигнатуры. Если часть :<type> опущена, запись будет создана без типа, если она не существует с уже существующим типом. Если команда в проекте задаёт тип PATH или FILEPATH, то <value> будет преобразовано в абсолютный путь.

Эту опцию также можно указать в виде одного аргумента: -D<var>:<type>=<value> или -D<var>=<value>.

-U <globbing_expr>

Удаление совпадающих записей из кэша CMake CACHE.

Эту опцию можно использовать для удаления одной или нескольких переменных из файла CMakeCache.txt; поддерживаются выражения с подстановкой * и ?. Опцию можно повторять для любого количества CACHE записей.

Используйте с осторожностью, вы можете сделать свою CMakeCache.txt неработающей.

-G <generator-name>

Указание генератора системы сборки.

CMake может поддерживать несколько систем сборки на определённых платформах. Генератор отвечает за генерацию конкретной системы сборки. Возможные имена генераторов указаны в руководстве cmake-generators(7).

Если не указано, CMake проверяет переменную среды CMAKE_GENERATOR и в противном случае использует встроенный выбор по умолчанию.

-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

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

Форум Discourse

https://discourse.cmake.org

Форум Discourse предоставляет возможность обсуждения и задавать вопросы о CMake.