Comment installer un fichier .aab distribué par Binance sur votre téléphone avec bundletool

Les utilisateurs classiques téléchargent l'APK « universal » depuis le site officiel de Binance, qui s'installe d'un simple double-clic dans le gestionnaire de fichiers. Mais les chercheurs ou les développeurs récupèrent parfois un fichier .aab (Android App Bundle), qui nécessite l'outil bundletool de Google pour être installé sur un téléphone. Cette note détaille le processus complet. Les utilisateurs réguliers n'ont pas besoin de suivre cette méthode complexe ; pour télécharger l'APK, passez directement par le site officiel Binance ou l'App officielle Binance. Pour l'installation sur iPhone, consultez le tutoriel d'installation iOS.

Qu'est-ce que bundletool ?

bundletool est un outil en ligne de commande open-source officiel de Google. Ses fonctions principales :

• Convertir un fichier .aab en .apks (une archive zip contenant plusieurs split APKs).
• Générer un sous-ensemble d'APKs correspondant aux spécifications d'un appareil donné.
• Installer directement les APKs générés sur un appareil connecté via ADB.
• Exposer la structure interne d'un .aab pour l'analyse.

Cet outil est le moyen de vérification standard pour les développeurs avant de publier une application sur Google Play. Il n'est généralement pas utile pour les utilisateurs francophones, sauf pour :

• Étudier la structure interne de l'application Binance.
• Installer un .aab distribué par un tiers.
• Écrire des scripts de tests automatisés.

Prérequis

Vous devez préparer les éléments suivants sur votre ordinateur :

Logiciel	Rôle
Java JDK 11+	Dépendance pour bundletool
bundletool jar	Outil en ligne de commande open-source de Google
Android SDK Platform Tools (incluant ADB)	Pour communiquer avec l'appareil
Fichier .aab	Provenant de Binance ou de votre propre décompilation
Câble de données USB	Pour connecter le téléphone Android

bundletool pèse environ 6 à 8 Mo et peut être téléchargé depuis le dépôt google/bundletool sur GitHub.

Activer le débogage USB sur l'appareil

Activez les options pour les développeurs sur le téléphone :

1. Paramètres → À propos du téléphone → Appuyez 7 fois sur le « Numéro de build ».
2. Retournez dans Paramètres → Système → Options pour les développeurs.
3. Activez le « Débogage USB ».
4. Connectez le téléphone à l'ordinateur avec le câble USB, et appuyez sur « Autoriser » dans la boîte de dialogue d'autorisation qui s'affiche.

Le chemin d'accès varie légèrement selon la ROM :

ROM	Élément à tapoter plusieurs fois
MIUI	« Version MIUI »
HarmonyOS	« Version HarmonyOS »
ColorOS	« Numéro de build »
One UI	« Numéro de version »

Une fois activé, ADB pourra reconnaître l'appareil.

Aperçu du processus d'installation complet

Installer un .aab sur un téléphone se fait en quatre étapes principales :

Étape 1 : Vérifier si l'appareil est reconnu par ADB Tapez adb devices dans l'invite de commande. Si le numéro de série de votre téléphone apparaît dans la sortie, la connexion est établie.

Étape 2 : Générer des APKs spécifiques à l'appareil avec bundletool bundletool va interroger l'appareil connecté sur son modèle, son architecture, sa langue et la densité de son écran. À partir de ces paramètres, il extraira du .aab l'ensemble minimal de splits nécessaires et générera un fichier binance.apks.

Étape 3 : Installer les APKs sur l'appareil avec bundletool bundletool intègre une sous-commande install-apks qui appelle automatiquement adb install-multiple pour installer tous les splits en une seule fois.

Étape 4 : Lancer Binance sur le téléphone Après le lancement, l'expérience utilisateur est identique à celle d'une installation via l'APK universal.

Les commandes exactes impliquent des paramètres spécifiques ; les développeurs peuvent se référer à la documentation officielle de Google pour les détails.

Différence de taille : .aab vs APK universal

Testé sur la même version (v2.100.5) :

