Android Debug Bridge (adb) | Développeurs Android – Serveur d’impression

Android Debug Bridge (adb) est un outil de ligne de commande polyvalent qui vous permet de communiquer avec un
dispositif. La commande adb facilite diverses actions de l'appareil, telles que l'installation et le débogage.
Il donne accès à un shell Unix que vous pouvez utiliser pour exécuter diverses commandes sur un ordinateur.
dispositif. C'est un programme client-serveur qui comprend trois composants:

• Une cliente, qui envoie des commandes. Le client s'exécute sur votre machine de développement. Vous pouvez
      invoquer un client depuis un terminal de ligne de commande en émettant une commande adb.
• Un démon (adbd), qui exécute des commandes sur un périphérique. Le démon s'exécute en arrière-plan
      processus sur chaque appareil.
• Un serveur, qui gère la communication entre le client et le démon. Le serveur
      s'exécute en tant que processus d'arrière-plan sur votre machine de développement.

adb est inclus dans le package Android SDK Platform-Tools. Vous pouvez télécharger ce
package avec le SDK Manager, qui installe
à android_sdk/ plateforme-outils /. Ou si vous voulez le SDK Android autonome
Le paquet Platform-Tools, vous pouvez le télécharger ici.

Pour plus d'informations sur la connexion d'un périphérique à utiliser avec ADB, notamment sur l'utilisation de Connection
  Assistant pour résoudre les problèmes courants, voir
  Exécuter des applications sur un périphérique matériel.

Comment fonctionne adb

Lorsque vous démarrez un client adb, le client vérifie d’abord la présence d’un serveur adb.
processus déjà en cours d'exécution. S'il n'y en a pas, le processus du serveur démarre. Quand le serveur démarre,
il se connecte au port TCP local 5037 et écoute les commandes envoyées par les clients adb – tous les adb
les clients utilisent le port 5037 pour communiquer avec le serveur adb.

Le serveur établit ensuite les connexions avec tous les périphériques en cours d'exécution.
Il localise les émulateurs en balayant les ports impairs de la gamme
5555 à 5585, la gamme utilisée par les 16 premiers émulateurs. Où le serveur trouve un adb
daemon (adbd), il établit une connexion à ce port. Notez que chaque émulateur
utilise une paire de ports séquentiels – un port pair pour
connexions à la console et un port impair pour les connexions adb. Par exemple:

Emulateur 1, console: 5554
Emulateur 1, adb: 5555
Emulator 2, console: 5556
Émulateur 2, adb: 5557
etc…

Comme indiqué, l'émulateur connecté à l'adb sur le port 5555 est le même que l'émulateur
dont la console écoute sur le port 5554.

