Comment utiliser ADB : guide complet
Réponse courte
ADB est un outil en ligne de commande fourni avec les outils de plateforme Android. Il permet de communiquer avec un appareil Android, souvent par USB, pour installer des applications, copier des fichiers, lancer des commandes shell et consulter des journaux. La mise en route demande l'activation du débogage USB et le téléchargement des outils de plateforme.
L’essentiel
- ADB fait partie des outils de plateforme Android et fonctionne sur Windows, macOS, Linux et Chrome OS.
- Il faut activer le débogage USB et autoriser l'ordinateur avant la première connexion.
- Les commandes courantes couvrent l'installation d'APK, le transfert de fichiers, le shell et les journaux.
- Les pilotes peuvent être nécessaires si l'appareil n'apparaît pas dans la liste.
- La plupart des tâches ne demandent pas de droits root.
Comment utiliser ADB pour la première fois ?
Comment utiliser ADB ? On commence par une idée simple : un ordinateur envoie des commandes à un appareil Android. Il accompagne les outils de plateforme Android et sert à installer ou déboguer des applications, à échanger des fichiers dans les deux sens, à exécuter des commandes shell et à lire des journaux. Il aide surtout les développeurs à repérer des erreurs, tout en permettant des réglages avancés sur un téléphone ou une tablette.
On peut l'utiliser depuis Windows, macOS, Linux ou Chrome OS. La plupart des actions se font par USB, après activation du débogage USB et autorisation de l'ordinateur. Aucun droit root n'est nécessaire pour les tâches courantes.
Qu'est-ce qu'ADB et à quoi sert-il ?
Android Debug Bridge désigne l'outil en ligne de commande livré avec le SDK Android ; il établit une communication entre l'ordinateur et l'appareil et donne accès à un shell Unix pour y exécuter des commandes.
Les usages les plus courants sont les suivants :
- installer ou désinstaller une application depuis un fichier APK ;
- copier des fichiers entre l'ordinateur et l'appareil ;
- lancer des commandes shell pour inspecter ou modifier le système ;
- consulter les journaux pour trouver des messages d'erreur ;
- sauvegarder ou restaurer des données dans certains cas.
ADB permet aussi des opérations sensibles : mise à jour logicielle, suppression d'applications système, réinitialisation, déverrouillage du bootloader ou rootage du téléphone. Ces actions peuvent effacer des données, donc elles demandent de la prudence.
Ce qu'il faut préparer avant de commencer
Avant la première utilisation, il faut trois éléments : un câble USB fiable, l'activation du débogage USB sur l'appareil et les outils de plateforme sur l'ordinateur. Le téléphone doit aussi être déverrouillé lors de la connexion, car une boîte de dialogue demande l'autorisation.
Les outils sont portables : une fois téléchargés, on peut les décompresser où l'on veut. Il faut simplement mémoriser ce chemin pour lancer les commandes ; un dossier simple comme C:\platform-tools sur Windows limite les erreurs de saisie.
Pour le détail de l'activation, voir comment activer les options développeur Android.
Activer le débogage USB sur Android
Le débogage USB est masqué dans les options développeur. La procédure habituelle est la suivante :
- ouvrir les Paramètres, puis À propos du téléphone ;
- faire défiler jusqu'à Numéro de build ;
- taper sept fois sur cet élément ;
- revenir aux Paramètres et ouvrir les Options pour les développeurs ;
- activer le débogage USB.
Au premier branchement, le téléphone affiche une demande d'autorisation du débogage USB ; il faut cocher l'option pour toujours autoriser cet ordinateur, puis valider. Cette étape protège l'appareil contre les connexions non autorisées.
Télécharger et installer les outils de plateforme
Les outils de plateforme s'obtiennent depuis la page dédiée aux outils de plateforme Android : on choisit le lien adapté à son système d'exploitation, puis on décompresse l'archive dans un nouveau dossier.
- télécharger l'archive ZIP pour Windows, macOS ou Linux ;
- la décompresser dans un dossier facile à retrouver ;
- noter le chemin complet de ce dossier ;
- ouvrir l'invite de commandes sur Windows ou le Terminal sur macOS.
Ensuite, on se place dans ce dossier depuis la ligne de commande. Sur Windows, une commande type est C:\Users\\Downloads\platform-tools. Sur macOS ou Linux, on utilise la commande cd avec le chemin du dossier décompressé. Les outils étant portables, aucun installateur n'est requis.
Connecter l'appareil et vérifier la liaison
Après avoir branché le téléphone par USB, on lance la commande adb devices. Si tout va bien, l'appareil apparaît dans la liste avec un identifiant et l'état device. Cette vérification évite d'exécuter des commandes sur le mauvais appareil.
Si l'appareil est branché mais absent de la liste, il faut installer les pilotes adaptés. Sous Windows, on repère un exécutable ou un fichier INF dans le dossier des pilotes fournis par le fabricant ou par Google, puis on relance adb devices.
Il est prudent de débrancher puis rebrancher le câble et de vérifier que le débogage USB est toujours activé si la liste reste vide.
Commandes ADB les plus utiles
Le tableau suivant regroupe les commandes les plus fréquentes. Les noms de paquets et les chemins doivent être adaptés à chaque appareil.
| Commande | Usage |
|---|---|
| adb devices | Lister les appareils connectés |
| adb install app.apk | Installer une application depuis un fichier APK |
| adb uninstall nom.paquet | Désinstaller une application par son nom de paquet |
| adb push fichier /sdcard/ | Envoyer un fichier vers l'appareil |
| adb pull /sdcard/fichier . | Récupérer un fichier depuis l'appareil |
| adb shell | Ouvrir un shell sur l'appareil |
| adb logcat | Afficher les journaux de débogage |
| adb reboot | Redémarrer l'appareil |
| adb reboot recovery | Redémarrer en mode récupération |
Pour installer un paquet téléchargé, on peut aussi consulter installer un fichier APK sur Android : guide pratique.
Transférer des fichiers avec push et pull
La commande adb push envoie un fichier de l'ordinateur vers l'appareil, tandis que adb pull fait l'inverse. On indique d'abord la source, puis la destination. Par exemple, adb push photo.jpg /sdcard/Photos/ copie une image dans le dossier Photos.
Ces commandes sont utiles pour récupérer des journaux, déposer des mises à jour ou sauvegarder des fichiers sans passer par une application de synchronisation. Il faut respecter les permissions du dossier cible et éviter d'écraser des fichiers importants.
Lire les journaux avec logcat
La commande adb logcat produit un flux de journaux utile pour repérer des messages d'erreur et des informations de débogage. On l'utilise souvent pendant le test d'une application pour voir ce qui se passe au moment d'un plantage.
Le flux peut être long. On peut l'arrêter avec Ctrl+C dans le terminal. Pour un usage ciblé, on filtre les lignes selon le tag ou le niveau de gravité, puis on enregistre le résultat dans un fichier pour l'analyser plus tard.
Tâches avancées et précautions
ADB sert aussi à des réglages avancés : installation de mises à jour, suppression d'applications système, sauvegarde et restauration, déverrouillage du bootloader, rootage du téléphone. Ces opérations peuvent rendre l'appareil instable ou effacer toutes les données.
- faire une sauvegarde avant toute modification importante ;
- vérifier le nom exact du paquet avant une désinstallation ;
- ne pas interrompre une mise à jour en cours ;
- lire la documentation du fabricant pour le bootloader.
Une réinitialisation complète efface les données utilisateur. Pour ce sujet, voir réinitialiser Android aux paramètres d'usine : guide complet. En cas de problème de démarrage, le mode de récupération données : guide Android peut aider à réparer ou réinitialiser l'appareil.
Dépannage des problèmes courants
Les difficultés les plus fréquentes concernent la connexion, les pilotes et les autorisations. Les vérifications suivantes résolvent la plupart des cas :
- vérifier que le câble transmet les données et non seulement la charge ;
- confirmer que le débogage USB est activé ;
- valider la boîte de dialogue d'autorisation sur le téléphone ;
- installer ou mettre à jour les pilotes du fabricant ;
- relancer le serveur ADB avec adb kill-server puis adb start-server.
Si l'appareil apparaît comme unauthorized, il faut révoquer les autorisations USB dans les options développeur puis reconnecter l'appareil et accepter à nouveau la demande.
Sécurité et bonnes pratiques
Le débogage USB donne un accès puissant à l'appareil. Il faut le désactiver après usage, surtout sur un ordinateur partagé ou public. On ne doit pas accepter une demande d'autorisation sans vérifier l'ordinateur connecté.
Il est aussi recommandé de garder les outils de plateforme à jour, de télécharger les APK uniquement depuis des sources fiables et de tester les commandes destructrices sur un appareil de secours. ADB reste un outil précis : une commande bien comprise vaut mieux qu'une série d'essais.
Autres questions fréquentes
Faut-il rooter son téléphone pour utiliser ADB ?
Non, la plupart des commandes courantes fonctionnent sans droits root. Le rootage concerne des modifications avancées et peut annuler la garantie.
ADB fonctionne-t-il sans câble USB ?
La méthode la plus courante reste le câble USB. D'autres configurations existent, mais elles demandent des réglages supplémentaires non détaillés ici.
Que faire si adb devices n'affiche rien ?
Il faut vérifier le câble, l'activation du débogage USB, l'autorisation sur le téléphone et les pilotes. Relancer le serveur ADB résout souvent le problème.
ADB peut-il effacer les données ?
ADB lui-même ne les efface pas, mais certaines commandes avancées ou une réinitialisation peuvent le faire. Une sauvegarde est recommandée avant toute modification.
Pages liées
- Comment libérer de l'espace sur Android : guide pratique
Le stockage garde les données, tandis que la mémoire vive fait tourner les applications. Pour libérer de l'espace sur Android, videz le cache, supprimez les applications inutiles, déplacez les photos et vidéos, puis gardez au moins 10 à 15 % de stockage libre.
- Comment sauvegarder son téléphone Android : guide pratique
La sauvegarde Google transfère le contenu, les données et les réglages vers le compte Google. On peut les récupérer sur l'appareil initial ou sur d'autres téléphones Android, selon la version du système. Les sauvegardes sont gérées ensemble dans le tableau de bord du compte Google, où l'option « Supprimer toutes les données » efface définitivement les données de l'appareil et de WhatsApp ; la sauvegarde reste disponible tant que l'appareil est utilisé et disparaît après plus de 57 jours sans usage.
- Comment activer les options développeur Android
Les options développeur sont un menu caché d'Android pour le débogage et le réglage fin du système. On les active en appuyant sept fois sur le numéro de build, puis on les désactive par l'interrupteur principal quand on a terminé.
- Réinitialiser Android aux paramètres d'usine : guide complet
Une réinitialisation aux paramètres d'usine supprime les données utilisateur et les applications, puis ramène l'appareil à son état d'origine. Avant de lancer l'opération, il faut sauvegarder les données, connaître le compte Google et prévoir une connexion internet. On passe le plus souvent par Réglages ; les boutons servent si cet accès est bloqué.
- Mode de récupération données : guide Android
Le mode de récupération Android est un mode de démarrage séparé qui sert à installer des mises à jour, effacer des données ou réparer un appareil qui ne démarre plus normalement. On y accède avec une combinaison de boutons, on navigue avec les touches de volume et on confirme avec le bouton d'alimentation. Ce guide explique les options utiles, les différences selon les marques et la sortie du menu.
- Installer un fichier APK sur Android : guide pratique
Un fichier APK est le paquet d'installation d'une application Android. Pour l'installer hors du Play Store, il faut autoriser l'application qui ouvre le fichier, puis lancer le paquet depuis le gestionnaire de fichiers ou le navigateur.
Comment cette page a été préparée
Avant la rédaction, le sujet a été étudié dans les sources ci-dessous. La page a ensuite passé des contrôles de qualité automatiques.