Veröffentlichen auf Google Play

Qt für Android bietet alles, was Sie zum Entwickeln, Erstellen und Verpacken von Android-Anwendungen benötigen. Diese Anleitung zeigt Ihnen, wie Sie Ihre Anwendung konfigurieren, erstellen und in der Google Play Console veröffentlichen.

Konfigurieren Ihrer App

Konfigurieren Sie die Einstellungen Ihrer Android-App mithilfe von CMake-APIs oder durch direkte Bearbeitung des Manifests. Android-Apps erfordern verschiedene Einstellungen in AndroidManifest.xml und Gradle-Build-Dateien. Qt 6 bietet praktische CMake-APIs, um diese von Ihrem Projekt aus zu verwalten.

Wesentliche App-Eigenschaften festlegen

Definieren Sie den Paketnamen, die Version und die Android SDK-Anforderungen für Ihre App:

set_target_properties(${appname} PROPERTIES
    QT_ANDROID_PACKAGE_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/android"
    QT_ANDROID_PACKAGE_NAME "io.qt.calqlatr"
    QT_ANDROID_APP_NAME "Calqlatr"
    QT_ANDROID_TARGET_SDK_VERSION 35
    QT_ANDROID_MIN_SDK_VERSION 28
    QT_ANDROID_VERSION_NAME "1.0"
    QT_ANDROID_VERSION_CODE 10
)

App-Symbole konfigurieren

Legen Sie Ihr App-Symbol fest und erstellen Sie die Symboldateien in den richtigen Verzeichnissen:

set_target_properties(${appname} PROPERTIES
    QT_ANDROID_APP_ICON "@drawable/ic_launcher"
)

Platzieren Sie Ihre Icon-Dateien in:

<QT_ANDROID_PACKAGE_SOURCE_DIR>/res/drawable-<dpi>

Sie können Icon-Dateien mit erstellen:

• Qt Creator Android Icon Generator
• Android Studio: Image Asset Studio
• Online-Generatoren für Android-Symbole

Optimieren der Plugin-Paketierung

Verringern Sie die Größe Ihrer App, indem Sie angeben, welche Plugins eingebunden werden sollen. Das androiddeployqt Tool kann Plugins einschließen, die Ihre App zur Laufzeit nicht benötigt:

qt_import_plugins(${appname}
    INCLUDE_BY_TYPE imageformats Qt::QSvgPlugin Qt::QJpegPlugin
    EXCLUDE_BY_TYPE iconengines networkinformation tls platforminputcontexts qmltooling
)

Zugehörige Dokumentation

• Qt für Android Manifest Datei Konfiguration
• Das androiddeployqt Werkzeug

Erstellen Ihrer Anwendung

Erstellen Sie Ihre App für die Veröffentlichung und bereiten Sie sie für die Einreichung in der Google Play Console vor.

Konfigurieren Sie den Release-Build

Für Google Play sind Release-Builds erforderlich. Debug-Informationen können als separate Dateien beigefügt werden und sind für eine bessere Meldung von Abstürzen zu empfehlen:

qt-cmake -DCMAKE_BUILD_TYPE=Release

Stellen Sie sicher, dass debuggable in Ihrem Manifest oder der Gradle-Konfiguration auf false gesetzt ist.

Aktivieren Sie Multi-ABI-Unterstützung

Erstellen Sie Ihre Anwendung für mehrere Gerätearchitekturen, um die Kompatibilität zu maximieren:

qt-cmake -DQT_ANDROID_BUILD_ALL_ABIS:BOOL=ON ...

Signierschlüssel erstellen

Die Google Play Console erfordert signierte App-Versionen. Google empfiehlt die Verwendung von Google Play Managed Signing mit zwei Schlüsseln:

• Signierschlüssel: Erzeugt und verwaltet von Google, wenn Sie Ihre App in der Google Play Console erstellen
• Upload-Schlüssel: Lokal verwaltet, um App-Bundles für den Upload zu signieren

keytool -genkey -keyalg RSA -keystore upload-key.keystore \
    -alias play_apps \
    -storepass <password> -keypass <key-password> \
    -dname "CN=<n>, OU=<unit>, O=<organisation>, L=<city>, ST=<state>, C=<country>"

qt-cmake -DQT_ANDROID_SIGN_APK:BOOL=ON -DQT_ANDROID_SIGN_AAB:BOOL=ON ...

export QT_ANDROID_KEYSTORE_PATH=upload-key.keystore
export QT_ANDROID_KEYSTORE_ALIAS=play_apps
export QT_ANDROID_KEYSTORE_STORE_PASS=<password>
export QT_ANDROID_KEYSTORE_KEY_PASS=<key-password>

Erzeugen von App-Bundles (AAB)

Die Google Play-Konsole akzeptiert jetzt in erster Linie Android App Bundles (AAB) anstelle von APKs. AAB-Pakete ermöglichen es Google Play, die App-Bereitstellung für jedes Gerät zu optimieren.

cd build
cmake --build . --target aab

cmake --build . --target appname_make_aab

Verwandte Dokumentation

• Googles Play App Signing Anleitung
• Android App Bundle FAQ

Veröffentlichen in der Google Play-Konsole

Nachdem Sie Ihre App erstellt und signiert haben, veröffentlichen Sie sie zur Verteilung in der Google Play Console.

Für den Upload vorbereiten

Vor dem Hochladen:

1. Testen Sie Ihre App gründlich auf verschiedenen Geräten und Android-Versionen
2. Bereiten Sie Werbematerialien vor (Screenshots, Beschreibungen, Funktionsgrafiken)
3. Lesen Sie die Inhaltsrichtlinien von Google Play.

Erstellen Sie Ihre App in der Google Play-Konsole

1. Melden Sie sich bei der Google Play-Konsole an.
2. Erstellen Sie eine neue App oder wählen Sie eine bestehende App aus
3. Füllen Sie den Fragebogen zu den App-Details und zur Inhaltsbewertung aus
4. Einrichten von Preis- und Vertriebseinstellungen

Um ein Konto zu erstellen, wenn Sie noch keines haben, lesen Sie die Anleitung zur Einrichtung der Google Play Console.

Laden Sie Ihr App-Bündel hoch

1. Navigieren Sie zu Release > Production
2. Erstellen Sie eine neue Version
3. Laden Sie Ihre signierte AAB-Datei hoch
4. Fügen Sie Versionshinweise hinzu
5. Überprüfen und Ausrollen der Version

Ressourcen

• Erstellen und Einrichten Ihrer App
• Leitfaden zur Veröffentlichung von Apps von Google
• Webinare zur Google Play-Konsole

Besondere Überlegungen

Single-ABI-Builds für Legacy-Projekte

Für Qt-Versionen, die keine Multi-ABI-Builds unterstützen (wie z.B. qmake-Projekte), bauen Sie jede Architektur separat mit unterschiedlichen Versionscodes:

ANDROID_VERSION_CODE = <unique_version>

Erwägen Sie die Verwendung eines Versionierungsschemas wie <Platform><ABI><AppVersion>:

• Plattform: 1 für Arm, 2 für Intel
• Architektur: 32 für 32-Bit, 64 für 64-Bit

Beispiel: Version 1.0 für arm64-v8a verwendet den Versionscode 16410.

Weitere Informationen finden Sie in der Dokumentation von Google zur App-Versionierung.