KappS Base de connaissances · Blog

Google Play App Bundles en 2026 : AAB, splits et limites de

Blog Guide

Un Android App Bundle (AAB) est le format de publication exigé par Google Play pour les nouvelles applications depuis août 2021 — et c’est la raison pour laquelle deux personnes peuvent installer la même application et obtenir des tailles de téléchargement très différentes. Vous ne transmettez plus à Google Play un APK finalisé. Vous lui transmettez un bundle qui contient l’ensemble de votre code compilé et de vos ressources, ainsi que les instructions pour les assembler, et Google Play génère les APK fractionnés réellement installés sur chaque appareil.

Ce seul changement déplace beaucoup de décisions de votre script de build vers Play : quelle architecture CPU reçoit quelles bibliothèques natives, quelle densité d'écran reçoit quels drawables, quelle locale reçoit quelles chaînes. Il introduit aussi un ensemble de limites de taille strictes — et les limites ont changé. Le plafond du module de base n'est plus de 200 Mo. Les équipes qui planifient encore sur les anciens chiffres soit surdimensionnent leur stratégie de livraison, soit perdent un envoi à cause d'une erreur de taille qui semble inexplicable.

Ce guide couvre le paysage 2026 dans l’ordre où vous le rencontrez : ce que contient l’app bundle, les limites de taille actuelles, la façon dont les APK fractionnés sont assemblés, Play Feature Delivery et Play Asset Delivery, les règles de code de version pour les APK générés, les tests avec bundletool et la liste de vérification à dérouler avant l’envoi.


1. Ce que contient réellement un app bundle

Un app bundle est l’artefact .aab que vous téléversez à la place d’un APK. La formulation d’Google est précise : il contient tout le code compilé et les ressources de votre application, et confie à Google Play la génération et la signature de l’APK. Vous y trouverez :

  • Le module de base — le code, les ressources et le manifeste dont chaque appareil a besoin. Il porte le code de version et le nom de version de l'application, ce qui est plus important qu'il n'y paraît.
  • Modules de fonctionnalités — du code et des ressources livrables à l’installation, à la demande ou de façon conditionnelle, selon l’appareil ou le pays.
  • Packs d'éléments — fichiers volumineux (éléments de jeu, médias, modèles ML) livrés via Play Asset Delivery plutôt que par le système de modules.
  • Métadonnées de ciblage par appareil — les réglages du manifeste qui permettent à Play de décider quels éléments vont sur quel appareil : ABI, densité d’écran, langue et le nouveau ciblage par compression de textures pour les packs d’assets.

Le bundle lui-même n’est jamais installé sur un appareil. C’est une source de distribution, pas un package.

2. Ce que « split » signifie pour l’utilisateur

Quand un utilisateur appuie sur Installer, Play construit un ensemble d'APK pour cette configuration d'appareil précise, les signe et les sert. Les splits classiques sont :

  • Splits ABI — arm64-v8a, armeabi-v7a, x86_64. Un téléphone récent télécharge une architecture au lieu de quatre.
  • Répartition par densité d’écran — un téléphone 420 dpi ne paie pas pour des assets raster 640 dpi.
  • Répartition par langue — les chaînes destinées à des locales que l'appareil n'a jamais demandées restent sur le serveur.
  • Répartition des modules dynamiques et des packs d’assets — tout ce que vous avez marqué pour une livraison à la demande.

Ainsi, la « taille de téléchargement » dans la Play Console n’est pas un chiffre unique : c’est une plage couvrant plusieurs configurations, et la page Taille de l’application indique à la fois la valeur pour l’appareil de référence et cette plage. Juger une version sur un seul APK compilé en local, c’est ainsi que des équipes finissent par être surprises par le taux de conversion des installations.

3. Les limites de taille 2026

Ces chiffres proviennent de l’aide Play Console et servent de base à votre planification. Notez à quel point le plafond du module de base s’est éloigné des 200 Mo qui circulent encore dans les anciens guides.

  • Module de base : limite de taille de téléchargement de 500 Mo.
  • Chaque module de fonctionnalité individuel : 500 Mo.
  • Chaque pack de ressources individuel : 1,5 Go.
  • Total cumulé pour tous les modules plus les packs de ressources à l’installation : 4 Go.
  • Total cumulé pour les packs de ressources à la demande et fast-follow : 30 Go.
  • Taille maximale globale de téléchargement compressé : 34 Go.

