Publication sur Google Play

Qt pour Android fournit tout ce dont vous avez besoin pour développer, compiler et créer des paquets d'applications Android. Ce guide vous explique comment configurer, compiler et publier votre application sur la 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 le fichier « AndroidManifest.xml » et les fichiers de compilation Gradle. Qt 6 fournit des API CMake pratiques pour gérer ces paramètres depuis votre projet.

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

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

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 à l'aide de :

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

Optimisez le packaging 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 lors 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 associée

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

Compilation de votre application

Compilez votre application pour la version finale et préparez-la en vue de sa soumission à la Google Play Console.

Configurer la version de publication

Google Play exige des versions de publication. Les informations de débogage peuvent être incluses dans des fichiers séparés, ce qui est recommandé pour améliorer le signalement des plantages :

qt-cmake -DCMAKE_BUILD_TYPE=Release

Assurez-vous que le paramètre « debuggable » est défini sur « false » dans votre manifeste ou votre configuration Gradle.

Activez la prise en charge multi-ABI

Compilez votre application pour plusieurs architectures d'appareils afin d'optimiser la compatibilité :

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

Créer des clés de signature

Google Play Console exige que les versions de l'application soient 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 la Console Google Play
• Clé de téléchargement: gérée localement pour signer les paquets d'application avant leur téléchargement

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 App Bundles (AAB)

La Google Play Console accepte désormais principalement les App Bundles Android (AAB) à la place 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 associée

• Guide de Google sur la signature des applications Play
• FAQ sur les App Bundles Android

Publication sur Google Play Console

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

Préparation au téléchargement

Avant le téléchargement :

1. Testez minutieusement votre application sur différents appareils et différentes versions d'Android
2. Préparez les supports promotionnels (captures d’écran, descriptions, visuels illustrant les fonctionnalités)
3. Consultez les règles et directives relatives au contenu de Google Play

Créez votre application dans Google Play Console

1. Connectez-vous à Google Play Console
2. Créez une nouvelle application ou sélectionnez-en une existante
3. Remplissez le questionnaire sur les détails de l'application et la classification du contenu
4. Configurez 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 la Google Play Console.

Importez le fichier d'application

1. Accédez à « Release » > Production
2. Créer une nouvelle version
3. Importez votre fichier AAB signé
4. Ajoutez les notes de mise à jour
5. Vérifiez et déployez la version

Ressources

• Créer et configurer votre application
• Guide de publication d'applications de Google
• Webinaires sur la Google Play Console

Considérations particulières

Builds à ABI unique pour les projets hérités

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

ANDROID_VERSION_CODE = <unique_version>

Envisagez d'utiliser un schéma de numérotation des versions tel que <Platform><ABI><AppVersion>:

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

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

Pour plus de détails, consultez la documentation de Google sur la gestion des versions des applications.