Voraussetzungen für Qt für Android

Um mit Qt Anwendungen für Android zu entwickeln, müssen Sie Ihre Entwicklungsumgebung mit den erforderlichen Tools und Abhängigkeiten einrichten. Diese Seite enthält eine Schritt-für-Schritt-Anleitung, die Ihnen den Einstieg erleichtert.

Voraussetzungen für die Android-Entwicklung

Um mit Qt für Android zu entwickeln, benötigen Sie folgende Voraussetzungen:

• Java Development Kit (JDK)
• Android-Befehlszeilentools, darunter:
  • Android NDK: zum Erstellen von C++-Code.
  • Android SDK Platform und Android SDK Build Tools: zum Erstellen von Android-Apps.
  • Android SDK Platform Tools: zum Bereitstellen und Verwalten von Android-Abhängigkeiten.

Installation der Voraussetzungen

Verwendung der Android-Entwicklungsumgebung von Qt Creator

Am einfachsten lassen sich die Abhängigkeiten über die in Qt Creator integrierte Android-Entwicklungskonfiguration verwalten. Wenn Sie Qt Creator nach der Installation von Qt für Android zum ersten Mal öffnen, werden Sie gefragt, ob Sie den Android-Setup-Assistenten ausführen möchten. Dabei wird auch OpenSSL für Android eingerichtet.

Verwendung eines vorhandenen SDK-Speicherorts

Wenn Sie bereits über ein Android-SDK-Setup verfügen, müssen Sie diesen Assistenten nicht ausführen. Gehen Sie stattdessen in Qt Creator zu „ Preferences > Devices > Android “ und wählen Sie die Pfade zu Ihrem vorhandenen JDK und SDK aus. Siehe gängige Android-SDK-Pfade. Weitere Informationen finden Sie unter Qt Creator: Einrichten der Android-Entwicklungsumgebung.

Manuelle Installation der Voraussetzungen

Wenn Sie die Voraussetzungen lieber manuell installieren möchten, führen Sie die folgenden Schritte aus.

1. Installieren Sie das Java Development Kit (JDK).

   Für die Qt-Entwicklung für Android ist JDK 21 oder höher erforderlich, das von einer der folgenden unterstützten Distributionen bereitgestellt wird:

   • Adoptium
   • OpenJDK
   • Java SE Development Kit

   Installieren Sie das JDK Ihrer Wahl. Falls Ihr Installationsprogramm die Umgebungsvariable ` JAVA_HOME `, die auf den Speicherort des installierten JDK verweist, nicht setzt, können Sie diese manuell festlegen. Beispielsweise unter Linux:

   sudo apt-get install openjdk-21-jdk
   export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64

   Oder unter macOS:

   brew install openjdk@21
   sudo ln -sfn "$(brew --prefix openjdk@21)/libexec/openjdk.jdk" \
       "/Library/Java/JavaVirtualMachines/openjdk-21.jdk"
   export JAVA_HOME="$(/usr/libexec/java_home -v 21)"

2. Installieren Sie die Android SDK-Befehlszeilentools. Laden Sie die neueste Version der Android SDK-Befehlszeilentools für Ihr Betriebssystem herunter und entpacken Sie sie in den unten angegebenen Pfad.

   Das Android SDK wird üblicherweise 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\

   Oder nutzen Sie den Paketmanager Ihres Betriebssystems, zum Beispiel für macOS:

   brew install android-commandlinetools

3. Installieren Sie die Android SDK-Plattform, die Build-Tools und die Platform-Tools.

   Stellen Sie sicher, dass Sie die SDK-Plattform, die Plattform-Tools und die Build-Tools installieren. Für Qt 6.12 verwenden Sie:

   sdkmanager "platform-tools" "platforms;android-36" "build-tools;36.0.0"

4. Installieren Sie das Android NDK.

   Qt 6.12 verwendet das NDK 27.2.12479018. Sie können es mit folgendem Befehl installieren:

   sdkmanager "ndk;27.2.12479018"

5. (Optional) Installieren Sie den Android-Emulator.

   Wenn Sie den Android-Emulator verwenden möchten, können Sie ihn mit folgendem Befehl installieren:

   sdkmanager "emulator"

6. Plattformspezifische Konfigurationen
   • Unter Windows müssen Sie den zusätzlichen USB-Treiber installieren, der im „Extras“-Paket des Android SDK enthalten ist. Führen Sie dazu den folgenden Befehl aus:

     sdkmanager.bat "extras;google;usb_driver"

   • Unter Linux sind die folgenden Abhängigkeiten erforderlich, um Tools wie adb oder gdb zu nutzen, die über Qt Creator verwendet werden können:

     sudo apt-get install libstdc++6 libncurses5

     Hinweis: Für eine akzeptable Leistung des Android-Emulators istHardwarebeschleunigung erforderlich. Ohne diese nutzt der Emulator eine softwarebasierte CPU-Emulation, die extrem langsam läuft. Weitere Informationen finden Sie unter „Android: Emulatorbeschleunigung “.

Testen der Konfiguration

Nachdem Sie die Voraussetzungen installiert und konfiguriert haben, können Sie Ihre Entwicklungsumgebung testen, indem Sie die mit der Qt-Installation mitgelieferten Beispiele ausführen. Weitere Informationen finden Sie unter „Mobile Beispiele“.