Convertir APK en AAB

Google Play requiert des Android App Bundles pour les nouveaux envois d'applications, de sorte qu'un développeur peut avoir besoin d'un AAB lorsqu'une ancienne build n'existe que sous forme d'APK. Un APK peut être installé directement, mais un AAB doit normalement être recompilé à partir du projet Android d'origine ou reconstruit localement à partir de l'APK.

Qu'est-ce que le format APK ?

Un APK est un package d'application Android que les téléphones, tablettes, appareils Android TV et émulateurs installent directement. Il s'agit d'une archive basée sur ZIP contenant le code compilé, les ressources, le manifeste, les assets, les bibliothèques natives et les informations de signature de l'APK.

Android Studio et Android Gradle Plugin génèrent des APK via des tâches Gradle telles que ./gradlew assembleRelease. Les développeurs reçoivent également des APK depuis des serveurs de build, des services de test, l'extraction depuis des appareils et la distribution en dehors de Google Play. Un APK est un format d'installation ; un appareil Android n'installe pas directement un AAB.

Qu'est-ce que le format AAB ?

Un AAB, ou Android App Bundle, est un package de publication contenant les modules et les ressources compilés d'une application. Google Play le traite pour générer des APK spécifiques à chaque appareil, en sélectionnant la densité d'écran, les ressources linguistiques, l'architecture du processeur et les dynamic features requis, au lieu de tout fournir dans un APK universel.

Cela peut réduire la taille du téléchargement et permet d'utiliser Google Play Feature Delivery et Play Asset Delivery. Un AAB est normalement produit à partir d'un projet Android Studio ou Gradle avec ./gradlew bundleRelease, ce qui crée généralement app/build/outputs/bundle/release/app-release.aab. La release build doit disposer d'une configuration de signature valide avant de pouvoir être importée.

Comment créer un AAB à partir du projet d'origine

1. Ouvrez le projet dans une version compatible d'Android Studio et synchronisez ses versions de Gradle et d'Android Gradle Plugin. Utilisez les versions requises par le projet plutôt que de les mettre à niveau sans distinction.
2. Vérifiez l'application ID, le version code, les dépendances de release, les product flavors, les bibliothèques natives, les déclarations du manifeste et la configuration de signature.
3. Dans Android Studio, sélectionnez Build → Generate Signed Bundle / APK, choisissez Android App Bundle, sélectionnez la release variant et fournissez le keystore ainsi que les identifiants de la clé. Vous pouvez également exécuter ./gradlew bundleRelease depuis le répertoire du projet.
4. Récupérez le résultat dans app/build/outputs/bundle/release/. Un projet multi-module peut placer le bundle dans le répertoire de sortie du module concerné.
5. Validez et testez le bundle avec l'outil officiel bundletool de Google. Par exemple, bundletool validate --bundle=app-release.aab vérifie sa structure. Pour créer des APK installables sur un appareil connecté, exécutez bundletool build-apks --bundle=app-release.aab --output=app.apks --connected-device, en fournissant les options de keystore requises si bundletool doit signer les APK générés, puis exécutez bundletool install-apks --apks=app.apks.

Android Studio est l'option de bureau appropriée, car il préserve la configuration Gradle, le traitement des ressources, la signature, les build variants et les modules dynamic-feature. bundletool est l'utilitaire en ligne de commande de Google permettant de valider, inspecter, générer et installer des APK sets à partir d'un AAB ; il ne convertit pas un APK final arbitraire en projet source ou en bundle équivalent.

Si seul l'APK est disponible

Il n'existe pas de conversion fiable en une seule commande d'un APK final vers un AAB équivalent. La compilation, le traitement des ressources, la réduction du code, la résolution des dépendances et la signature ont déjà été effectués, et l'APK ne contient pas le projet Gradle complet requis pour reproduire ces étapes.

Pour une application dont vous êtes propriétaire, une reconstruction est possible, mais il s'agit d'une nouvelle build plutôt que d'une conversion de format de fichier :

1. Décodez les ressources et le manifeste avec apktool d app.apk -o decoded-app.
2. Inspectez le code décompilé de type Java ou Kotlin avec jadx-gui app.apk. La sortie décompilée sert de référence et nécessite généralement d'importantes corrections avant de pouvoir être compilée.
3. Créez un projet Android Studio et restaurez la structure des packages, les ressources, les assets, les déclarations du manifeste, les bibliothèques natives, les dépendances, les paramètres Gradle et tous les modules dynamic-feature requis.
4. Résolvez les différences de compilation et d'exécution, configurez l'application ID et le version code corrects, puis générez et signez le bundle de release avec ./gradlew bundleRelease.

Les convertisseurs APK-to-AAB génériques en ligne ne constituent pas une solution adaptée à ce processus. Aucun service en ligne réputé ne peut récupérer de manière fiable le code source et la configuration de build manquants à partir d'un APK, et l'importation d'un APK peut exposer du code propriétaire, des identifiants intégrés, des certificats ou des données d'application. Effectuez la reconstruction localement ; utilisez Google Play Console uniquement pour importer et tester l'AAB obtenu.

Limitations de compatibilité et de publication

• Un bundle reconstruit peut se comporter différemment, car l'obfuscation, les ressources supprimées, le code généré, les paramètres de build natif et les versions des dépendances peuvent ne pas être récupérables à partir de l'APK.
• Une mise à jour doit utiliser le même application ID et une identité de signature acceptée pour l'application existante. Avec Google Play App Signing, l'importation doit utiliser la clé d'importation enregistrée ; posséder un APK ne donne pas l'autorisation de publier une mise à jour.
• Un APK extrait d'un appareil peut ne représenter qu'un seul split d'une application installée. Une installation complète peut contenir des APK split de base, de configuration et de fonctionnalités, de sorte qu'un seul split extrait ne peut pas recréer le bundle d'origine.
• Un AAB est un format de publication, et non un format normal de sideloading. Pour une installation directe, générez un APK ou utilisez bundletool afin de créer l'APK set approprié à partir du bundle.
• Testez la sortie de release sur des versions Android, des densités d'écran et des architectures de processeur représentatives, en particulier après la reconstruction de bibliothèques natives ou de dynamic features.