Qt für Android - Erstellung aus dem Quellcode

Diese Seite beschreibt den Prozess des Konfigurierens und Erstellens von Qt für Android. Um ein vorgefertigtes Qt für Android herunterzuladen und zu installieren, folgen Sie den 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 aus Erste Schritte mit Qt für Android erfüllt sind, bevor Sie fortfahren.

Windows

Die Erstellung von Qt für Android unter Windows erfordert außerdem die folgende Software:

  • Mingw-w64 13.1 Toolchain

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

Installieren Sie die Voraussetzungen und fügen Sie deren Binärpfade an das System PATH an:

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

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

where mingw32-make.exe

Der Befehl sollte zunächst mingw32-make.exe unter dem Pfad <MINGW_ROOT> auflisten.

Beschaffung der Quellen

Sie können die Qt-Quellen von der Qt-Download-Seite herunterladen oder der Wiki-Anleitung für die Beschaffung des Quellcodes folgen.

Konfigurieren von

Mit Qt 6 können Sie Qt für Android aus dem Quellcode mit CMake erstellen. Qt 6 für Android erfordert einen Qt-Host-Build, d.h. um Qt für Android zu erstellen, müssen Sie Qt für die als Host verwendete Desktop-Plattform (d.h. Linux, macOS oder Windows) erstellen.

Um einen minimalistischen Host-Build zu konfigurieren und auszuführen, der mit einem Qt für Android-Build verwendet werden kann, verwenden Sie den folgenden Befehl:

mkdir ~/dev/build-host
cd ~/dev/build-host
./configure -developer-build -nomake tests -nomake examples
cmake --build . --target host_tools

Damit wird ein Entwickler-Build für Ihren Host konfiguriert und nur die notwendigen Abhängigkeiten für den Android-Build gebaut. Weitere Informationen zum Erstellen eines vollständigen und anpassbaren Builds für Ihren Host finden Sie unter Erstellen von Qt-Quellen.

Um Qt für Android zu konfigurieren, erstellen Sie ein Shadow-Build-Verzeichnis, um das Quellverzeichnis sauber 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

Und führen Sie dann das configure-Skript aus:

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

Das Android SDK wird üblicherweise von Qt Creator oder Android Studio an den folgenden Stellen installiert:

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

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.

Erweiterte Konfigurationsargumente

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

-android-javac-source 8 -android-javac-target 8

Um Qt als Entwickler-Build anstelle eines Präfix-Builds zu erstellen, verwenden Sie das folgende Argument anstelle von -prefix:

-developer-build

Hinweis: Wenn Sie dieses configure-Argument verwenden, ist es nicht erforderlich, Ihren Qt-Build zu installieren; Qt für Android kann direkt aus dem Build-Verzeichnis heraus verwendet werden.

Qt Configure Options enthält weitere Informationen über die configure-Optionen.

Erstellen von

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

cmake --build . --parallel

Installieren

Für Präfix-Builds, um Qt zu installieren, führen Sie den folgenden Befehl aus:

cmake --install .

Unter Unix, wenn Sie die Option -prefix <install_path> configure nicht angegeben haben, wird die Installation unter /usr/local/Qt-<version> durchgeführt. In diesem Fall müssen Sie sudo mit dem Installationsbefehl verwenden.

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