Android Debug Bridge (ADB) Connectez-vous à l'appareil via USB, WiFi

Par : Thomas Hamilton Thomas Hamilton
Hours Le kit de préparation mis à jour

⚡ Résumé intelligent

Android Debug Bridge connecte un poste de travail à un émulateur ou à un terminal physique, ouvrant un shell, installant des versions et exposant le périphérique à des outils d'automatisation via un câble USB ou une liaison sans fil.

  • 🔴 Trois parties: ADB est un client, un serveur en arrière-plan sur le port TCP 5037 et un démon s'exécutant sur l'appareil.
  • ☑️ Première exigence : Le débogage USB doit être activé dans les options pour les développeurs avant que tout périphérique n'apparaisse.
  • ✅ Vérifiez le lien : La commande adb devices liste tous les émulateurs et combinés connectés, avec leur numéro de série.
  • 🧪 Target un appareil : adb -s envoie une commande à un seul appareil alors que plusieurs sont connectés.
  • ️ Option sans fil : La commande adb tcpip 5555 suivie de adb connect déplace une session existante vers le Wi-Fi.
  • (I.e. Appareils modernes : Android Les appareils iOS 11 et supérieurs se connectent via Wi-Fi avec la commande adb pair, aucun câble n'est donc nécessaire.
En savoir plus

Android Pont de débogage connectant un périphérique via USB et Wi-Fi

Qu'est-ce que le Android Pont de débogage (ADB) ?

Android Debug Bridge (ADB) est un outil en ligne de commande qui permet de communiquer avec un périphérique. Il établit un pont entre une instance d'émulateur (Android appareil) et le processus démon en arrière-plan (serveur), vous permettant ainsi d'installer des versions, de déboguer un appareil et d'exécuter des commandes via un shell Unix.

Utilisation d'un appareil réel pour l'automatisation mobile vers les tests a toujours été un défi. Android propose des solutions pour connecter un appareil via USB (Universal Serial Bus) — à savoir Android Pont de débogage.

Débogage USB et configuration ADB

Appium peut exécuter des tests sur des appareils réels, mais les prérequis suivants doivent être mis en place au préalable.

  • Le débogage USB doit être activé
  • Configuration de la BAD
  • Configuration des capacités souhaitées en fonction des modifications matérielles.

Nous aborderons à la fois l'utilisation d'un émulateur et d'un appareil physique. Nous commencerons par les étapes relatives à l'émulateur.

Comment se connecter à un émulateur

Prérequis : le SDK (kit de développement logiciel) doit être installé sur la machine. ADB dans Android est emballé avec Google's Android SDK.

Étapes pour activer ADB à partir du SDK Manager.

Étape 1) Ouvrez Android Dossier SDK

Étape 2) Double cliquez sur Gestionnaire de SDK

Étape 3) Dans la liste de tous les packages, sélectionnez Outils et cochez la case pour

  • Android Outils SDK et
  • Android Outils de la plateforme SDK.

La liste des packages du gestionnaire de SDK, avec les deux entrées cochées, est affichée ci-dessous.

Android liste des packages du gestionnaire de SDK avec Android Outils SDK et outils de plateforme sélectionnés

⚠️ Note de version : Le gestionnaire de SDK autonome mentionné ci-dessus a été déprécié dans SDK Tools 25.2.3 et son lanceur a été supprimé dans la version 25.3.0. Ouvrez la même liste de paquets depuis Android Studio (Outils > Gestionnaire de SDK) ou le sdkmanager CLI. Le package est toujours Android Outils de la plateforme SDK, qui contient adb.

Comment se connecter Android Appareil avec ADB (Android Pont de débogage)

Étape 1) Activez le débogage USB sur votre appareil

Activez l'option de débogage USB dans les « Options pour les développeurs » de l'appareil. Android Connectez ensuite l'appareil à l'ordinateur à l'aide d'un câble USB, comme indiqué ici.

L'option de débogage USB est activée dans les options pour les développeurs sur un Android Téléphone

Étape 2) Rendez-vous dans la section Android Dossier SDK

Ouvrez le dossier où se trouve le Android Les fichiers du SDK ont été enregistrés.Android SDK >> Outils de la plateforme — par exemple C:\android-sdk\platform-tools, indiqué ci-dessous.

Windows Explorateur ouvert dans le dossier platform-tools à l'intérieur du Android SDK

Étape 3) Ouvrir la fenêtre de commande

À l'intérieur du dossier, conservez Shift Utilisez le menu contextuel (clic droit) et sélectionnez « Ouvrir une fenêtre de commandes ici », comme indiqué ci-dessous. Vous pouvez également accéder au chemin du dossier via la commande Exécuter.

Shift plus un menu contextuel par clic droit affichant « Ouvrir une fenêtre de commandes ici »

L'invite de commandes s'ouvre alors, déjà orientée vers le dossier platform-tools.

La fenêtre d'invite de commandes s'est ouverte directement dans le répertoire platform-tools

Étape 4) Connectez un périphérique externe Android dispositif

Connectez un périphérique externe Android L'appareil (téléphone portable) avec son câble USB. Ensuite, dans l'invite de commandes ci-dessus, tapez :

'adb devices' & press Enter

Elle affichera la liste de tous les appareils connectés, comme indiqué ci-dessous.

Sortie de l'invite de commandes de la commande adb devices listant le numéro de série d'un périphérique connecté

Vérifiez d'abord si le serveur ADB est exécuté en arrière-plan : saisissez « adb » dans la même invite de commandes et appuyez sur Entrée. La liste des processus ADB en cours d'exécution devrait s'afficher.

