Android Debug Bridge: ADB

Introdución

Máis información neste enlace.

• O Android Debug Bridge ADB é unha utilidade que permite comunicarse cun dispositivo virtual ou real.

O executable se atopa no cartafol de instalación do SDK/plataform-tools/ e ten nome 'adb' en Linux ou 'adb.exe' en Windows.

• Esta composto dun:

• Un servidor que sempre está funcionando no ordenador real e que vai servir de 'ponte' para mandar os comandos dende o cliente ao emulador ou dispositivo real Android. Este servidor sempre estará escoitando no porto 5037.

O servidor escanea os portos impares dende 5555 a 5585 buscando dispositivos reais ou emuladores aos que mandar os comandos.

• Un cliente ADB, que mandará as ordes ao emulador ou dispositivo real a través do servidor adb facendo uso do porto 5037.

• Cando un cliente se quere conectar ao emulador, este comproba se xa está executándose o servidor. En caso de que non estea, levanta o servizo.

Se queremos levantalo manualmente temos que executar a orde: adb start-server.

• Nota: Cada emulador vai empregar dous portos, un para a consola e outro onde escoita os comandos adb que recibe do cliente.

Por iso cando dende consola aparecen a lista de dispositivos, aparece nome-5554 en vez de 'nome-5555' (máis información neste enlace).

Dispositivos conectados

• Dispositivos conectados
• 

  A execución do comando <ruta sdk>/platform-tools/adb amosa a axuda do mesmo.

• 

  <ruta sdk>/platform-tools/adb devices amosa os dispositivos reais e virtuais conectados ao ordenador. Co parámetro -l amosa o tipo de dispositivo.

O shell do dispositivo

• Permite executar comandos dentro do dispositivo android.
• Android está baseado en Linux, por tanto poderanse executar moitos dos comandos dese SO nun dispositivo android.
• Importante: Para acceder en modo root en AVDs con versións de android 7 ou superior débese execuatar antes de entrar nel:adb root.

• adb shell
• 

  <ruta sdk>/platform-tools/adb shell permite conectarse á consola do dispositivo. Ollo que neste exemplo hai un só dipositivo conectado, logo veremos como se actúa cando hai dous ou máis.

• 

  A consola do dispositivo e a execución do comando pwd.

• 

  A execución do comando df para ver os puntos de montaxe, os seus tamaños e consumos de espazo.

• 

  A execución do comando mount que amosa en que directorios están montado os dispositivos físicos. Observar onde está montada a tarxeta SD, o formato de ficheiros, a codificación de caracteres, etc.Podedes comprobar como aparecer 3 cartafoles diferentes para a mesma tarxeta SD. Isto é debido a que a partires da versión 6.0 de Android, podemos indicar a aplicación que se vai instalar se vai necesitar permisos lectura/escritura sobre a tarxeta SD. Así, se unha aplicación soamente ten permiso de lectura amosará o contido de /mnt/runtime/read/. Máis información neste enlace.

• 

  ls -l amosa o contido en formato lista do directorio actual: o raíz. Na carpeta data ...

• 

  ... está outra carpeta chamada data que ...

• 

  ... contén as aplicacións instaladas no dispositivo.

Sacar ficheiros do dispositivo

• Outra das funcionalidades que nos permite é sacar ficheiros/carpetas do dispositivo.

• adb pull
• 

  Abrimos un emulador e buscamos un google unha imaxe calquera a descargar. Mantendo premido o rato sobre a imaxe aparece a opción de Download.

• 

  Podemos comprobar como por defecto, dita imaxe se garda na memoria interna do emulador. Debemos de anotar dita ruta.

• 

  Agora debemos facer uso do comando adb pull para 'traer' un arquivo dende o emulador á máquina real (<ruta sdk>/platform-tools/adb pull /storage/emulated/0/Download/pexels-photo.jpg). Máis información neste enlace. Podemos indicar o cartafol de destino da forma: <ruta sdk>/platform-tools/adb pull /storage/emulated/0/Download/pexels-photo.jpg /cartafol_destino/

Instalar unha aplicación

• As aplicacións instalables teñen extensión apk como se verá na UNIDADE 2 do curso: adb install.
• Neste caso vaise baixar de internet un visor PDF moi sinxelo para Android.

• adb install
• 

  Descargar o .apk do visor PDF de http://sourceforge.net/projects/andpdf/files/

• 

  A aplicación descargada.

