Un guide étape par étape pour vous aider à démarrer avec l'outil Android Debug Bridge.
Liens rapides
- Qu'est-ce qu'Android Debug Bridge (ADB) ?
- Comment fonctionne la BAD ?
- Comment configurer la BAD
- Exemples de commandes ADB
- Que puis-je faire d'autre avec ADB ?
Plusieurs fonctionnalités du système d'exploitation Android ne sont accessibles que via des chemins et des méthodes cachés à l'utilisateur moyen. Celles-ci ont généralement été réalisées à l'aide de certaines commandes en ligne de commande Android Debug Bridge (ADB), un outil proposé par Google. pour les développeurs de déboguer diverses parties de leurs applications ou du système, mais que nous pouvons utiliser pour toutes sortes de tâches soignées et cachées. des trucs. Une condition préalable à ces astuces est d’installer ADB sur votre ordinateur. Ainsi, dans ce guide, nous allons vous montrer comment installer ADB sur Windows, macOS et Linux en étapes rapides et faciles à suivre.
Qu'est-ce qu'Android Debug Bridge (ADB)?
La structure interne d'Android Debug Bridge (ADB) est basée sur l'architecture client-serveur classique. Il y a trois éléments qui composent l’ensemble du processus.
- Le client, c'est-à-dire le PC/Mac/Chromebook que vous avez connecté à votre appareil Android. Nous envoyons des commandes à notre appareil depuis l'ordinateur via le câble USB ou sans fil.
- Un démon (appelé « adbd ») qui exécute des commandes sur un périphérique. Le démon s'exécute en arrière-plan sur chaque appareil.
- Un serveur qui gère la communication entre le client et le démon. Le serveur s'exécute en arrière-plan sur l'ordinateur.
Comment fonctionne la BAD?
Étant donné qu'ADB comporte trois éléments (le client, le démon et le serveur), cela nécessite que certains éléments soient opérationnels en premier lieu. Si vous avez récemment démarré l'ordinateur (et que vous ne l'avez pas configuré pour démarrer le démon au démarrage), alors vous aurez besoin qu'il soit en cours d'exécution avant qu'une communication puisse être envoyée à l'Android cible appareil. Vous verrez le message suivant dans l'invite de commande ou le terminal, qui vérifiera que le démon est en cours d'exécution.
Si le démon n'est pas en cours d'exécution, il démarrera le processus et vous indiquera sur quel port TCP local il a été démarré. Une fois ce service ADB démarré, il continuera à écouter sur ce port spécifique les commandes envoyées par le client ADB. Il établira ensuite des connexions avec tous les périphériques en cours d'exécution connectés à l'ordinateur (y compris les émulateurs). C'est le moment où vous recevrez la demande d'autorisation sur l'appareil Android si l'ordinateur n'a pas été autorisé dans le passé.
Comment configurer la BAD
Remarque: la configuration d'ADB sur l'ordinateur ne représente que la moitié de l'équation puisque vous devrez également effectuer certaines opérations sur le smartphone ou la tablette pour accepter les commandes ADB.
Configuration du téléphone
- Lancez le Paramètres application sur votre téléphone.
- Appuyez sur le A propos du téléphone option généralement située en bas de la liste.
- En fonction du skin OEM, le A propos du téléphone la page peut être appelée autrement ou enterrée ailleurs dans le Paramètres application sur votre appareil.
- Appuyez ensuite sur le Numéro de build option sept fois pour activer le mode développeur. Vous verrez un message toast une fois l'opération terminée.
- Revenez maintenant à l'écran principal des paramètres et vous devriez voir un nouveau Options de développeur menu auquel vous pouvez accéder. Sur les téléphones Google Pixel et certains autres appareils, vous devrez peut-être accéder à Paramètres > Système pour trouver le Options de développeur menu.
- Allez-y et activez le débogage USB option.
- Vous avez partiellement terminé le processus de configuration du téléphone. Ensuite, vous devrez faire défiler ci-dessous et suivre le reste des instructions correspondant à votre système d'exploitation particulier.
Comment configurer ADB sur Microsoft Windows
- Téléchargez le Fichier ZIP des outils de la plate-forme SDK Android pour Windows.
- Extrayez le contenu de ce fichier ZIP dans un dossier facilement accessible (tel que C:\platform-tools).
- Ouvrir Explorateur de fichiers et accédez à l'endroit où vous avez extrait le contenu de ce fichier ZIP.
- Ouvrez une instance d'invite de commande/terminal à partir du même répertoire que ce binaire ADB. Cela peut être fait en maintenant Shift et en cliquant avec le bouton droit dans le dossier, puis en cliquant sur Ouvrez la fenêtre de commande ici ou Ouvrez la fenêtre PowerShell ici. Les utilisateurs de Windows 11 devraient voir Ouvrir dans le terminal dans le menu contextuel du clic droit sans même appuyer sur la touche Maj du clavier.
- Connectez votre smartphone ou tablette à votre ordinateur avec un câble USB. Changez le mode USB en mode « transfert de fichiers (MTP) ». Certains constructeurs OEM peuvent l'exiger ou non, mais il est préférable de le laisser dans ce mode pour des raisons de compatibilité générale.
- Dans la fenêtre Invite de commandes/Terminal, entrez la commande suivante pour lancer le démon ADB:
adb devices
- Sur l'écran de votre téléphone, vous devriez voir une invite pour autoriser ou refuser l'accès au débogage USB. Naturellement, vous souhaiterez accorder l'accès au débogage USB lorsque vous y êtes invité (et cochez la case Toujours autoriser si vous ne souhaitez plus jamais voir cette invite).
- Enfin, saisissez à nouveau la commande de l'étape 6. Si tout a réussi, vous devriez maintenant voir le numéro de série de votre appareil dans l'invite de commande (ou dans la fenêtre PowerShell).
Vous pouvez désormais exécuter n'importe quelle commande ADB sur votre appareil! Maintenant, allez-y et commencez à modifier votre téléphone en suivant notre longue liste de tutoriels !
Comment configurer ADB sur macOS
- Téléchargez le Fichier ZIP des outils de la plate-forme SDK Android pour macOS.
- Extrayez le ZIP vers un emplacement facilement accessible (comme le bureau par exemple).
- Ouvrez le terminal.
- Pour accéder au dossier dans lequel vous avez extrait ADB, entrez la commande suivante:
cd /path/to/extracted/folder/
- Par exemple, vous pouvez placer le contenu sur votre bureau:
cd /Users/XDA/Desktop/platform-tools/
- Par exemple, vous pouvez placer le contenu sur votre bureau:
- Connectez votre appareil à votre Mac avec un câble USB compatible. Changez le mode de connexion USB en mode « transfert de fichiers (MTP) ». Cela n'est pas toujours requis pour tous les appareils, mais il est préférable de le laisser dans ce mode afin de ne rencontrer aucun problème.
- Une fois que le terminal se trouve dans le même dossier que vos outils ADB, vous pouvez exécuter la commande suivante pour lancer le démon ADB:
./adb devices
- Sur votre appareil, vous verrez un Permettre le débogage USB rapide. Autorisez la connexion.
- Enfin, entrez à nouveau la commande de l'étape 7. Si tout s'est bien passé, vous devriez maintenant voir le numéro de série de votre appareil dans la fenêtre Terminal de macOS.
Toutes nos félicitations! Vous pouvez désormais exécuter n'importe quelle commande ADB sur votre appareil! Maintenant, allez-y et commencez à modifier votre téléphone.
Bien que le guide ci-dessus fonctionne certainement, les utilisateurs chevronnés de macOS peuvent également choisir d'installer ADB sur leur Mac à l'aide d'un gestionnaire de packages non officiel tel que Homebrew ou MacPorts. De cette façon, vous n'avez pas besoin de mettre à jour manuellement les binaires.
Comment configurer ADB sur Linux
- Téléchargez le Fichier ZIP des outils de la plate-forme SDK Android pour Linux.
- Extrayez le ZIP vers un emplacement facilement accessible (comme le bureau par exemple).
- Ouvrez une fenêtre de terminal.
- Entrez la commande suivante:
cd /path/to/extracted/folder/
- Cela changera le répertoire dans lequel vous avez extrait les fichiers ADB.
- Exemple:
cd /home/XDA/Desktop/platform-tools/
- Exemple:
- Connectez votre appareil à votre machine Linux avec votre câble USB. Changez le mode de connexion en mode « transfert de fichiers (MTP) ». Cela n'est pas toujours nécessaire pour tous les appareils, mais c'est recommandé afin que vous ne rencontriez aucun problème.
- Une fois que le terminal se trouve dans le même dossier que vos outils ADB, vous pouvez exécuter la commande suivante pour lancer le démon ADB:
./adb devices
- De retour sur votre smartphone ou tablette, vous verrez une invite vous demandant d'autoriser le débogage USB. Allez-y et accordez-le.
- Enfin, saisissez à nouveau la commande de l'étape 8. Si tout s'est bien passé, vous devriez maintenant voir le numéro de série de votre appareil dans la sortie de la fenêtre du terminal.
Bravo! Vous pouvez désormais exécuter n'importe quelle commande ADB sur votre appareil !
Les utilisateurs de Linux doivent savoir qu'il existe un moyen plus simple d'installer ADB sur leurs ordinateurs. Le guide ci-dessus fonctionnera certainement pour vous, mais ceux qui possèdent un système Debian/Ubuntu grand public ou La distribution Linux basée sur Fedora/SUSE peut ignorer les étapes 1 et 2 du guide ci-dessus et utiliser l'un des commandes suivantes :
- Les utilisateurs Linux basés sur Debian/Ubuntu peuvent taper la commande suivante pour installer ADB :
sudo apt-get install android-sdk-platform-tools
- Les utilisateurs Linux basés sur Fedora/SUSE peuvent taper la commande suivante pour installer ADB :
sudo dnf install android-tools
Cependant, il est toujours préférable d'opter pour le dernier binaire de la version Android SDK Platform Tools, car les packages spécifiques à la distribution contiennent souvent des versions obsolètes.
Cas particulier: Comment configurer ADB sur le sous-système Windows pour Linux et ChromeOS
Sous-système Windows pour Linux (WSL) offre aux utilisateurs Windows un moyen transparent d'exécuter des applications Linux. Cependant, l'environnement n'offre pas encore un accès matériel USB complet. Par conséquent, ADB sous WSL ne peut pas accéder à votre appareil Android, même si vous l'installez de la manière susmentionnée. Néanmoins, il existe une solution de contournement officielle, qui utilise le logiciel open source usbipd-win projet. Pour en savoir plus, jetez un oeil à notre tutoriel sur comment configurer le relais USB dans WSL.
Pour ChromeOS, vous devez activer l'environnement de développement Linux intégré d'abord. Par défaut, il vous propose une instance Debian. Vous pouvez ensuite facilement configurer ADB en suivant les étapes mentionnées ci-dessus.
Juste pour couvrir toutes nos bases ici, les utilisateurs devront peut-être mettre un ./ devant les commandes ADB que nous répertorions dans les prochains didacticiels, en particulier lorsqu'elles utilisent les binaires extraits directement à partir du ZIP Platform Tools fourni par Google. C'est quelque chose que tout utilisateur * nix (ou utilisateur Windows exécutant PowerShell/Terminal) saura probablement, mais encore une fois, nous voulons que le plus grand nombre possible de personnes pour comprendre comment effectuer ces réglages pour Android, quelle que soit la quantité de votre système d'exploitation dont vous disposez. savoir.
Facultatif: Comment configurer ADB sur votre navigateur
Le protocole ADB peut être implémenté à l'aide de l'API WebUSB afin de contrôler les téléphones Android directement depuis les navigateurs Web. Encore un autre WebADB, alias ya-webadb, est l'un de ces projets qui permet aux utilisateurs d'exécuter la plupart des fonctionnalités fournies par ADB directement à partir du navigateur Web sans installer de binaire ou de pilote. Tout ce dont vous avez besoin est un navigateur Web prenant en charge l'API WebUSB (comme Google Chrome, Microsoft Edge ou Firefox) et vous êtes prêt à partir.
Facultatif: Comment utiliser ADB via Wi-Fi
Android 11 et les éditions supérieures prennent en charge nativement la connexion ADB via Wi-Fi. Cela élimine le besoin de gérer les problèmes de connexion USB courants et les étapes supplémentaires telles que Installation du pilote OEM Android sous Windows.
Afin de configurer le débogage sans fil, procédez comme suit :
- Assurez-vous que votre PC/Mac et votre téléphone sont connectés au même réseau sans fil.
- Sur votre téléphone, allez sur Options de développeur sous Paramètres et activer Débogage sans fil. Sur le Autoriser le débogage sans fil sur ce réseau ? pop-up, sélectionnez Permettre.
- Appuyez sur le Débogage sans fil option et sélectionnez Associer l'appareil avec le code d'appairage.
- Prenez note du code d'appairage, de l'adresse IP et du numéro de port affichés sur l'écran du téléphone.
- Sur votre PC/Mac, exécutez la commande suivante :
Utilisez l'adresse IP et le numéro de port de l'étape 4.adbpairIP_Address:Port
- Lorsque vous y êtes invité, entrez le code de couplage que vous avez reçu à l'étape 4. Un message devrait indiquer que votre appareil a été couplé avec succès.
- Ensuite, exécutez la commande suivante dans la fenêtre du terminal du PC/Mac :
Regarde le Adresse IP et port section sous Débogage sans fil à l'étape 3 pour l'adresse IP et le port.adbconnectIP_Address:Port
- Si tout se passe bien, vous devriez voir un message comme celui-ci :
connectedto 192.168.68.100:37173
- Vous êtes maintenant prêt à taper la commande shell ADB de votre choix.
Exemples de commandes ADB
Pour vérifier si vous avez installé ADB avec succès, connectez votre appareil à votre PC/Mac avec votre câble USB et exécutez le adb devices
commande comme décrit ci-dessus. Il devrait afficher votre appareil répertorié dans la fenêtre Invite de commandes/PowerShell/Terminal. Si vous obtenez un résultat différent, nous vous recommandons de recommencer avec les étapes.
Comme mentionné ci-dessus, vous pouvez utiliser ADB pour faire toutes sortes de choses sur un appareil Android. Certaines de ces commandes sont directement intégrées au binaire ADB et devraient fonctionner sur tous les appareils. Vous pouvez également ouvrir ce que l'on appelle un ADB Shell qui vous permettra d'exécuter des commandes directement sur l'appareil. Les commandes exécutées directement sur l'appareil peuvent varier d'un appareil à l'autre (puisque les OEM peuvent supprimer accéder à certaines, et également modifier le comportement d'ADB) et peut varier d'une version d'Android à l'autre selon Bien.
Ci-dessous, vous trouverez une liste d'exemples de commandes que vous pouvez exécuter sur votre appareil :
- Imprimez une liste des appareils connectés:
adb devices
- Tuez le serveur ADB:
adb kill-server
- Installer une application:
adb install
- Configurer la redirection de port:
adb forward tcp: 6100 tcp: 7100
- Copiez un fichier/répertoire depuis l'appareil:
adb pull
- Copiez un fichier/répertoire sur l'appareil:
adb push
- Lancez un shell ADB:
adb shell
Prime
Pour ceux qui souhaitent aller plus loin, vous pouvez suivre ce nouveau tutoriel que nous avons élaboré et qui vous guidera tout au long du processus. comment configurer ADB pour pouvoir utiliser la commande à partir de n'importe quel répertoire sur un bureau Windows ou Linux.
Que puis-je faire d'autre avec ADB?
Vous trouverez ci-dessous une liste de didacticiels XDA pour divers appareils qui détaillent de nombreuses applications de commandes ADB afin de modifier les paramètres cachés, de personnaliser les fonctionnalités OEM ou les interfaces utilisateur, et bien plus encore !
- Comment démarrer en mode de récupération à l'aide de combinaisons de boutons, d'ADB et d'applications racine
- Comment désinstaller le bloatware opérateur/OEM sans accès root
- Comment débloquer votre téléphone (et plus) sans vous connecter à un PC
- Comment charger des applications sur Android TV: méthodes d'installation d'APK et de chargement latéral ADB expliquées en étapes faciles à suivre !
- Ramenez les vignettes Paramètres rapides Wi-Fi et données mobiles dans Android 12 et versions ultérieures
- Contrôlez votre smartphone Android depuis votre PC gratuitement avec scrcpy
- Comment coupler des montres Android Wear à de nouveaux téléphones sans réinitialisation d'usine
Ce n'est que la pointe de l'iceberg. N'oubliez pas de vérifier nos commandes ADB pour chaque tutoriel d'utilisateur expérimenté pour connaître des trucs et astuces plus utiles pour utiliser ADB !