Lorsque le serveur démarre, il se lie au port TCP local 5037. Tous les clients ADB utilisent le port 5037 pour atteindre le serveur, qui scanne ensuite les ports pour trouver chaque instance d'émulateur ou de périphérique connectée.

Le démon ADB s'exécute sur un port impair et la console de l'émulateur correspondante utilise le port pair adjacent. Android's Documentation de la BAD place la plage de balayage sur les ports impairs 5555 à 5585, couvrant les 16 premiers émulateurs.

Si un seul appareil est connecté, le serveur le détecte et s'y connecte automatiquement. Avec plusieurs appareils ou émulateurs en cours d'exécution, vous devez spécifier la cible dans la ligne de commande. L'instance sur le port impair 5557 a sa console sur le port pair 5556 ; chaque instance utilise donc un port impair et un port pair.

emulator 1: console 5556
emulator 1: adb 5557
emulator 2: console 5554
emulator 2: adb 5555

Commande permettant de détecter tous les appareils connectés :

ARTICLES LIÉS

<$ adb devices>
emulator-5554 device
emulator-5556 device
emulator-5558 device

Commande permettant de détecter un seul appareil parmi plusieurs appareils connectés :

<$ adb -s emulator-5554 install Guru99.apk>

Il cible la connexion adb pour le périphérique 5554 et installe l'application — c'est ainsi que vous adressez une seule instance ADB à partir de la ligne de commande.

Syntax used to access ADB instances from the command line:
adb -d — An adb command when a single USB device is connected
adb -e — An adb command when only a single emulator is running
adb devices — This will print the list of emulators / devices attached.
adb version — List the adb version number.
adb help — Print the list of supported commands.

Comment configurer ADB pour la prise en charge Wi-Fi

ADB peut également être configuré via Wi-Fi, ce qui libère le combiné du câble lors de longues utilisations. Appium fonctionner.

Prérequis

  • Tant le Android L'appareil et l'ordinateur hôte doivent être connectés au même réseau sans fil, et
  • L'option Bluetooth de l'appareil doit être désactivée.

Étapes de connexion :

  1. Connectez l'appareil à l'ordinateur hôte à l'aide d'un câble USB. Vérifiez que le débogage USB est activé sur l'appareil.
  2. Configurez le périphérique cible pour qu'il écoute une connexion TCP/IP sur le port 5555. 
    $ adb tcpip 5555

L'invite de commande confirme le passage en mode TCP/IP, comme indiqué ci-dessous.

Invite de commandes affichant la commande adb tcpip 5555 redémarrant le démon en mode TCP

  1. Débranchez maintenant le câble USB de l'appareil.
  2. Sur l'appareil, trouvez l'adresse IP dans Paramètres >> Paramètres Wi-Fi >> Avancé >> Adresse IP. Connectez-vous, puis confirmez la session. 
    $ adb connect 148.100.1.17:5555
$ adb devices
List of devices attached
148.100.1.17:5555 device

La configuration est maintenant terminée et 'adb' fonctionne sur le réseau sans fil.

⚠️ Note de version : La séquence de câble en premier décrite ci-dessus reste la seule voie possible. Android 10 et inférieur. Android 11 (API 30) et versions ultérieures ajoutent le débogage sans fil : activez-le dans les options pour les développeurs, choisissez Appariement à l'aide du code d'appariement, puis exécutez adb pair ipaddr:port Saisissez le code. Aucun câble n'est nécessaire.

REMARQUE : en cas d’erreur de connexion, interrompez la connexion à l’hôte adb ci-dessous, puis reconnectez-vous à partir de l’étape 1.

$ adb kill-server

Si vous recherchez un émulateur, consultez ceci liste des meilleurs Android émulateurs pour Windows.

FAQ

L'invite de la clé RSA sur le combiné n'a jamais été acceptée. Déverrouillez l'écran, reconnectez le câble et appuyez sur « Autoriser le débogage USB ». Si aucune invite ne s'affiche, révoquez les autorisations de débogage USB dans les options pour les développeurs et réessayez.

Les groupes d'apprentissage automatique ont une pile quasi identique traces à partir de logcat, classe les plantages par sessions affectées et signale le premier commit susceptible d'avoir provoqué une régression, de sorte qu'un testeur lit une poignée de clusters au lieu de milliers de lignes.

Copilot effectue des boucles de routine sur les périphériques adb, installe et récupère les commandes à partir d'un commentaire. Vérifiez chaque commande générée sur un appareil au préalable, car une erreur de paramétrage peut effacer les données de l'application sans confirmation.

Utilisez la commande `adb install` avec le chemin d'accès au fichier APK, ajoutez l'option `-r` pour réinstaller par-dessus une version existante, et utilisez `adb uninstall` avec le nom du paquet pour le supprimer. Ajoutez `-s` pour cibler un seul appareil.

Vérifiez que le débogage USB est activé, essayez un câble compatible avec le transfert de données plutôt qu'un câble de charge uniquement, installez le pilote USB du fabricant. Windows, puis exécutez adb kill-server suivi de adb devices pour redémarrer le démon.

adb tcpip bascule une session USB existante vers un port réseau et fonctionne sur toutes les versions. adb pair utilise l'écran de débogage sans fil ajouté dans Android 11 et ne nécessite aucun câble à aucun moment.

Non. Le fichier binaire adb est inclus dans le Android Le package SDK Platform-tools peut être téléchargé séparément. Ajoutez ce dossier à votre variable d'environnement PATH ; la commande fonctionnera alors depuis n'importe quel répertoire.

Utilisez la commande `adb logcat` pour afficher le journal système en continu, puis `adb logcat > log.txt` pour l'enregistrer. Ajoutez `adb bugreport` pour obtenir une archive de diagnostic complète lorsque vous devez joindre des preuves à un défaut.

Résumez cet article avec :