Quatre contraintes supplémentaires accompagnent ces chiffres :

  • Les applications de plus de 1 Go doivent cibler le SDK minimum Android 5.0 Lollipop (niveau d’API 21) ou supérieur.
  • Le maximum recommandé est de 100 modules de fonctionnalités lorsque l'application cible l'API 26 ou supérieure ; en dessous, le plafond est de 50.
  • Le nombre maximal d’asset packs dans un seul bundle est de 100.
  • Si l’application dépasse 200 Mo, les utilisateurs en connexion mobile voient une boîte de dialogue non bloquante les avertissant de la taille au moment de l’installation. Elle ne bloque pas l’installation ; elle coûte toutefois des conversions.

Un piège hérité du passé : les applications encore livrées en APK simple ne sont couvertes par aucune des limites ci-dessus. Elles restent soumises aux règles des APK hérités, dont le plafond est de 100 Mo par APK. Si un envoi est rejeté avec une erreur de taille qui ressemble à un message de 2019, vérifiez si l’artefact envoyé est bien un bundle.

4. De quel mécanisme avez-vous besoin ?

Trois mécanismes résolvent trois problèmes différents, et les confondre coûte des semaines.

  • Play Feature Delivery — des modules de code et de ressources. Utilisez-le lorsque vous voulez des fonctionnalités que tous les appareils ou marchés ne devraient pas installer.
  • Play Asset Delivery — ressources binaires volumineuses. À utiliser pour le contenu de jeu, la vidéo, l’audio, les modèles ML et les grands jeux de données lorsque l’empreinte d’installation compte.
  • Signature d'application Play — adjacent mais central : avec les bundles, Play signe les APK générés, ce qui explique pourquoi la gestion des clés et des codes de version a changé.

5. Play Feature Delivery : à l’installation, à la demande, conditionnel

Un module de fonctionnalité déclare l’un des trois modes de livraison dans son manifeste :

  1. à l’installation — le module fait partie de l’installation initiale. Les utilisateurs ne peuvent pas le contourner, et il compte dans la taille visible par l’utilisateur.
  2. à la demande — le module n’est pas installé tant que l’application ne le demande pas. Votre code doit gérer les états en attente, en téléchargement, terminé et échoué.
  3. conditional — le module n’est installé au moment de l’installation que si l’appareil remplit une condition que vous déclarez, comme les fonctionnalités de l’appareil, le pays de l’utilisateur ou la version minimale du SDK.

La livraison conditionnelle est la fonctionnalité que les équipes sous-utilisent le plus. Un module de fonctionnalité réservé aux tablettes, ou qui n’a de sens que là où opère un fournisseur de paiement particulier, n’a pas besoin d’être présent sur chaque appareil.

6. Play Asset Delivery : à l'installation, fast-follow, à la demande

  • Les packs install-time arrivent avec l’application. Ils comptent dans la taille d’installation — et dans la limite cumulée de 4 Go. Pratique, mais cela reste une partie du chiffre que les utilisateurs voient dans la fiche App Store.
  • Les packs fast-follow commencent à se télécharger automatiquement dès la fin de l’installation, en arrière-plan. L’utilisateur peut ouvrir l’application immédiatement ; les ressources arrivent peu après.
  • Les packs à la demande ne se téléchargent que lorsque l’application les demande. C’est là que se trouvent les gros volumes : les packs à la demande et fast-follow disposent d’une limite cumulée de 30 Go précisément parce qu’ils n’entrent pas en concurrence avec la conversion à l’installation.

Les packs d’assets prennent aussi en charge le ciblage par compression de textures, ce qui permet à Play de livrer le format de compression réellement pris en charge par le GPU de l’appareil au lieu d’embarquer tous les formats. Pour les jeux, c’est généralement le gain de taille le plus important disponible.

7. Codes de version lorsque Play génère les APK

Avec les bundles, vous cessez de gérer les codes de version par APK. Vous définissez un seul code de version dans le module de base, et après l’upload, Google Play attribue ce même code de version à chaque APK généré à partir de ce bundle. Tous les APK splittés d’une même installation partagent le code de version.

