Auf dieser Seite

Qt für Linux – Kompilieren aus dem Quellcode

Auf dieser Seite wird beschrieben, wie man Qt für Linux aus dem Quellcode konfiguriert und kompiliert. Beachten Sie, dass es in der Regel einfacher ist, die vorgefertigten Qt-Bibliotheken und -Tools über Qt Online Installer. Viele Linux-Distributionen stellen Qt-Pakete auch über ihren Paketmanager bereit. Kompilieren Sie Qt jedoch aus dem Quellcode, wenn Sie Qt weiter anpassen möchten oder eine Distribution verwenden, für die keine binären Qt-Pakete (in der richtigen Version) verfügbar sind.

Distributionsentwickler finden weitere Informationen zum Paketieren von Qt in den Paketierungsempfehlungen.

Schritt 1: Beschaffung der Quellcodes

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

Wenn Sie die Quellcodes über Qt Online Installer installieren, befinden sie sich im Qt-Installationsverzeichnis, zum Beispiel unter $HOME/Qt/6.12.0/Src.

Wenn Sie das einzelne Quellcode-Archiv heruntergeladen haben, entpacken Sie es in ein Verzeichnis Ihrer Wahl:

cd /tmp
tar xf ~/Downloads/qt-everywhere-src-6.12.0.tar.xz

Schritt 2: Installieren der Build-Voraussetzungen

Für den Build von Qt ist eine Build-Umgebung mit Tools, Compilern und Entwicklungspaketen erforderlich.

Build-Tools

WerkzeugUnterstützte Versionen
CMakeVersion 3.25 und neuer.
Ninja-
PythonVersion 3

Hinweis: „configure“ verwendet immer den Ninja-Generator und das Ninja-Build-Tool, sofern eine ausführbare Datei namens „ ninja “ verfügbar ist. Ninja ist plattformübergreifend, verfügt über zahlreiche Funktionen, ist leistungsstark und wird auf allen Plattformen empfohlen. Die Verwendung anderer Generatoren funktioniert möglicherweise, wird jedoch nicht offiziell unterstützt.

Compiler und Entwicklungspakete

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

DistributionArchitekturCompilerHinweise
Red Hat™ 9.6x86_64GCC 11
Red Hat 10.0x86_64GCC 14
openSUSE 16.0x86_64GCC 15
SUSE Linux Enterprise Server 15 SP6x86_64GCC 11
Ubuntu 22.04x86_64GCC, bereitgestellt von Canonical, GCC 11.xSiehe auch: Enterprise-Qt-Debian-Pakete.
Ubuntu 24.04x86_64, arm64GCC, bereitgestellt von Canonical, GCC 13.xBeachten Sie den Hinweis zur Unterstützung von Linux auf Arm-Desktops.
Debian 11.6x86_64, arm64GCC 10Beachten Sie den Hinweis zur Unterstützung von Linux auf Arm-Desktops.
Debian 12x86_64, arm64GCC 12Siehe auch: Enterprise-Qt-Debian-Pakete.

Beachten Sie den Hinweis zur Unterstützung von Linux auf Arm-Desktops.

Hinweis: Für Linux auf ARM-Desktops verwenden wir den Raspberry Pi 5 mit 8 GB RAM und Ubuntu 24.04 als Referenzplattform. Wenn Sie ein Problem mit einer anderen Hardware haben, versuchen Sie bitte, das Problem auf dem Raspberry Pi 5 zu reproduzieren. Wir planen, auf eine reguläre Plattformunterstützung umzustellen, sobald eine größere Auswahl an ARM-basierter Desktop-Hardware verfügbar ist. Die offiziellen Binärdateien unter Qt Online Installer wurden unter Ubuntu 24.04 kompiliert, das mit glibc 2.39 ausgeliefert wird. Sollte Ihre glibc-Version älter sein als die, mit der wir kompilieren, müssen Sie die Software aus dem Quellcode neu kompilieren.

Andere Compiler und Konfigurationen funktionieren möglicherweise, werden jedoch nicht aktiv getestet.

Qt ist zudem auf die Verfügbarkeit verschiedener Bibliotheken und Entwicklungspakete angewiesen, die in der Regel über den Paketmanager der jeweiligen Distribution installiert werden. Weitere Informationen finden Sie unter „Qt für Linux – Anforderungen “.

Schritt 3: Kompilieren der Qt-Bibliotheken und -Tools

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

mkdir -p ~/dev/qt-build
cd ~/dev/qt-build
/tmp/qt-everywhere-src-6.12.0/configure

Standardmäßig ist Qt für die Installation im Verzeichnis „ /usr/local/Qt-6.12.0 “ konfiguriert. Dies kann mit der Option „ -prefix “ geändert werden. Weitere Anpassungen finden Sie in der Liste der Konfigurationsoptionen.

Wurde „ configure “ erfolgreich ausgeführt? Fahren Sie dann mit dem Erstellen der Bibliotheken und Werkzeuge fort:

cmake --build . --parallel

Nach dem Erstellen müssen Sie die Bibliotheken und Werkzeuge an der entsprechenden Stelle installieren (es sei denn, Sie haben eine Entwicklerversion aktiviert):

cmake --install .

Beachten Sie, dass hierfür möglicherweise Root-Zugriff erforderlich ist.

Schritt 4: Erstellen Ihrer Anwendung

Nachdem Qt installiert ist, können Sie damit beginnen, Anwendungen zu erstellen.

Wenn Sie über die Befehlszeile arbeiten, sollten Sie die Qt-Tools zu Ihrem Standard PATH hinzufügen. Dies geschieht wie folgt:

Fügen Sie in der Datei „ .profile “ (sofern Ihre Shell bash, ksh, zsh oder sh ist) die folgenden Zeilen ein:

PATH=/usr/local/Qt-6.12.0/bin:$PATH
export PATH

Fügen Sie in der Datei „ .login “ (wenn Ihre Shell „csh“ oder „tcsh“ ist) die folgende Zeile hinzu:

setenv PATH /usr/local/Qt-6.12.0/bin:$PATH

Wenn Sie Ihre Anwendung über eine IDE erstellen möchten, müssen Sie die Qt-Version dort explizit registrieren:

© 2026 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.