• 

  <ruta sdk>/platform-tools/adb install Descargas/AndroidPdfViewer_1_0_1.apk instalará o paquete no dispositivo (en Windows: c:\RUTA_SDK\platform-tools\adb.exe install Downloads\AndroidPdfViewer_1_0_1.apk, estando situados no cartafol anterior a Downloads).

• 

  A aplicación instalada.

• 

  A aplicación instalada no directorio /data/data/ ...

• 

  ... do dispositivo.

Introducir ficheiro no dispositivo

• Ao igual que se sacan ficheiros do dispositivo tamén se poden introducir ficheiros no mesmo: adb push.

• adb push
• 

  Crear un documento PDF de proba ou escoller un xa feito.

• 

  O contido do documento PDF.

• 

  Imos introducilo no directorio asociado á SD card: sdcard

• 

  <ruta sdk>/platform-tools/adb push Documentos/ProbaPDF.pdf /sdcard/

• 

  Abrir o visor de PDFs no dispositivo e navegar ...

• 

  até /sdcard e

• 

  abrir o documento premendo en show.

• 

  O contido no documento visto no dispositivo.

• 

  adb shell ls /sdcard amosa que o documento está na tarxeta SD.

Desinstalar unha aplicación do dispositivo

• Ao igual que se pode instalar unha aplicación tamén se pode desinstalar: adb uninstall.
• Tamén se pode realizar de modo gráfico.

• adb uninstall
• 

  En modo gráfico desinstálase unha aplicación mantendo pulsada e arrastrándoa ao lixo. Vaise realizar con adb.

• 

  En /data/data podemos ver o nome da aplicación.

• 

  <ruta sdk>/platform-tools/adb uninstall net.sf.andpdf.pdfviewer

Varios dispositivos

• Até agora só traballamos con adb cun só dispositivo. Como actuar cando hai máis dun dispositivo real ou virtual?.

• Varios dispositivos
• 

  Crear un segundo AVD: AVDProba2.

• 

  Iniciar os 2 AVDs.

• 

  Parar o servidor adb: <ruta sdk>/platform-tools/adb kill-server

• 

  Buscar os dispositivos conectados: adb devices. Observar como se inicia o servidor adb.

• 

  Agora, cando hai máis dun dipositivo, para conectarse a un concreto hai que especificalo, sexa este real ou virtual: usando o parámetro -s nome do dispositivo. Neste caso adb -s emulator-5556 shell ls amosa o contido da raíz do segundo AVD.

Conectar un dispositivo físico

• Agora tócalle a quenda aos dispositivos físicos.
• Hai que habilitar a Depuración USB

• Dispositivo físico
• 

  Se non aparece en Ajustes->{ } Opciones de desarrollo. Ir a Ajustes -> Información del teléfono.

• 

  Pulsar 7 veces sobre Número de compilación e xa aparece ...Nos XIAOMI aparece ao premer 5 veces en 'versión MIUI'.

• 

  ... { } Opciones de desarrollo. Premer nesa opción. En versións máis antigas ir a Ajustes-> Aplicaciones->Desarrollo

• 

  Habilitar Depuración USB

• 

  Aceptar as advertencias.

• 

  <ruta sdk>/platform-tools/adb devices -l amosa o nome dos dispositivos e onde está conectado.

• 

  <ruta sdk>/platform-tools/adb -s nome-dispositivo é para interactuar con ese dispositivo, neste caso físico.

Conectar un dispositivo físico en Windows

• En Linux e OS X non é preciso instalar o driver do dispositivo para conectarse a el, pero en Windows si.
• Neste caso vaise usar de exemplo un dispositivo físico Samsung.

• Dispositivo físico en Windows
• 

  Conectamos o dispositivo físico ao ordenador Windows e <ruta sdk>/platform-tools/adb devices non amosa nada.

• 

  Neste caso buscamos o driver do dispositivo.

• 

  Descargalo e instalalo.

• 

  Aceptar as advertencias que amose.

• 

  Seguir aceptando ...

• 

  Premer en seguinte ...

• 

  Seleccionar o que indique ...

• 

  Instalar ...

• 

  Proceso instalación ...

• 

  Rematar instalación.

• 

  Aceptar por última vez.

• 

  <ruta sdk>/platform-tools/adb devices amosa o dispositivo físico conectado ao ordenador.

-- Ángel D. Fernández González e Carlos Carrión Alvarez. -- (2018).