ADB : principes de base d'Android Debug Bridge et commandes courantes

Qu'est-ce qu'ADB et pourquoi en avez-vous besoin

Android Debug Bridge (ADB) est une application client-serveur composée de trois éléments : un client (exécuté sur l'ordinateur), un serveur (processus en arrière-plan sur l'ordinateur) et un démon adbd (exécuté sur l'appareil Android lui-même). Lorsqu'un développeur ou ingénieur connecte un smartphone à un PC, ADB crée un canal de communication fiable via lequel des commandes, fichiers et données peuvent être transmis.

Les principaux cas d'utilisation d'ADB incluent le débogage d'applications sur un appareil réel sans avoir à publier un APK dans un magasin, l'extraction de journaux pour l'analyse d'erreurs, l'automatisation des tests, la sauvegarde de données, le flashage d'images de recovery et l'obtention d'un accès root. Même si vous n'écrivez pas de code, ADB peut être utile pour extraire des captures d'écran d'applications, enregistrer un guide vidéo depuis l'écran du téléphone ou récupérer un appareil après une mise à jour firmware échouée.

Le support ADB est intégré dans toutes les versions officielles d'Android à partir de la version 2.1 (API 7). Il nécessite l'activation de l'option Débogage USB dans les paramètres développeur. À partir d'Android 4.2, l'appareil demande une confirmation lors de la première connexion : vous devez autoriser le débogage pour l'ordinateur spécifique via sa clé RSA.

Installation d'ADB sur l'ordinateur

Pour Windows — téléchargez Platform Tools depuis le site officiel de Google Developers, extrayez l'archive dans le dossier C:\adb et ajoutez ce chemin à la variable d'environnement PATH. Après avoir redémarré le terminal, la commande adb sera disponible globalement.

Pour macOS — le moyen le plus simple est d'installer ADB via le gestionnaire de paquets Homebrew : exécutez brew install android-platform-tools. Toutes les dépendances seront résolues automatiquement.

Pour Linux — sur les distributions basées sur Debian / Ubuntu : sudo apt install adb. Après l'installation, ajoutez l'utilisateur au groupe plugdev : sudo usermod -aG plugdev $USER et reconnectez-vous pour qu'ADB puisse accéder aux périphériques USB.

Vérifiez l'installation avec la commande adb version. Si la sortie affiche le numéro de version d'Android Debug Bridge, l'outil est prêt à être utilisé.

Connexion de l'appareil et commandes de base

Première connexion commence toujours par la commande adb devices. Elle affiche la liste des appareils connectés et leur statut. Si l'appareil apparaît comme unauthorized, déverrouillez l'écran et confirmez le débogage sur le téléphone.

adb devices
List of devices attached
emulator-5554   device
0123456789ABCD  device

Installation d'une application — l'une des opérations les plus fréquentes. Il suffit d'indiquer le chemin vers le fichier APK :

adb install C:\apps\myapp.apk

Si l'application est déjà installée mais doit être remplacée par une version mise à jour, ajoutez le flag -r (replace) :

adb install -r C:\apps\myapp-v2.apk

Désinstallation d'une application se fait par nom de paquet :

adb uninstall com.example.myapp

Copie de fichiers — adb pull extrait un fichier de l'appareil vers l'ordinateur, adb push télécharge un fichier vers l'appareil :

adb pull /sdcard/DCIM/screenshot.png .
adb push myfile.txt /sdcard/Documents/

Shell interactif — la commande adb shell ouvre l'interpréteur de commandes de l'appareil. À l'intérieur, vous pouvez exécuter des commandes Linux standard : ls, ps, top, dumpsys, pm, am et autres.

adb shell
tissot_sprout:/ $ ls -la /sdcard/
tissot_sprout:/ $ ps | grep com.android.chrome

Lancement d'une activité via ADB permet d'ouvrir n'importe quelle application ou écran sans chercher manuellement l'icône :

adb shell am start -n com.android.chrome/com.google.android.apps.chrome.Main

Travail avec les journaux : Logcat

Logcat est le système de journalisation d'Android qui collecte les messages des applications, des services système et du noyau. L'outil est indispensable pour le débogage : les journaux permettent de comprendre pourquoi une application a planté, quelle méthode a provoqué une exception ou combien de temps une opération particulière prend.

Un lancement simple sans filtres — adb logcat. Le flux de journaux est infini ; appuyez sur Ctrl+C pour l'arrêter. Pour filtrer les messages par balise, utilisez le paramètre -s :

adb logcat -s MainActivity:V

Niveaux de gravité de journalisation (du plus détaillé au critique) : V (Verbose), D (Debug), I (Info), W (Warning), E (Error), F (Fatal). La combinaison d'une balise et d'un niveau permet de ne mettre en évidence que les messages nécessaires.

Pour vider le tampon accumulé avant un test :

adb logcat -c

Et pour sauvegarder les journaux dans un fichier :

adb logcat -d > app_logs.txt

Le flag -d (dump) affiche le tampon actuel et se termine sans bloquer le terminal. C'est pratique pour les scripts d'automatisation.

Captures d'écran, enregistrement vidéo et commandes de diagnostic utiles

Capture d'écran se fait avec la commande adb shell screencap. Le résultat est enregistré dans un fichier qui est ensuite récupéré via adb pull :

adb shell screencap /sdcard/screen.png
adb pull /sdcard/screen.png

Vous pouvez combiner les deux opérations en une seule ligne avec substitution et tube. En pratique, cela accélère la création de documentation et de rapports de test.

Enregistrement d'écran est disponible sur Android 4.4+ (API 19). La durée d'enregistrement par défaut est de 180 secondes, le débit binaire est de 4 Mbps. La commande principale :

adb shell screenrecord /sdcard/demo.mp4

Pour arrêter l'enregistrement, appuyez sur Ctrl+C. La résolution vidéo correspond à la résolution de l'écran de l'appareil mais ne dépasse pas 1080p. Pour modifier le débit binaire, spécifiez --bit-rate :

adb shell screenrecord --bit-rate 8000000 /sdcard/demo.mp4

Commandes de diagnostic : adb shell dumpsys affiche l'état de tous les services système. Pour obtenir uniquement les informations sur la batterie :

adb shell dumpsys battery

La liste des paquets installés peut être obtenue via Package Manager :

adb shell pm list packages

Réinitialisation des paramètres d'une application (équivalent à effacer les données dans les paramètres) :

adb shell pm clear com.example.myapp

Fonctionnalités avancées d'ADB

Débogage Wi-Fi élimine le besoin de maintenir l'appareil connecté via USB. Assurez-vous que l'ordinateur et l'appareil sont sur le même réseau. Exécutez d'abord adb tcpip 5555, déconnectez l'USB, puis connectez-vous par IP :

adb tcpip 5555
adb connect 192.168.1.100:5555

Si l'adresse IP de l'appareil est inconnue, trouvez-la via adb shell ip addr show wlan0 avant de débrancher le câble.

Sauvegarde de données d'une application ou de tout le système peut être effectuée sans root :

adb backup -apk -shared -all -system -f mybackup.ab

Restauration à partir d'une sauvegarde :

adb restore mybackup.ab

Émulation de saisie — la commande adb shell input permet de simuler des touches, balayages, pressions de touches et saisie de texte. C'est la base de l'automatisation des tests UI sans frameworks supplémentaires :

adb shell input tap 500 1000
adb shell input swipe 300 500 800 500
adb shell input text "Hello, ADB!"

Redémarrage dans différents modes :

adb reboot          # normal reboot
adb reboot recovery # recovery mode
adb reboot bootloader # bootloader (fastboot)

Le mode fastboot donne accès au flashage d'images, au déverrouillage du bootloader et à l'installation d'une recovery personnalisée.

Travail avec plusieurs appareils

Lorsque plusieurs appareils ou émulateurs sont connectés simultanément, ADB nécessite un numéro de série spécifique. La commande adb devices liste tous les appareils connectés avec leurs numéros de série.

Pour adresser une commande à un appareil spécifique, utilisez le flag -s :

adb -s 0123456789ABCD install myapp.apk

S'il n'y a qu'un seul appareil, le flag peut être omis. Cependant, dans un environnement CI où plusieurs émulateurs fonctionnent simultanément, la spécification du numéro de série est obligatoire.

Arrêter le serveur ADB — si un appareil cesse d'être détecté ou génère une erreur, le redémarrage du serveur aide :

adb kill-server
adb start-server

Après cela, exécutez adb devices — le serveur redémarrera et redirigera les requêtes vers les démons des appareils.

Principales commandes ADB : tableau de référence

Conclusion

ADB (Android Debug Bridge) est un outil fondamental pour quiconque travaille avec Android à un niveau professionnel. De l'installation de base d'applications à l'automatisation complexe de tests et à la récupération d'appareils — ADB couvre pratiquement tous les scénarios d'interaction entre un ordinateur et un smartphone ou une tablette.

En maîtrisant les commandes décrites dans cet article, vous serez en mesure de gérer en toute confiance un appareil Android via le terminal, d'analyser les journaux, de prendre des captures d'écran pour la documentation, d'effectuer des sauvegardes et d'accélérer le processus de développement. La pratique régulière et l'étude de la sortie de adb help feront de vous un utilisateur expérimenté de cet outil puissant.