Qt für Linux/X11 - Erstellung aus dem Quellcode

Diese Seite beschreibt die Konfiguration und Erstellung von Qt für Linux/X11 aus den Quellen. Beachten Sie, dass es normalerweise einfacher ist, die vorgefertigten Qt-Bibliotheken und -Werkzeuge über Qt Online Installer. Viele Linux-Distributionen bieten auch Qt-Pakete über ihren Paketmanager an. Bauen Sie Qt jedoch aus den Quellen, wenn Sie Qt weiter anpassen wollen oder eine Distribution verwenden, für die keine binären Qt-Pakete (in der richtigen Version) verfügbar sind.

Paketierer von Distributionen finden in den Paketierungsempfehlungen weitere Informationen, wie sie Qt paketieren können.

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 $HOME/Qt/6.8.2/Src.

Wenn Sie das Einzelquellenarchiv heruntergeladen haben, entpacken Sie es in ein Verzeichnis Ihrer Wahl:

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

Schritt 2: Installation der Build-Anforderungen

Die Erstellung von Qt erfordert eine Build-Umgebung mit Tools, Compilern und Entwicklungspaketen.

Build-Tools

WerkzeugUnterstützte Versionen
CMakeVersion 3.16 und neuer (3.21 und neuer für -static builds).
Ninja-
PythonVersion 3

Hinweis: configure verwendet immer den Ninja-Generator und das Build-Tool, wenn eine ninja ausführbare Datei verfügbar ist. Ninja ist plattformübergreifend, funktionsreich, performant und wird für alle Plattformen empfohlen. Die Verwendung anderer Generatoren kann funktionieren, wird aber nicht offiziell unterstützt.

Compiler & Entwicklungspakete

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

VerteilungArchitekturCompilerHinweise
Red Hat 8.6x86_64GCC 10 (Werkzeugsatz)
Red Hat 8.8x86_64GCC 10 (Werkzeugsatz)
Red Hat 8.10x86_64GCC 10 (Werkzeugsatz)
Red Hat 9.2x86_64GCC 11
Roter Hut 9.4x86_64GCC 11
openSUSE 15.5x86_64GCC 9
SUSE Linux Enterprise Server 15 SP5x86_64GCC 10
Ubuntu 22.04x86_64GCC wie von Canonical bereitgestellt, GCC 11.x
Ubuntu 24.04x86_64, arm64GCC wie von Canonical zur Verfügung gestellt, GCC 13.xSiehe die Anmerkung.
Debian 11.6x86_64, arm64GCC 10Technologie-Vorschau

Siehe auch: Enterprise Qt Debian-Pakete.

Hinweis: Für Linux on Arm auf Desktops verwenden wir Raspberry Pi 5 mit 8GB 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, die Unterstützung für reguläre Plattformen zu übernehmen, sobald eine größere Auswahl an ARM-basierter Desktop-Hardware verfügbar ist.

Andere Compiler und Konfigurationen könnten funktionieren, werden aber nicht aktiv getestet.

Qt ist auch von der Verfügbarkeit verschiedener Bibliotheken und Entwicklungspakete abhängig, die typischerweise über den Paketmanager der jeweiligen Auflösung installiert werden. Siehe Qt für X11 Anforderungen für Details.

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 in diesem Verzeichnis aus:

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

Standardmäßig wird Qt für die Installation im Verzeichnis /usr/local/Qt-6.8.2 konfiguriert. Dies kann mit der Option -prefix geändert werden. Sehen Sie sich die Liste der Konfigurationsoptionen an, um weitere Anpassungen vorzunehmen.

Wurde configure erfolgreich ausgeführt? Dann fahren Sie mit der Erstellung der Bibliotheken und Tools fort:

cmake --build . --parallel

Nach der Erstellung müssen Sie die Bibliotheken und Werkzeuge an der entsprechenden Stelle installieren (es sei denn, Sie haben ein Entwickler-Build aktiviert):

cmake --install .

Beachten Sie, dass dafü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 von der Kommandozeile aus arbeiten, sollten Sie die Qt-Werkzeuge zu Ihrem Standard PATH hinzufügen. Dazu gehen Sie wie folgt vor:

Fügen Sie in .profile (wenn Ihre Shell bash, ksh, zsh oder sh ist) die folgenden Zeilen hinzu:

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

In .login (wenn Ihre Shell csh oder tcsh ist), fügen Sie die folgende Zeile hinzu:

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

Wenn Sie Qt von einer IDE aus verwenden wollen, 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.