Publication sur Google Play

Qt pour Android fournit tout ce dont vous avez besoin pour développer, construire et emballer des applications Android. Ce guide vous montre comment configurer, créer et publier votre application sur Google Play Console.

Configuration de votre application

Configurez les paramètres de votre application Android à l'aide des API CMake ou en modifiant directement le manifeste. Les applications Android nécessitent divers paramètres dans les fichiers de construction AndroidManifest.xml et Gradle. Qt 6 fournit des API CMake pratiques pour gérer ces paramètres à partir de votre projet.

Définir les propriétés essentielles de l'application

Définissez le nom du paquetage de votre application, sa version et les exigences du SDK Android :

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
)

Configurer les icônes de l'application

Définissez l'icône de votre application et créez les fichiers d'icônes dans les répertoires appropriés :

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

Placez vos fichiers d'icônes dans :

<QT_ANDROID_PACKAGE_SOURCE_DIR>/res/drawable-<dpi>

Vous pouvez créer des fichiers d'icônes en utilisant :

• Qt Creator Générateur d'icônes Android
• Android Studio : Image Asset Studio
• Générateurs d'icônes Android en ligne

Optimiser l'emballage des plugins

Réduisez la taille de votre application en spécifiant les plugins à inclure. L'outil androiddeployqt peut inclure des plugins dont votre application n'a pas besoin au moment de l'exécution :

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

Documentation connexe

• Configuration du fichier manifeste de Qt pour Android
• L'outil androiddeployqt

Création de votre application

Créez votre application pour la publier et préparez-la pour la soumission à Google Play Console.

Configuration de la version de compilation

Google Play exige des versions de compilation. Les informations de débogage peuvent être incluses dans des fichiers séparés et sont encouragées pour améliorer le signalement des pannes :

qt-cmake -DCMAKE_BUILD_TYPE=Release

Assurez-vous que debuggable est défini sur false dans votre manifeste ou votre configuration Gradle.

Activer la prise en charge multi-ABI

Construisez votre application pour plusieurs architectures d'appareils afin de maximiser la compatibilité :

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

Créer des clés de signature

La console Google Play exige des versions d'applications signées. Google recommande d'utiliser la signature gérée par Google Play avec deux clés :

• Clé de signature: Générée et gérée par Google lorsque vous créez votre application dans Google Play Console.
• Clé de téléchargement: Gérée localement pour signer les paquets d'applications à télécharger.

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>

Générer des paquets d'applications (AAB)

La console Google Play accepte désormais principalement les paquets d'applications Android (AAB) au lieu des APK. Les paquets AAB permettent à Google Play d'optimiser la diffusion des applications pour chaque appareil.

cd build
cmake --build . --target aab

cmake --build . --target appname_make_aab

Documentation connexe

• Guide de signature des applications Play de Google
• FAQ sur l'offre groupée d'applications Android

Publication sur Google Play Console

Après avoir créé et signé votre application, publiez-la sur Google Play Console pour la distribuer.

Préparer le téléchargement

Avant le téléchargement :

1. Testez minutieusement votre application sur différents appareils et versions d'Android.
2. Préparez du matériel promotionnel (captures d'écran, descriptions, graphiques).
3. Consultez les règles et directives de Google Play en matière de contenu.

Créez votre application dans Google Play Console

1. Connectez-vous à Google Play Console
2. Créez une nouvelle application ou sélectionnez une application existante
3. Remplir le questionnaire sur les détails de l'application et la classification du contenu
4. Définir les paramètres de tarification et de distribution

Pour créer un compte si vous n'en avez pas, consultez le guide de configuration de Google Play Console.

Téléchargez votre pack d'applications

1. Accédez à Release > Production
2. Créer une nouvelle version
3. Téléchargez votre fichier AAB signé
4. Ajouter des notes de publication
5. Réviser et déployer la version

Ressources

• Créer et configurer votre application
• Guide de publication d'applications de Google
• Séminaires en ligne sur la console Google Play

Considérations particulières

Constructions à un seul ABI pour les projets hérités

Pour les versions de Qt qui ne prennent pas en charge les constructions multi-ABI (comme les projets qmake), construisez chaque architecture séparément avec des codes de version différents :

ANDROID_VERSION_CODE = <unique_version>

Envisagez d'utiliser un schéma de versionnement comme <Platform><ABI><AppVersion>:

• Plateforme : 1 pour Arm, 2 pour Intel
• Architecture : 32 pour 32-bit, 64 pour 64-bit

Exemple : La version 1.0 pour arm64-v8a utilise le code de version 16410.

Pour plus d'informations, consultez la documentation de Google sur les versions d'applications.