Une fois que le serveur a configuré les connexions à tous les périphériques, vous pouvez utiliser les commandes adb pour
accéder à ces appareils. Parce que le serveur gère les connexions aux périphériques et les gère
commandes de plusieurs clients adb, vous pouvez contrôler n’importe quel appareil depuis n’importe quel client (ou
à partir d'un script).

Activer le débogage des annonces sur votre appareil

Pour utiliser adb avec un appareil connecté via USB, vous devez activer
débogage USB dans les paramètres système de l'appareil, sous
Options de développeur.

Sur Android 4.2 et les versions ultérieures, l’écran des options du développeur apparaît.
caché par défaut. Pour le rendre visible, allez à
Paramètres> À propos du téléphone et appuyez sur Numéro de construction Sept fois. Retour à la précédente
écran pour trouver Options de développeur au fond.

Sur certains appareils, l'écran des options du développeur peut être localisé ou nommé différemment.

Vous pouvez maintenant connecter votre appareil avec USB. Vous pouvez vérifier que votre appareil est
connecté en exécutant périphériques adb du
android_sdk/ plateforme-outils / annuaire. Si connecté,
vous verrez le nom du périphérique répertorié comme "périphérique".

Remarque: Lorsque vous connectez un appareil fonctionnant sous Android 4.2.2 ou supérieur,
le système affiche une boîte de dialogue vous demandant si vous souhaitez accepter une clé RSA permettant
débogage via cet ordinateur. Ce mécanisme de sécurité protège les machines des utilisateurs car il garantit
le débogage USB et d’autres commandes adb ne peuvent être exécutés que si vous êtes en mesure de déverrouiller le
appareil et acquitter le dialogue.

Pour plus d'informations sur la connexion à un périphérique via USB, consultez l'article
Exécuter des applications sur un périphérique matériel.

Se connecter à un appareil via Wi-Fi

adb communique généralement avec le périphérique via USB, mais vous pouvez également utiliser adb via Wi-Fi après
certaines configurations initiales via USB, comme décrit ci-dessous. Si vous développez pour Wear OS, cependant,
vous devriez plutôt voir le guide
déboguer une application Wear OS,
qui a des instructions spéciales pour utiliser adb avec Wi-Fi et Bluetooth.

1. Connectez votre appareil Android et votre ordinateur hôte adb
   réseau Wi-Fi commun accessible aux deux.
   Attention, tous les points d'accès ne sont pas
   conviennent; vous devrez peut-être utiliser un point d'accès
   dont le pare-feu est configuré correctement pour prendre en charge adb.

2. Si vous vous connectez
   sur un appareil Wear OS, désactivez Bluetooth sur le téléphone qui est associé à l'appareil.

3. Connectez le périphérique à l'ordinateur hôte avec un câble USB.

4. Configurez le périphérique cible pour qu'il écoute une connexion TCP / IP sur le port 5555.

   annonce tcpip 5555
   

5. Déconnectez le câble USB du périphérique cible.

6. Recherchez l'adresse IP du périphérique Android. Par exemple, sur un appareil Nexus, vous pouvez trouver
   l'adresse IP à Réglages > A propos de la tablette
   (ou A propos du téléphone)> Statut > adresse IP. Ou,
   sur un appareil Wear OS, vous pouvez trouver l’adresse IP à l’adresse Réglages >
   Paramètres Wifi > Avancée > adresse IP.

7. Connectez-vous au périphérique par son adresse IP.

   adb connect device_ip_address
   

8. Vérifiez que votre ordinateur hôte est connecté au périphérique cible:

   $ adb devices
   Liste des périphériques connectés
   device_ip_address: 5555 périphérique
   

Vous êtes maintenant prêt à partir!

Si la connexion adb est perdue:

1. Assurez-vous que votre hôte est toujours connecté au même réseau Wi-Fi que votre appareil Android.

2. Reconnectez-vous en exécutant le adb connect pas encore.

3. Ou si cela ne fonctionne pas, réinitialisez votre hôte adb:

   adb kill-server
   

   Puis recommencez depuis le début.

Requête pour les appareils

Avant d'émettre des commandes adb, il est utile de connaître les instances de périphérique connectées.
  au serveur adb. Vous pouvez générer une liste de périphériques connectés à l’aide de la
dispositifs commander.

  
  
  
  périphériques adb -l
  

En réponse, adb imprime ces informations d'état pour chaque périphérique:

• Numéro de série: chaîne créée par adb pour identifier le périphérique de manière unique.
        par son numéro de port.
      Voici un exemple de numéro de série: émulateur-5554
• State: l'état de connexion du périphérique peut être l'un des suivants:
  • hors ligne: Le périphérique n'est pas connecté à adb ou n'est pas
            répondre.
  • dispositif: Le périphérique est maintenant connecté au serveur adb. Notez que
            cet état n'implique pas que le système Android est entièrement démarré et opérationnel car
            l'appareil se connecte à adb
            pendant le démarrage du système. Toutefois, après le démarrage, il s’agit de la situation opérationnelle normale.
            état d'un appareil.
  • aucun dispositif: Il n'y a pas d'appareil connecté.
• Description: Si vous incluez le -l option, la dispositifs
  La commande vous indique quel est le périphérique. Cette information est utile lorsque vous avez plusieurs appareils.
      connecté afin que vous puissiez les distinguer.

L'exemple suivant montre le dispositifs commande et sa sortie. Il ya trois
  appareils en cours d'exécution. Les deux premières lignes de la liste sont des émulateurs, et la troisième ligne est un matériel
  périphérique connecté à l'ordinateur.

$ adb devices
Liste des périphériques connectés
Produit de périphérique emulator-5556: sdk_google_phone_x86_64 modèle: Android_SDK_built_for_x86_64 périphérique: generic_x86_64
Produit de périphérique emulator-5554: sdk_google_phone_x86 modèle: Android_SDK_built_for_x86 périphérique: generic_x86
0a388e93 device usb: 1-1 produit: modèle de rasoir: Nexus_7 périphérique: flo

Emulateur non répertorié

le périphériques adb La commande a une séquence de commandes en virage qui provoque l'exécution
  émulateur (s) à ne pas apparaître dans la périphériques adb sortie même si
  les émulateurs sont visibles sur votre bureau. Cela arrive quand tout du suivant
  les conditions sont vraies:

1. Le serveur adb n'est pas en cours d'exécution, et
2. Vous utilisez le émulateur commande avec le -Port ou
   -ports option avec une valeur de port impair comprise entre 5554 et 5584, et
3. Le port impair que vous avez choisi n’est pas occupé. La connexion du port peut donc être établie à la
        numéro de port spécifié, ou s’il est occupé, l’émulateur bascule sur
        un autre port répondant aux exigences de 2, et
4. Vous démarrez le serveur adb après avoir démarré l'émulateur.

Une façon d’éviter cette situation est de laisser l’émulateur choisir ses propres ports et de ne pas le lancer plus souvent.
    que 16 émulateurs à la fois. Une autre méthode consiste à toujours démarrer le serveur adb avant d’utiliser le
émulateur commande, comme expliqué dans les exemples suivants.

Exemple 1: Dans la séquence de commande suivante, le périphériques adb la commande commence
  le serveur adb, mais la liste des périphériques n'apparaît pas.

Arrêtez le serveur adb et entrez les commandes suivantes dans l'ordre indiqué. Pour le nom avd, fournissez
un nom avd valide de votre système. Pour obtenir une liste de noms avd, tapez émulateur -list-avds.
le émulateur la commande est dans le android_sdk/outils annuaire.

$ adb kill-server
$ emulator -avd Nexus_6_API_25 -port 5555
$ adb devices

Liste des périphériques connectés
* le démon ne fonctionne pas. en le démarrant maintenant sur le port 5037 *
* démon a démarré avec succès *

Exemple 2: Dans la séquence de commande suivante, périphériques adb affiche le
  liste des périphériques car le serveur adb a été démarré en premier.

Pour voir l'émulateur dans le périphériques adb sortie, arrêtez le serveur adb, puis démarrez
  à nouveau après avoir utilisé le émulateur commande et avant d'utiliser le
périphériques adb commande, comme suit:

$ adb kill-server
$ emulator -avd Nexus_6_API_25 -port 5557
$ adb start-server
$ adb devices

Liste des périphériques connectés
émulateur-5557 périphérique

Pour plus d'informations sur les options de ligne de commande de l'émulateur,
voir Utilisation de la ligne de commande
  Paramètres.

Envoyer des commandes à un périphérique spécifique

Si plusieurs périphériques sont en cours d'exécution, vous devez spécifier le périphérique cible.
  lorsque vous émettez la commande adb. Pour spécifier la cible, utilisez le dispositifs commander
  pour obtenir le numéro de série de la cible. Une fois que vous avez le numéro de série, utilisez le
-s option avec les commandes adb pour spécifier le numéro de série.
  Si vous allez lancer beaucoup de commandes adb, vous pouvez définir le paramètre
$ ANDROID_SERIAL variable d'environnement pour contenir le numéro de série
  au lieu. Si vous utilisez les deux
-s et $ ANDROID_SERIAL, -s annule
$ ANDROID_SERIAL.

Dans l’exemple suivant, la liste des périphériques connectés est obtenue, puis le numéro de série
  numéro de l’un des appareils est utilisé pour installer le helloWorld.apk sur cet appareil.

$ adb devices
Liste des périphériques connectés
émulateur-5554 périphérique
émulateur-5555 périphérique

$ adb -s emulator-5555 installer helloWorld.apk

Remarque: Si vous émettez une commande sans spécifier de périphérique cible
    lorsque plusieurs périphériques sont disponibles, adb génère une erreur.

Si vous avez plusieurs périphériques disponibles, mais qu'un seul est un émulateur,
Utilisez le -e option pour envoyer des commandes à l'émulateur. De même, s’il existe plusieurs
périphériques, mais un seul périphérique matériel connecté, utilisez le -ré option pour envoyer des commandes à
le périphérique matériel.

Installer une application

Vous pouvez utiliser adb pour installer un APK sur un émulateur ou un périphérique connecté.
avec le installer commander:

adb installer path_to_apk

Vous devez utiliser le -t option avec le installer
commande lorsque vous installez un test APK. Pour plus d'informations,
    voir -t.

Pour plus d'informations sur la création d'un fichier APK que vous pouvez installer sur un émulateur / périphérique
Par exemple, voir Construire et exécuter votre application.

Notez que si vous utilisez Android Studio, vous n'avez pas besoin d'utiliser directement adb pour installer
  votre application sur l'émulateur / le périphérique. Au lieu de cela, Android Studio gère l’emballage et l’installation.
  de l'application pour vous.

Configurer la redirection de port

Vous pouvez utiliser le vers l'avant commande pour configurer la redirection de port arbitraire, qui
  transmet les demandes sur un port hôte spécifique à un autre port sur un périphérique.
  L'exemple suivant définit la transmission du port hôte 6100 vers le port de périphérique 7100:

annonce tcp: 6100 tcp: 7100

L'exemple suivant configure la transmission du port hôte 6100 vers local: logd:

adb forward tcp: 6100 local: logd

Copier des fichiers vers / depuis un périphérique

Utilisez le tirez et pousser commandes pour copier des fichiers dans
et d'un appareil. Contrairement à la installer commander,
qui ne copie qu'un fichier APK vers un emplacement spécifique, le tirez et pousser
Les commandes vous permettent de copier des répertoires et des fichiers arbitraires à n’importe quel emplacement d’un périphérique.

Pour copier un fichier ou un répertoire et ses sous-répertoires de le dispositif,
faire ce qui suit:

adb pull éloigné local

Pour copier un fichier ou un répertoire et ses sous-répertoires à le dispositif,
  faire ce qui suit:

adb push local éloigné

Remplacer local et éloigné avec les chemins de
les fichiers / répertoires cibles sur votre machine de développement (local) et sur le
appareil (à distance). Par exemple:

adb push foo.txt /sdcard/foo.txt

Arrêtez le serveur publicitaire

Dans certains cas, vous devrez peut-être mettre fin au processus du serveur adb, puis le redémarrer.
pour résoudre le problème (par exemple, si adb ne répond pas à une commande).

Pour arrêter le serveur adb, utilisez le adb kill-server commander.
Vous pouvez ensuite redémarrer le serveur en émettant une autre commande adb.

adb[-d|-e|-s[-d|-e|-s[-d|-e|-s[-d|-e|-snuméro de série] commander

$ ANDROID_PRODUCT_OUT = / out / target / product / generic
adb sync

adb[-d|-e|-s[-d|-e|-s[-d|-e|-s[-d|-e|-snuméro de série]coquille shell_command

adb[-d|-e|-s[-d|-e|-s[-d|-e|-s[-d|-e|-snuméro de série]coquille

un m commander

adb shell am start - a android.intent.action.VIEW

pm commander

adb shell pm désinstaller com.example.MyApp

dpm commander

adb shell dpm commander

screencap nom de fichier

adb shell screencap /sdcard/screen.png

$ adb shell
shell@ $ screencap /sdcard/screen.png
shell@ $ exit
$ adb pull /sdcard/screen.png

screenrecord[[[[options] nom de fichier

adb shell screenrecord /sdcard/demo.mp4

$ adb shell
shell@ $ screenrecord --verbose /sdcard/demo.mp4
(press Control + C to stop)
shell@ $ exit
$ adb pull /sdcard/demo.mp4

screenrecord --bit-rate 6000000 /sdcard/demo.mp4

adb shell cmd package dump-profiles paquet

adb pull /data/misc/profman/paquet.SMS

adb shell ls /system/bin

$ adb -s emulator-5554 shell
$ sqlite3 /data/data/com.example.app/databases/rssitems.db
SQLite version 3.3.12
Enter ".help" for instructions