La conséquence est une question de discipline, pas de complexité : pour livrer une mise à jour, vous incrémentez le code de version du module de base et compilez un nouveau bundle complet. Lors de la mise à jour, Play sert les versions mises à jour de chaque APK actuellement installé sur l’appareil. Deux règles pratiques en découlent :

  • Ne conservez pas l’ancien schéma de code de version par ABI (l’astuce classique abiCodes * 1000 + versionCode). C’est un modèle hérité de découpage d’APK qui entre en collision avec les envois d’app bundles.
  • Si un système de build altère les codes de version d’un canal à l’autre, les envois échouent avec « version code already used » ou « lower than the existing version ». Le module de base est l’unique source de vérité.

8. Signature : la clé d’upload, pas la clé de signature d’application

Avec Play App Signing, l’artefact que vous téléversez est signé avec une clé de téléversement, et Play re-signe les APK générés avec la clé de signature d’application. La configuration de signature ne doit figurer que dans le module de base. Deux points piègent régulièrement les développeurs :

  • Si la clé d'importation est perdue, elle peut être réinitialisée via la Play Console — elle est récupérable. La clé de signature de l'application, elle, ne nécessite aucune intervention de votre part.
  • Si un bundle est signé avec la mauvaise clé, Play rejette l'import avant même que l'examen ne commence. C'est un problème de configuration de build qui se corrige en une ligne, pas un problème de politique.

9. Tester les APK fractionnés avant publication avec bundletool

Le plugin Gradle Android construit l’app bundle ; bundletool sert à le reconvertir en APK spécifiques à chaque appareil et à émuler localement la distribution de Play. Play utilise lui-même le même outil pour générer les APK, si bien que le comportement local reflète fidèlement la production.

# Générer un ensemble d’APK couvrant toutes les configurations d’appareils prises en charge bundletool build-apks \ --bundle=app-release.aab \ --output=app.apks \ --ks=upload-key.jks --ks-key-alias=upload # Déployer uniquement les splits correspondant à l’appareil connecté bundletool install-apks --apks=app.apks # Produire un APK universel pour un contrôle rapide bundletool build-apks --bundle=app-release.aab --output=app.apks --mode=universal # Activer le test local des modules à la demande et des packs d’assets bundletool build-apks --bundle=app-release.aab --output=app.apks --local-testing

L’option --local-testing écrit dans les manifestes de l’APK des métadonnées qui indiquent aux bibliothèques Play Core d’utiliser les splits locaux au lieu de contacter Play. Sans elle, le code de téléchargement à la demande ne peut pas être testé hors du store. Pour une spécification propre à un appareil, utilisez bundletool get-device-spec.

Avant un déploiement en production, le canal de test interne reste le moyen le moins coûteux de confirmer que les installations réelles résolvent les bons splits — y compris sur les appareils d’entrée de gamme que surveille votre analyse des plantages.

10. Consultez la page Taille de l’application avant toute optimisation

Une fois qu’une application a une version en production, la Play Console indique la taille de téléchargement sous Surveiller et améliorer, puis Android signaux vitaux, puis Taille de l’application. Elle affiche la taille de téléchargement de l’application sur un appareil de référence et la plage selon les configurations, une comparaison avec des pairs pour un groupe que vous définissez, l’évolution dans le temps, et deux métriques qui valent plus que le chiffre de taille lui-même :

  • Appareils actifs avec moins de 2 Go libres — quelle part de votre base installée subit une pression de stockage.
  • Désinstallations sur les appareils disposant de moins de 2 Go libres — le rapport entre les désinstallations sur ces appareils et les désinstallations globales. Une valeur élevée révèle un problème de taille déguisé en problème de rétention.