Format	Taille de téléchargement	Espace occupé après installation
.aab (Distribution Google Play)	Non téléchargeable directement	-
APKs spécifiques à l'appareil (générés depuis le .aab)	38-45 Mo	130-150 Mo
APK universal (Distribution site Binance)	96 Mo	240 Mo

La différence s'explique principalement par le fait que le fichier universal inclut toutes les architectures et toutes les langues, tandis que la version spécifique à l'appareil ne contient que ce qui est nécessaire.

Erreurs courantes avec bundletool

Erreur 1 : Unsupported tools version La version de Java ne correspond pas à bundletool. Les versions récentes de bundletool exigent le JDK 11+ ; l'ancien JDK 8 est incompatible. Solution : mettez à jour le JDK.

Erreur 2 : No device connected ADB ne reconnaît pas l'appareil. Vérifiez que le mode USB est sur « Transfert de fichiers » et que l'autorisation de débogage est accordée.

Erreur 3 : Multiple devices connected Si plusieurs appareils sont connectés, vous devez utiliser le paramètre -s pour spécifier le numéro de série.

Erreur 4 : Manifest version code is lower than installed Une version identique ou plus récente est déjà installée sur l'appareil. Il faut d'abord la désinstaller ou augmenter le versionCode.

Erreur 5 : Insufficient storage Le stockage de l'appareil est plein, libérez de l'espace.

Vérifications post-installation

Une fois l'installation terminée, vous pouvez effectuer quelques vérifications :

• Vérifier si com.binance.dev est présent dans la liste adb shell pm list packages.
• Lancer l'application pour voir si le numéro de version correspond aux attentes.
• Comparer l'empreinte de la signature avec celle annoncée sur le site officiel.
• Effectuer un test de passage d'ordre au comptant (Spot) pour confirmer que les fonctionnalités sont opérationnelles.

Scénarios d'utilisation

Ceux qui devraient utiliser la méthode bundletool :

• Les chercheurs en sécurité analysant la structure de l'application.
• Les testeurs (QA) écrivant des tests UI automatisés.
• Les développeurs ayant besoin de tester le comportement des splits sur diverses spécifications d'appareils.
• Les étudiants apprenant les mécanismes de packaging des applications Android.

Ceux qui n'en ont pas besoin :

• Les utilisateurs ordinaires voulant utiliser Binance normalement (téléchargez simplement l'APK universal).
• Les utilisateurs sans expérience avec ADB ou la ligne de commande.
• Les utilisateurs de tablettes, boîtiers TV ou autres appareils non standards (la compatibilité de l'APK universal est meilleure).

Alternatives pour les débutants en ligne de commande

Si les termes ADB et bundletool vous donnent la migraine mais que vous avez un fichier .aab, voici des alternatives plus conviviales :

• Utiliser l'interface graphique SAI (Split APKs Installer) : copiez-y le .aab et il s'occupera du reste.
• Utiliser APKEditor Studio pour convertir le .aab en .apkm avant de l'installer.
• Abandonner le .aab et télécharger directement l'APK universal depuis le site officiel de Binance.

La troisième option reste la plus simple.

FAQ

Q : Pourquoi Binance distribue-t-il un fichier .aab plutôt qu'un APK ? R : En réalité, le site officiel de Binance met en avant l'APK universal pour la plupart des utilisateurs. Le format .aab est principalement destiné à la distribution sur le Google Play Store.

Q : Les split APKs que j'ai générés peuvent-ils être utilisés par d'autres ? R : Techniquement oui, mais les splits sont liés aux spécifications de votre appareil. Ils risquent d'être incompatibles sur un autre téléphone.

Q : Après avoir installé les APKs générés par bundletool, puis-je toujours mettre à jour via le Play Store ? R : Oui. Le Play Store utilise le versionCode et la signature pour identifier l'application. S'ils correspondent, il la reconnaîtra et la mettra à jour.

Q : Bundletool modifie-t-il le contenu de l'APK ? R : Non. Il se contente de découper le .aab en plusieurs APKs, sans modifier le bytecode.

Lectures complémentaires

• Le concept de split bundle
• Tutoriel d'installation de l'APK pour les utilisateurs standards
• Choix de l'architecture