Convertir AAB en APK en ligne : ce que fait réellement cet outil
L'Android App Bundle (.aab) est le format que Google Play demande aux développeurs de télécharger, mais ce n'est pas quelque chose que vous pouvez installer sur un téléphone. Si vous disposez d'un fichier .aab provenant d'un serveur de build, d'un pipeline CI ou d'un collègue, vous devez d'abord le transformer en un .apk installable. Cette page vous propose deux éléments pour ce travail : un Générateur de commandes AAB vers APK interactif qui écrit la commande bundletool exacte pour votre système d'exploitation et un Explorateur de fichiers AAB qui ouvre le bundle dans votre navigateur afin que vous puissiez voir ce qu'il contient avant de le convertir.
La conversion elle-même s'effectue via le bundletool officiel de Google, qui est un programme Java. Étant donné que bundletool a besoin du runtime Java et de l'accès à votre magasin de clés, l'étape de construction proprement dite se déroule sur votre propre machine, et non sur nos serveurs. Votre fichier .aab n’est jamais téléchargé nulle part. Le constructeur supprime simplement les incertitudes afin que vous puissiez copier une commande correcte et prête à être exécutée au lieu de mémoriser les noms des indicateurs.
AAB vs APK : pourquoi vous ne pouvez pas simplement renommer le fichier
Beaucoup de gens cherchent comment changer AAB en APK en renommant l'extension, et cela ne fonctionne jamais. Un .apk est un package unique et autonome qu’Android peut installer directement. Un .aab est un conteneur de publication : il contient votre code compilé et vos ressources divisées en modules, et il attend de Google Play ou de bundletool qu'il génère les APK finaux optimisés pour l'appareil. Renommer le fichier ne décompresse pas ces modules et ne signe rien, donc Android refuse de l'installer. Le seul moyen fiable de convertir un Ensemble d'applications Android vers APK est de laisser bundletool créer l’ensemble APK pour vous.
Comment convertir AAB en APK sur Windows, Mac et Linux
Les étapes sont les mêmes sur chaque plate-forme et seul le style du chemin de fichier change, c'est pourquoi le générateur de commandes ci-dessus dispose d'un commutateur Windows, macOS et Linux. Voici le déroulement complet du début à la fin :
- Installez Java JDK 8 ou version ultérieure. Exécutez java -version dans un terminal pour confirmer que Java est sur votre PATH.
- Téléchargez l'outil bundle. Obtenez la dernière version de bundletool-all.jar sur la page officielle des versions GitHub de Google.
- Créez l’ensemble APK. Pointez bundletool sur votre bundle et laissez-le produire une archive .apks : java -jar bundletool-all.jar build-apks --bundle=app.aab --output=app.apks --mode=universal
- Ouvrez l'archive .apks. Ce n'est qu'un fichier ZIP, alors extrayez-le et vous trouverez universal.apk à l'intérieur.
- Installez sur votre appareil. Copiez l'APK sur votre téléphone et chargez-le, ou utilisez bundletool install-apks avec un appareil connecté via USB.
APK universel ou APK fractionné : lequel devriez-vous créer?
Si vous souhaitez un fichier qui s'installe sur n'importe quel téléphone, utilisez --mode=universal. Cela crée un seul APK universel depuis votre AAB qui regroupe chaque architecture de processeur, densité d'écran et langage dans un seul package. Il est plus grand, mais c'est l'option la plus simple pour tester, archiver ou partager une version en dehors du Play Store. Si vous laissez le mode de côté, bundletool produit à la place des APK divisés qui sont découpés pour un appareil spécifique, de sorte qu'ils se téléchargent plus petits mais vous devez installer l'ensemble correspondant ensemble. Pour la plupart des personnes qui ont simplement besoin de convertir un fichier .aab pour une installation rapide, l’APK universel est le bon choix.
Signature de l'APK que vous obtenez d'un AAB
Android n'installera pas un APK s'il n'est pas signé. Pour les tests, bundletool peut signer automatiquement avec une clé de débogage, ce qui est exactement ce que fait l'option "Utiliser le magasin de clés de débogage" dans le générateur. Si vous préparez une version de version, par exemple pour la distribuer sur votre propre site Web, signez-la avec votre propre magasin de clés en remplissant les champs chemin du magasin de clés, mot de passe du magasin de clés, alias de clé et mot de passe de clé. Le constructeur ajoute ensuite les indicateurs --ks, --ks-pass, --ks-key-alias et --key-pass afin que l'APK que vous obtenez porte votre véritable signature de production au lieu d'une signature de débogage jetable.
Erreurs courantes de BundleTool et comment les corriger
Deux problèmes reviennent sans cesse. Le message « bundletool : commande introuvable » signifie que vous avez essayé d'exécuter bundletool comme s'il s'agissait d'une commande intégrée. Il s'agit d'un fichier JAR, vous l'appelez donc toujours avec java -jar bundletool-all.jar. L'erreur « Aucune clé/certificat » signifie que les détails de signature sont manquants : ajoutez --mode=universal pour une version de test non signée ou fournissez vos indicateurs de magasin de clés comme décrit ci-dessus. L'onglet Dépannage plus haut sur la page en couvre davantage, et l'explorateur AAB vous permet de confirmer que votre bundle contient réellement les modules que vous attendez avant de passer du temps à déboguer une commande.
Quand auriez-vous réellement besoin de convertir un AAB?
Les raisons habituelles sont de tester une version sur un appareil réel avant de la publier, de confier une version à un testeur qui n'utilise pas Google Play, de conserver une copie installable de votre propre application pour vos dossiers ou d'exécuter un contrôle qualité sur du matériel que les tests internes du Play Store n'atteignent pas. Quelle que soit la raison, convertissez uniquement les app bundles que vous avez le droit d’utiliser, tels que vos propres builds ou les bundles avec lesquels vous êtes clairement autorisé à travailler.