11. Liste de vérification avant téléversement

  1. L’artefact est un .aab, pas un APK universel.
  2. Le code de version du module de base est incrémenté à un seul endroit.
  3. La clé d’upload est configurée dans le module de base uniquement, et le keystore est sauvegardé ailleurs que sur un seul ordinateur portable.
  4. La taille de téléchargement compressée du module de base reste sous 500 Mo — et sous 200 Mo si vous voulez éviter l’avertissement sur les données mobiles à l’installation.
  5. Chaque module de fonctionnalité fait moins de 500 Mo, et l'ensemble des modules plus les packs d'installation restent sous la limite cumulée de 4 Go.
  6. Chaque pack d’assets fait moins de 1,5 Go, et les packs à la demande et fast-follow restent sous 30 Go.
  7. Pas plus de 100 packs d’assets, et dans les recommandations de 100 ou 50 modules de fonctionnalités pour votre SDK minimum.
  8. Le SDK minimum est l’API 21 ou supérieure si l’app dépasse 1 Go.
  9. Les fonctionnalités à la demande sont implémentées via les bibliothèques Play Core, avec une gestion explicite des états en attente, en téléchargement et en échec.
  10. Le ciblage de compression de textures est activé pour les packs d’assets où plus d’un format GPU est en jeu.
  11. Le bundle a été testé avec bundletool install-apks sur au moins un appareil d’entrée de gamme et un appareil arm64, plus --local-testing pour chaque chemin à la demande.
  12. La page Taille de l’application est examinée après la mise en ligne, y compris les métriques de l’espace gratuit inférieur à 2 Go.
  13. Le formulaire de sécurité des données et les déclarations de contenu correspondent toujours à ce que les nouveaux modules collectent réellement.
  14. Le texte de la fiche App Store et les captures d’écran décrivent encore l’application que l’utilisateur télécharge désormais, pas le build universel avec lequel vous avez testé.

12. Les échecs qui n’apparaissent qu’après la mise en ligne

  1. Un module à la demande ne se télécharge jamais car l'intégration Play Core suppose un succès et n'a aucun chemin de nouvelle tentative en cas de requête échouée ou annulée.
  2. Un pack d’éléments installé au moment de l’installation fait gonfler la taille de la fiche après un ajout de contenu, et la conversion des installations chute sans la moindre modification du code.
  3. Les modules conditionnels s’installent sur des appareils qui ne remplissent pas la condition parce qu’elle a été déclarée dans le mauvais manifeste.
  4. Collisions de codes de version lorsque la CI estampille le bundle alors qu’un ancien schéma par ABI est encore actif dans les fichiers de build.
  5. Une signature avec une mauvaise clé après une rotation de keystore jamais répercutée dans la configuration du module de base.
  6. Échecs au premier lancement sur connexions lentes lorsque le premier écran de l’application dépend d’un pack complémentaire qui n’est pas encore arrivé.
  7. Une incohérence de sécurité des données après l’arrivée d’un nouveau SDK dans un module nouvellement séparé que personne n’a re-déclaré.

13. Où se situe KappS

La taille de l’application et les modes de livraison relèvent de la même chaîne opérationnelle que le compte développeur, le profil de paiement et les informations fiscales : chacun d’eux peut discrètement bloquer une mise en ligne. KappS aide les développeurs à préparer et soumettre des éléments conformes sur toute cette chaîne — y compris l’examen de la configuration du bundle et de la livraison, où la différence entre un pack install-time et un fast-follow se mesure en conversion d’installation, pas en mégaoctets.

Ce que nous ne faisons pas, c’est contourner la boutique. Les limites de taille, les déclarations de livraison et les réponses relatives à la sécurité des données sont vérifiées par Google par rapport à l’artefact réellement livré ; une fiche App Store qui promet ce que le bundle ne fait pas mène droit à une version rejetée ou à un compte suspendu, et ce n’est pas un service que nous proposons. Toute l’astuce est celle décrite plus haut : construire le bundle honnêtement, déclarer ce qu’il contient réellement et respecter les limites.

Sources (documentation officielle Google) : À propos des App Bundles Android (developer.android.com/guide/app-bundle) ; Aide Play Console — Optimisez la taille de votre application et respectez les limites de taille d’application Google Play (support.google.com/googleplay/android-developer/answer/9859372) ; Configurer le module de base ; Play Asset Delivery ; Play Feature Delivery ; bundletool (developer.android.com/tools/bundletool).

Vous gérez des comptes développeur à grande échelle ? Nous prenons en charge le volet opérationnel.

Cliquez pour choisir un fichier · clic droit → Coller, ou appuyez sur Ctrl/⌘+V pour coller une capture d’écran

Vous pouvez aussi glisser un fichier sur cette zone.

Nous répondons à l’e-mail que vous indiquez. Vos données restent chez KappS.

✔ Soumis

Nous avons bien reçu votre message et vous répondrons sous 24 heures.


← Retour à la modification