OBSD4* : wiki

Adb : Outil de communication avec Android

L'usage de l'outil adb pour communiquer avec vos périphériques sous Android (tel que smartphone, tablette, etc …) est possible !

Il existe une liste des périphériques connus pour fonctionner - vous y trouverez les identifiants vendeurs nécessaires.

Installation

Installation du paquet adb nécessaire :

# pkg_add adb

Version testée : adb-5.1.1.4 sous OpenBSD 6.x Stable

Configuration

Veillez à ce que votre périphérique android soit en mode “debug developper”, puis activez l'option “debug USB” !

Utilisation

Note : Toutes les commandes liées à l'usage d'adb s'utilisent en mode console !

adb devices

Pour être sûr que votre périphérique soit reconnu, utilisez la commande adb devices :

$ adb devices
List of devices attached
0123456789ABCDEF  device

À l'aide

Pour obtenir l'aide des différentes commandes liées à l'outil adb, tapez juste adb dans votre terminal-console.

Retrouvez l'équivalent dans le fichier texte fourni

Copier fichiers vers/depuis

Copier vers le périphérique

$ adb push -p /repertoire_local_machine/fichier /repertoire_peripherique_android

Copier depuis le périphérique

$ adb pull -a -p /repertoire_peripherique_android/fichier /repertoire_local_machine

L'option -a copie les informations telle que le temps, et le mode du fichier.

Note : Si le répertoire local de la machine n'est pas spécifié, le fichier depuis android sera copié dans le répertoire d'où est exécutée la commande adb.

Sauvegarde

La commande principale est :

$ adb backup -f nom_fichier_sauvegarde.ab

Note : Si l'option -f n'est pas spécifiée, le fichier backup.ab sera créé dans le répertoire courant où est exécutée la commande de sauvegarde…

Sauvegarder tout

$ adb backup -f nom_fichier_sauvegarde.ab -all 

Cette commande implique la sauvegarde de toutes les applications installées, dont les applications systèmes.

Note : Cette option intègre l'option -system - pas besoin de la spécifier !

Sauvegarde juste les applications

$ adb backup -f nom_fichier_sauvegarde.ab -apk -obb

Cette commande sauvegarde les fichiers apk des applications installées.

Note

  • L'option par défaut est -noapk qui signifie que les fichiers apk ne seront pas sauvegardés !
  • L'option -obb implique la sauvegarde des fichiers relatifs aux applications installées, tels que fichiers de sauvegarde, de config, etc … - par défaut, c'est l'option -noobb qui est active !

$ adb backup -f nom_fichier_sauvegarde.ab package1 package2 package_n 

Sauvegarde juste les applications dont les noms sont concernés !

Sauvegarde SD Carte

ATTENTION : Il est bien sûr nécessaire d'avoir une SD Carte dans votre appareil

$ adb backup -f nom_fichier_sauvegarde.ab -shared 

Sauvegarde le contenu de la SD Carte, ainsi que de tout répertoire de stockage partagé.

Note : Par défaut, c'est l'option -noshared qui est active et implique la non sauvegarde !

Sauvegarde Système

$ adb backup -f nom_fichier_sauvegarde.ab -system 

Note : Par défaut, c'est l'option -system qui est activée, ce qui a pour effet d'inclure les applications systèmes !

Sauvegarde Pertinente

Le moyen pertinent de sauvegarder tout correctement, sans s'occuper du contenu de la SD Carte, est :

$ adb backup -f nom_fichier_sauvegarde.ab -apk -obb -all

Sauvegarde des partitions

L'outil adb peut servir à sauvegarder indirectement les partitions de votre tablette …

Pour cela, il faut télécharger l'outil rkdump !

Puis l'installer ainsi :

$ adb push rkdump /data/
adb shell chmod 0755 /data/rkdump

Pour l'utiliser l'outil rkdump, veuillez lire son tutoriel

Restauration

$ adb restore nom_fichier_sauvegarde.ab 

Attention : Tout ce qui concerne le contenu du fichier de sauvegarde sera restauré !

Erreurs

'adb devices' : rien n'est affiché

Il peut être intéressant d'effectuer la manipulation suivante :

  • Créer le fichier ~/.android/adb_usb.ini, et écrivez dedans '0x' suivi de votre idVendor

Quoiqu'il en soit, redémarrer le serveur adb :

  $ adb kill-server

Puis relancez la commande adb devices.

'adb devices' : offline

Lorsque je tape adb devices, le périphérique est reconnu mais affiché offline.

$ adb devices
List of devices attached
0123456789ABCDEF offline

Il vous faudra alors :

  • désactivez l'option “Débogage USB”…
  • déconnectez/reconnectez votre tablette à l'ordinateur, en débranchant/rebranchant le câble USB.
  • activez à nouveau l'option “Débogage USB”

À ce moment-là, essayez à nouveau la commande adb devices ; vous devriez voir apparaître votre périphérique … correctement !

'adb devices' : unauthorized

Lorsque je tape adb devices, le périphérique est reconnu mais affiché unauthorized.

$ adb devices
* daemon not running. starting it now on port 5037 *
* daemon started successfully *
List of devices attached 
CQ7SFQMR95LBHQVW        unauthorized

Regardez votre téléphone, une fenêtre vous demande, normalement, d'autoriser l'association entre le téléphone et votre ordinateur. Accordez !

Puis relancez la commande adb devices.

'adb devices' : ???????????? no permissions

Lorsque je tape adb devices, le périphérique n'est pas reconnu et il est affiché ???????????? no permissions.

Il vous faut tuer le serveur, le redémarrer avec des droits administrateur ensuite le périphérique apparaîtra !

$ adb kill-server 
# adb start-server
* daemon not running. starting it now on port 5037 *
* daemon started successfully * 
$ adb devices
List of devices attached
0123456789ABCDEF device