CMake

CMake

Einführung

CMake ist ein plattformübergreifender Open-Source-Buildsystemgenerator. Eine vollständige Dokumentation finden Sie auf der CMake-Homepage und der CMake-Dokumentationsseite. Das CMake Community Wiki verweist auch auf nützliche Anleitungen und Rezepte.

CMake wird von Kitware gepflegt und unterstützt und in Zusammenarbeit mit einer produktiven Community von Mitwirkenden entwickelt.

Lizenz

CMake wird unter der vom OSI genehmigten BSD-3-Klausel-Lizenz vertrieben. Weitere Informationen finden Sie in Copyright.txt.

CMake erstellen

Unterstützte Plattformen

• Microsoft Windows

• Apple macOS

• Linux

• FreeBSD

• OpenBSD

• Solaris

• AIX

Andere UNIX-ähnliche Betriebssysteme funktionieren möglicherweise auch sofort, wenn nicht, sollte es kein großes Problem sein, CMake auf diese Plattform zu portieren. Bitte posten Sie im CMake-Diskursforum und fragen Sie, ob andere Erfahrungen mit der Plattform gemacht haben.

CMake mit CMake erstellen

Sie können CMake wie jedes andere Projekt mit einem CMake-basierten Build-System erstellen: Führen Sie ein bereits installiertes CMake in diesem Quellbaum mit Ihrem bevorzugten Generator und Ihren bevorzugten Optionen aus. Dann bauen Sie es und installieren Sie es.

Um die Dokumentation zu erstellen, installieren Sie Sphinx und konfigurieren Sie CMake mit -DSPHINX_HTML=ON und/oder -DSPHINX_MAN=ON um den Builder „html“ oder „man“ zu aktivieren. Fügen Sie -DSPHINX_EXECUTABLE=/path/to/sphinx-build hinzu, wenn das Tool nicht automatisch gefunden wird.

Um die Testsuite auszuführen, führen Sie nach dem Erstellen ctest im CMake-Build-Verzeichnis aus. Weitere Informationen finden Sie im CMake-Testhandbuch.

CMake von Grund auf erstellen

UNIX/Mac OSX/MinGW/MSYS/Cygwin

Sie müssen einen C++-Compiler (der C++11 unterstützt) und ein make installiert haben. Führen Sie das bootstrap -Skript aus, das Sie im Quellverzeichnis von CMake finden. Sie können die Option --help verwenden, um die unterstützten Optionen anzuzeigen. Sie können die Option --prefix= verwenden, um ein benutzerdefiniertes Installationsverzeichnis für CMake anzugeben. Sobald dies erfolgreich abgeschlossen wurde, führen Sie make und make install aus.

Wenn Sie beispielsweise CMake einfach aus dem Quellcode erstellen und installieren möchten, können Sie den Build direkt im Quellbaum erstellen:

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

Wenn Sie vorhaben, CMake zu entwickeln oder die Testsuite anderweitig auszuführen, erstellen Sie einen separaten Build-Baum:

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

Windows

Es gibt zwei Möglichkeiten, CMake unter Windows zu erstellen:

1. Kompilieren Sie mit MSVC ab VS 2015 oder höher. Sie müssen eine Binärversion von CMake herunterladen und installieren. Sie können diese Versionen von der CMake-Downloadseite herunterladen. Fahren Sie dann mit den obigen Anweisungen zum Erstellen von CMake mit CMake fort.

2. Bootstrap mit MinGW unter MSYS2. Laden Sie MSYS2 herunter und installieren Sie es. Anschließend installieren Sie die erforderlichen Build-Tools:

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

   und Bootstrap wie oben.

Fehler melden

Wenn Sie einen Fehler gefunden haben:

1. Wenn Sie einen Patch haben, lesen Sie bitte das Dokument CONTRIBUTING.rst.

2. Andernfalls posten Sie bitte im CMake-Diskursforum und fragen Sie nach den erwarteten und beobachteten Verhaltensweisen, um festzustellen, ob es sich wirklich um einen Fehler handelt.

3. Wenn das Problem schließlich durch die oben genannten Schritte nicht behoben wird, öffnen Sie einen Eintrag im CMake Issue Tracker.

Mitwirken

Anweisungen zum Mitwirken finden Sie unter CONTRIBUTING.rst.