Projekte über die Befehlszeile erstellen

Auf dieser Seite wird erläutert, wie Sie bestehende Projekte konfigurieren und erstellen. Wenn Sie erfahren möchten, wie Sie ein Qt-basiertes CMake-Projekt erstellen, lesen Sie die Dokumentation zu den ersten Schritten mit CMake.

Um ein Qt-Projekt zu erstellen, muss CMake wissen, wo sich die Qt-Installation befindet. In der Regel geschieht dies durch Setzen der CMake-Variable CMAKE_PREFIX_PATH auf das Installationspräfix von Qt. Wenn Sie eine Cross-Kompilierung durchführen, finden Sie unter „Cross-Kompilierung“ weitere Informationen zu zusätzlichen Variablen, die Sie setzen müssen.

Wenn Qt über Qt Online Installer installiert wurde, wählen Sie eine Qt-Version im obersten Installationsverzeichnis aus. Der folgende Befehl zeigt beispielsweise, wie dies unter Windows erfolgt:

cmake -DCMAKE_PREFIX_PATH=C:\Qt\6.12.0\msvc2022_64 -S <source-dir> -B <build-dir>

Die Platzhalter „ <source-dir> “ und „ <build-dir> “ stehen für das Quell- und das Build-Verzeichnis Ihres Projekts.

CMake-Generatoren

CMake generiert die erforderlichen Build-System-Dateien, die es Build-Tools wie GNU Make oder Ninja ermöglichen, Ihr Projekt zu erstellen.

Der Standardgenerator von CMake hängt von der Plattform und der Build-Umgebung ab. Unter Windows generiert CMake beispielsweise Visual Studio-Projektdateien, wenn eine Visual Studio-Umgebung erkannt wird.

Um eine einheitliche Entwicklererfahrung auf allen Plattformen zu gewährleisten, verwenden Sie den Generator „ Ninja “ oder „ Ninja Multi-Config “.

Sie können den CMake-Generator entweder durch Setzen der Umgebungsvariable ` CMAKE_GENERATOR ` oder durch Verwendung des Arguments ` -G ` auswählen:

cmake -G Ninja ...

qt-cmake

Das Skript „ qt-cmake “ ist eine praktische Alternative zur Konfiguration Ihres Projekts. Es erspart Ihnen die Angabe des Arguments „ CMAKE_PREFIX_PATH “. Sie finden es im Verzeichnis „ bin “ Ihres Qt-Installationspräfixes. Das Skript übergibt alle Parameter an CMake, sodass Sie es genauso verwenden können wie „ cmake “:

C:\Qt\6.12.0\msvc2022_64\bin\qt-cmake -G Ninja -S <source-dir> -B <build-dir>

Nachdem die Dateien des Build-Systems generiert wurden, ist Ihr Projekt bereit für den Build:

cd <build-dir>
ninja

Sie können auch den generatorunabhängigen CMake-Befehl verwenden:

cmake --build <build-dir>

Cross-Kompilierung

Das Erstellen deines Projekts für eine Plattform, die sich von deinem Entwicklungsrechner unterscheidet, wird als Cross-Kompilierung bezeichnet. Ein Beispiel ist das Erstellen für Android (die Zielplattform) auf einem Windows-Rechner (der Host-Plattform).

Das Cross-Compiling mit CMake erfordert für die meisten Plattformen eine Toolchain-Datei. Außerdem ist neben einer Qt-Version für die Zielplattform eine Qt-Version für den Entwicklungshost erforderlich. Um beispielsweise unter Windows für Android zu cross-kompilieren, müssen Qt für Windows und Qt für Android installiert sein.

Verwenden Sie „ qt-cmake “ aus der Qt-Installation für die Zielplattform, um Ihr Projekt für diese Plattform cross-zu-kompilieren:

<target-qt>/bin/qt-cmake -S <source-dir> -B <build-dir>

Dadurch wird Ihr Projekt für die Zielplattform konfiguriert. Die Toolchain-Datei wird automatisch übergeben, und möglicherweise werden weitere plattformspezifische Variablen eingerichtet.

Festlegen einer benutzerdefinierten Toolchain-Datei

Das Skript „ qt-cmake “ übergibt eine Qt-interne Toolchain-Datei an CMake. Diese Toolchain-Datei legt mehrere Variablen fest, die spezifisch für die Zielplattform von Qt sind.

Wenn Sie eine Qt-Installation verwenden, die nicht auf Ihrem Rechner erstellt wurde, muss „ qt-cmake “ den Speicherort der CMake-Toolchain-Datei für die Zielplattform kennen.

In einem solchen Fall können Sie „ qt-cmake “ anweisen, eine benutzerdefinierte Toolchain-Datei einzubinden, indem Sie die Variable „ QT_CHAINLOAD_TOOLCHAIN_FILE “ setzen:

~/Qt/6.12.0/android_armv7/bin/qt-cmake -DQT_CHAINLOAD_TOOLCHAIN_FILE=<file-path> -S <source-dir> -B <build-dir>

Dadurch wird die interne Toolchain-Datei von Qt angewiesen, auch Ihre benutzerdefinierte Toolchain-Datei zu laden.