Veröffentlichung auf Google Play

Qt für Android bietet Ihnen alles, was Sie zum Entwickeln, Erstellen und Verpacken von Android-Apps benötigen. Diese Anleitung zeigt Ihnen, wie Sie Ihre App 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 der Datei „ AndroidManifest.xml “ und in den Gradle-Build-Dateien. Qt 6 bietet praktische CMake-APIs, mit denen Sie diese Einstellungen direkt aus Ihrem Projekt heraus verwalten können.

Wichtige App-Eigenschaften festlegen

Legen Sie den Paketnamen, die Version und die Android-SDK-Anforderungen Ihrer App fest:

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 Symbol-Dateien in den richtigen Verzeichnissen:

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

Speichern Sie Ihre Symbol-Dateien unter:

<QT_ANDROID_PACKAGE_SOURCE_DIR>/res/drawable-<dpi>

Sie können Symbol-Dateien mit folgenden Tools erstellen:

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

Optimieren Sie die Plugin-Paketierung

Reduzieren Sie die Größe Ihrer App, indem Sie festlegen, welche Plugins einbezogen werden sollen. Das Tool „androiddeployqt“ bindet möglicherweise Plugins ein, 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

• Konfiguration der Manifest-Datei für Qt auf Android
• Das Tool „androiddeployqt“

Erstellen Ihrer App

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

Release-Build konfigurieren

Google Play erfordert Release-Builds. Debug-Informationen können als separate Dateien beigefügt werden; dies wird im Hinblick auf eine bessere Absturzberichterstattung empfohlen:

qt-cmake -DCMAKE_BUILD_TYPE=Release

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

Aktivieren Sie die Multi-ABI-Unterstützung

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

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

Signaturschlüssel erstellen

Die Google Play Console erfordert signierte App-Veröffentlichungen. Google empfiehlt die Verwendung der von Google Play verwalteten Signierung mit zwei Schlüsseln:

• Signaturschlüssel: Wird von Google generiert und verwaltet, wenn Sie Ihre App in der Google Play Console erstellen
• Upload-Schlüssel: Wird 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>

App-Bundles (AAB) generieren

Die Google Play Console akzeptiert nun hauptsächlich Android App Bundles (AAB) anstelle von APKs. AAB-Pakete ermöglichen es Google Play, die Bereitstellung der App für jedes Gerät zu optimieren.

cd build
cmake --build . --target aab

cmake --build . --target appname_make_aab

Weiterführende Dokumentation

• Google-Leitfaden zur Signierung von Play-Apps
• Häufig gestellte Fragen zu Android App Bundles

Veröffentlichung in der Google Play Console

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

Vorbereitung für den Upload

Vor dem Hochladen:

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

Erstellen Sie Ihre App in der Google Play Console

1. Melden Sie sich bei der Google Play Console an
2. Erstellen Sie eine neue App oder wählen Sie eine bestehende aus
3. Füllen Sie den Fragebogen zu den App-Details und der Inhaltsbewertung aus
4. Legen Sie die Preis- und Vertriebsoptionen fest

Wenn Sie noch kein Konto haben, lesen Sie die Anleitung zur Einrichtung der Google Play Console.

Laden Sie Ihr App-Bundle hoch

1. Navigieren Sie zu „ Release “ > Production
2. „Neue Version erstellen“
3. Laden Sie Ihre signierte AAB-Datei hoch
4. Fügen Sie Versionshinweise hinzu
5. Überprüfen und veröffentlichen Sie die Version

Ressourcen

• Erstellen und richten Sie Ihre App ein
• Googles Leitfaden zur Veröffentlichung von Apps
• Webinare zur Google Play Console

Besondere Hinweise

Single-ABI-Builds für ältere Projekte

Bei Qt-Versionen, die keine Multi-ABI-Builds unterstützen (z. B. qmake-Projekte), erstellen Sie für jede Architektur einen separaten Build mit unterschiedlichen Versionscodes:

ANDROID_VERSION_CODE = <unique_version>

Erwägen Sie die Verwendung eines Versionsschemas 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: Release 1.0 für arm64-v8a verwendet den Versionscode 16410.

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