CMake

CMake

Введение

CMake — это кроссплатформенный генератор системы сборки с открытым исходным кодом. Для получения полной документации посетите домашнюю страницу CMake и страницу документации CMake. В Wiki сообщества CMake также есть ссылки на полезные руководства и рецепты.

CMake поддерживается и поддерживается Kitware и разрабатывается в сотрудничестве с продуктивным сообществом участников.

Лицензия

CMake распространяется по одобренной OSI лицензии BSD с 3 пунктами. Подробности смотрите в Copyright.txt.

Создание CMake

Поддерживаемые платформы

• Microsoft Windows

• Яблоко macOS

• Линукс

• FreeBSD

• OpenBSD

• Солярис

• ЭКС

Другие UNIX-подобные операционные системы также могут работать «из коробки», в противном случае перенос CMake на эту платформу не должен стать серьезной проблемой. Пожалуйста, напишите сообщение на дискуссионном форуме CMake, чтобы узнать, есть ли у других опыт работы с этой платформой.

Создание CMake с помощью CMake

Вы можете собрать CMake, как и любой другой проект, с помощью системы сборки на основе CMake: запустите уже установленный CMake в этом дереве исходного кода с предпочитаемым вами генератором и параметрами. Затем создайте его и установите.

Чтобы создать документацию, установите Sphinx и настройте CMake с -DSPHINX_HTML=ON и/или -DSPHINX_MAN=ON , чтобы включить построитель "html" или "man". Добавьте -DSPHINX_EXECUTABLE=/path/to/sphinx-build если инструмент не найден автоматически.

Чтобы запустить набор тестов, запустите ctest в каталоге сборки CMake после сборки. Подробности см. в Руководстве по тестированию CMake.

Создание CMake с нуля

UNIX/Mac OSX/MinGW/MSYS/Cygwin

Вам необходим компилятор C++ (поддерживающий C++11) и установленный make . Запустите сценарий bootstrap который вы найдете в исходном каталоге CMake. Вы можете использовать опцию --help , чтобы просмотреть поддерживаемые параметры. Вы можете использовать параметр --prefix= , чтобы указать пользовательский каталог установки для CMake. После успешного завершения запустите make и make install .

Например, если вы просто хотите собрать и установить CMake из исходного кода, вы можете выполнить сборку непосредственно в дереве исходного кода:

 $ ./bootstrap && make && sudo make install

Или, если вы планируете разрабатывать CMake или иным образом запускать набор тестов, создайте отдельное дерево сборки:

 $ mkdir build && cd build
$ ../bootstrap && make

Окна

Существует два способа сборки CMake под Windows:

1. Скомпилируйте с помощью MSVC из VS 2015 или новее. Вам необходимо загрузить и установить двоичную версию CMake. Вы можете получить эти выпуски на странице загрузки CMake. Затем перейдите к приведенным выше инструкциям по сборке CMake с помощью CMake.

2. Загрузка с MinGW под MSYS2. Загрузите и установите MSYS2. Затем установите необходимые инструменты сборки:

    $ pacman -S --needed git base-devel mingw-w64-x86_64-gcc

   и загрузите, как указано выше.

Сообщить об ошибках

Если вы нашли ошибку:

1. Если у вас есть патч, прочтите документ CONTRIBUTING.first.

2. В противном случае отправьте сообщение на дискуссионный форум CMake и спросите об ожидаемом и наблюдаемом поведении, чтобы определить, действительно ли это ошибка.

3. Наконец, если проблема не решена с помощью описанных выше шагов, откройте запись в системе отслеживания проблем CMake.

Содействие

Инструкции по внесению вклада см. в разделе CONTRIBUTING.rst.