Qt für Windows - Erstellung aus dem Quellcode

Diese Seite beschreibt den Prozess des Konfigurierens und Erstellens von Qt für Windows. Um ein vorgefertigtes Qt für Windows herunterzuladen und zu installieren, folgen Sie den Anweisungen auf der Seite Erste Schritte mit Qt.

Schritt 1: Beschaffung der Quellen

Die Qt-Quellen können unter Qt Online Installer installiert werden. Quellpakete sind auch über Git, als Archive im Qt-Konto (kommerzielle Nutzer) und auf download.qt.io (Open-Source-Nutzer) verfügbar.

Wenn Sie die Quellen über Qt Online Installer installieren, sind sie im Qt-Installationsverzeichnis verfügbar, zum Beispiel C:\Qt\6.8.2\Src.

Wenn Sie das Quellarchiv heruntergeladen haben, entpacken Sie es in ein Verzeichnis Ihrer Wahl, zum Beispiel C:\dev\Qt\src.

Hinweis: Der Pfad zum Quellverzeichnis darf keine Leerzeichen oder Windows-spezifischen Dateisystemzeichen enthalten. Außerdem sollte der Pfad kurz gehalten werden. Dies verhindert Probleme mit zu langen Dateipfaden in der Kompilierungsphase.

Schritt 2: Installieren der Build-Anforderungen und Einrichten der Umgebung

Um Qt aus den Quellen zu erstellen, benötigen Sie eine Build-Umgebung mit einem unterstützten Compiler und verschiedenen Build-Tools.

Build-Werkzeuge

WerkzeugUnterstützte VersionenBeschreibung
CMakeVersion 3.16 und neuer (3.17 und neuer für -debug-and-release Builds 3.21 und neuer für -static Builds).Erforderlich für die Konfiguration des Qt-Builds. Verfügbar unter Qt Online Installer und auf cmake.org.
Ninja-Empfohlenes Werkzeug für die Erstellung von Qt. Erhältlich unter Qt Online Installer und auf ninja-build.org.
PythonVersion 3Erforderliches Build-Tool. Windows-Installationsprogramme sind auf python.org oder im Microsoft Store erhältlich.

Die ausführbaren Dateien cmake.exe, ninja.exe und python.exe müssen in Ihrer Build-Umgebung verfügbar sein. Fügen Sie das entsprechende Verzeichnis zu Ihrer Umgebungsvariablen PATH hinzu.

Compiler

Die folgenden Compiler und Konfigurationen werden in Qt 6.8 unterstützt:

BetriebssystemArchitekturCompilerHinweise
Windows 10 (1809 oder höher)x86_64MSVC 2022, Mingw-w64 13.1
Windows 11x86_64MSVC 2022, Mingw-w64 13.1
Windows auf ARMARM64MSVC 2022

Hinweis: Derzeit unterstützt Qt kein ARM64EC auf Windows on ARM Geräten.

QDoc-Abhängigkeiten

QDoc verwendet Clang zum Parsen von C++-Code. Wenn Sie QDoc manuell erstellen möchten, finden Sie unter Installieren von Clang für QDoc spezifische Anforderungen für die Erstellung.

Qt GRPC und Qt Protobuf Abhängigkeiten

Qt GRPC und Qt Protobuf erfordern die Installation der Pakete gRPC und Protobuf. Sie finden die Installationsanweisungen für die Pakete im Beispiel für die Installation unter Windows mit vcpkg.

Einrichten der Umgebung

Für MSVC führen Sie einen der folgenden Schritte aus:

  • Führen Sie die Datei vcvarsall.bat aus:
    "C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64
  • Suchen Sie in der Windows-Suchleiste nach der Eingabeaufforderung für die VS Native Tools.

Für Mingw-w64: Fügen Sie Mingw-w64 zur Umgebungsvariablen PATH hinzu:

Set PATH=C:\qt\tools\mingw1120_64\bin;%PATH%

Schritt 3: Erstellen der Qt-Bibliotheken und -Tools

Um Ihren Build zu konfigurieren, erstellen Sie ein Build-Verzeichnis und führen Sie das Skript configure.bat in diesem Verzeichnis aus:

mkdir C:\dev\qt-build
cd C:\dev\qt-build
C:\dev\Qt\src\configure.bat

Standardmäßig wird Qt für die Installation im Verzeichnis C:\Qt\Qt-major.minor.patch konfiguriert, wobei das Triplett major.minor.patch für die zu erstellende Qt-Version steht. Dies kann mit Hilfe der Option -prefix geändert werden. Siehe die Liste der Qt-Konfigurationsoptionen, um weitere Anpassungen vorzunehmen.

Bauen Sie dann die Bibliotheken und Werkzeuge:

cmake --build . --parallel

Der Punkt nach --build steht für den aktuellen Ordner.

Nach der Erstellung müssen Sie die Bibliotheken und Tools in den gewünschten Pfad installieren (es sei denn, Sie haben ein Entwickler-Build aktiviert):

cmake --install .

Schritt 4: Erstellen Ihrer Anwendung

Nachdem Qt installiert ist, können Sie mit der Erstellung von Anwendungen beginnen.

Wenn Sie von der Kommandozeile aus arbeiten, sollten Sie die Qt-Tools wie folgt zu Ihrer Umgebungsvariablen PATH hinzufügen:

set PATH=C:\Qt\Qt-major.minor.patch\bin;%PATH%

Wenn Sie Qt in einer IDE verwenden möchten, müssen Sie die Qt-Version dort explizit registrieren. Für Qt Creator, siehe Qt Creator: Hinzufügen von Qt-Versionen.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.