Les bases d'adb pour tout testeur d'app

adb (Android Debug Bridge) est un outil en ligne de commande qui communique avec un téléphone ou un émulateur par USB ou Wi-Fi. Inutile de tout apprendre. Une douzaine de commandes couvrent la plupart du travail quotidien d'un testeur ou d'un développeur : installer un build, réinitialiser l'app, définir une permission et sauvegarder un log pour un rapport de bug.

Installation en deux minutes

1. Installe les Platform-Tools du SDK Android (ils contiennent adb).
2. Sur le téléphone, active les options pour développeurs (touche plusieurs fois le numéro de build dans Paramètres > À propos du téléphone), puis active le débogage USB.
3. Connecte le téléphone et accepte l'invite « Autoriser le débogage USB ? ».
4. Lance adb devices. Ton appareil doit apparaître avec device. S'il indique unauthorized, accepte à nouveau l'invite sur le téléphone.

Si plusieurs appareils sont connectés, ajoute -s <serial> à chaque commande, avec le numéro de série affiché par adb devices.

Installer et supprimer des builds

Remplace com.example.app par ton nom de package. Si une installation échoue, le message d'erreur (par exemple une signature qui ne correspond pas ou un problème de code de version) indique généralement la cause. Un bundle (.aab) ne s'installe pas directement ; pour les tests, installe les APK générés à partir de lui, ou utilise une piste de test du store.

Réinitialiser l'état

• adb shell pm clear com.example.app efface les données et le cache de l'app, comme une installation neuve sans réinstaller. Utilise-la avant chaque test de premier lancement.
• adb shell am force-stop com.example.app arrête l'app. Utile pour tester les démarrages à froid.
• adb shell monkey -p com.example.app -c android.intent.category.LAUNCHER 1 lance l'app sans connaître le nom de l'activité.

Permissions

• Accorder : adb shell pm grant com.example.app android.permission.CAMERA
• Révoquer : adb shell pm revoke com.example.app android.permission.CAMERA

Accorder et révoquer est le moyen rapide de tester les chemins « autorisé » et « refusé ». Seules les permissions d'exécution déclarées par ton app peuvent être modifiées ainsi.

Logs

• adb logcat diffuse le journal système. Il est bruyant ; filtre-le par ton package ou un tag.
• adb logcat -c vide le tampon d'abord, pour que ta capture commence proprement.
• adb logcat -d > log.txt vide le tampon actuel dans un fichier et quitte.

Une routine fiable pour reproduire un bug : vide le log, reproduis le problème une fois, exporte le log, joins-le. Voir aussi lire les rapports de crash.

Fichiers, captures d'écran et enregistrements

• adb pull /sdcard/file.png . copie un fichier depuis le téléphone.
• adb exec-out screencap -p > screen.png enregistre une capture d'écran.
• adb shell screenrecord /sdcard/demo.mp4 enregistre l'écran (arrête avec Ctrl+C, puis récupère le fichier). Il s'arrête après une durée limite qui dépend de l'appareil.

Limites

adb indique ce que l'appareil a fait, pas ce qu'une personne a ressenti. Il ne remplace pas les tests avec de vraies personnes sur de vrais téléphones, mais il rend leurs rapports bien meilleurs : un log et un build exact valent plus que « ça a planté ».

Fait partie du guide de test d'apps Android. Liens associés : rapport de pré-lancement de la Play Console et bases de Android vitals.

Tu veux des retours sur un build de la part de vraies personnes ? Commence gratuitement et obtiens des retours privés et structurés sur ton app.