Auf dieser Seite

Qt für Android – Kompilieren aus dem Quellcode

Auf dieser Seite wird beschrieben, wie Sie Qt für Android konfigurieren und erstellen. Um eine vorgefertigte Version von Qt für Android herunterzuladen und zu installieren, befolgen Sie die Anweisungen auf der Seite „Erste Schritte mit Qt “.

Voraussetzungen

Um Qt für Android aus dem Quellcode zu erstellen, stellen Sie bitte sicher, dass alle Anforderungen unter „Voraussetzungen für Qt für Android“ erfüllt sind, bevor Sie fortfahren.

Windows

Für die Kompilierung von Qt für Android unter Windows ist außerdem folgende Software erforderlich:

  • Mingw-w64 13.1-Toolchain

Hinweis: Qt für Android unterstützt die Kompilierung aus dem Quellcode mit Microsoft Visual C++ (MSVC) nicht.

Installieren Sie die Voraussetzungen und fügen Sie deren Binärpfade der System PATH hinzu:

set MINGW_ROOT=<MINGW_ROOT_PATH>\bin
set PATH=%MINGW_ROOT%;%PATH%

Um die Installation zu überprüfen, führen Sie folgenden Befehl aus:

where mingw32-make.exe

Der Befehl sollte mingw32-make.exe unter dem Pfad <MINGW_ROOT> an erster Stelle auflisten.

Beziehen der Quellcodes

Sie können die Qt-Quellcodes von der Qt-Download- Seite herunterladen oder der Wiki-Anleitung zum Herunterladen des Quellcodes folgen.

Konfigurieren

Mit Qt 6 können Sie Qt für Android aus dem Quellcode mit „ CMake “ kompilieren. Qt 6 für Android erfordert einen Host-Qt-Build, d. h., um Qt für Android zu kompilieren, müssen Sie Qt für die als Host verwendete Desktop-Plattform (also Linux, macOS oder Windows) kompilieren. Weitere Informationen finden Sie unter „Cross-Compiling von Qt “.

Um Qt für Android zu konfigurieren, erstellen Sie ein Schatten-Build-Verzeichnis, um das Quellverzeichnis übersichtlich zu halten:

mkdir -p ~/dev/build-qt-android
cd ~/dev/build-qt-android

Qt für Android unterstützt die folgenden Gerätearchitekturen (ABIs): arm64-v8a, x86_64, x86 und armeabi-v7a

Führen Sie anschließend das „configure“-Skript aus dem soeben erstellten Build-Verzeichnis aus:

<qt5_super_repo_path>/configure -prefix <install_path> -qt-host-path <qt_host_path> \
    -android-abis <abi> -android-sdk ~/Android/Sdk -android-ndk ~/Android/Sdk/ndk/27.2.12479018

Das Android SDK wird in der Regel von Qt Creator oder Android Studio an den folgenden Speicherorten installiert:

  • Linux: ~/Android/Sdk/
  • macOS: ~/Library/Android/sdk/
  • Windows: C:\Users\<USER>\AppData\Local\Android\Sdk\

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

Erweiterte „configure“-Argumente

Bevor Sie diesen Abschnitt lesen, sollten Sie den Abschnitt „Qt-Configure-Optionen“ lesen, der weitere Informationen zu den „configure“-Optionen enthält.

Qt für Android enthält Java-Code, der mit dem javac -Compiler in *.jar-Dateien kompiliert wurde. Um die javac -Version für Quelle und Ziel festzulegen, verwenden Sie jeweils -android-javac-source und -android-javac-target:

-android-javac-source 17 -android-javac-target 17

Um Qt als Entwickler-Build statt als Präfix-Build zu erstellen, verwenden Sie anstelle des Arguments „ -prefix “ Folgendes:

-developer-build

„ -qt-host-path “ sollte in einem Host-Entwickler-Build auf das Verzeichnis „ qtbase “ im Host-Build-Verzeichnis verweisen. Beispiel: „ ~/dev/build-qt-host/qtbase “.

Erstellen

Um Qt zu erstellen, führen Sie den folgenden Befehl aus:

cmake --build . --parallel

Installation

Um Qt bei Präfix-Builds zu installieren, führen Sie den folgenden Befehl aus:

cmake --install .

Unter Unix wird die Installation unter „ /usr/local/Qt-<version> “ abgelegt, wenn Sie die Konfigurationsoption „ -prefix <install_path> “ nicht angegeben haben. In diesem Fall müssen Sie beim Installationsbefehl „ sudo “ verwenden.

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