Android Debug Bridge: ADB

Introdución

O Android Debug Bridge ADB é unha utilidade que permite comunicarse cun dispositivo virtual ou real.
Esta composto dun servidor que sempre está funcionando no ordenador real e lánzase cando se inicia Eclipse ou cando se executa adb start-server. Este servidor sempre escoita nun porto impar comezando no 5555.
O comando atópase no cartafol do SDK en platform-tools/adb.
Funciona do mesmo xeito nos tres SOs.
Máis información en: http://developer.android.com/tools/help/adb.html

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.
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. Entre elas unha chamada com.android.providers.contacts.

Xestión dunha BBDD con sqlite3

A modo de exemplo vaise ver como facer consultas básicas, dentro do dispositivo, co xestor sqlite3.
Máis información en: http://www.sqlite.org/
Vaise traballar coa bases de datos dos contactos do teléfono.

sqlite3
Situarse na carpeta da aplicación. Toda aplicación ten unha estrutura de ficheiros semellante. Hai un directorio chamado databases.
Contén un ficheiro sqlite3 que é unha base de datos chamada contacts2.db.
Abrir os contactos do teléfono.
Crear un novo contacto ...
Localmente ...
Indicar o nome e o número e gardar o contacto.
Volver á axenda.
Lista de contactos.
Lanzar o xestor de Base de Datos. sqlite3 contacts2.db. Observar que consola se despraza cara ...
... a dereita.
Todo comando empeza por punto "." , salvo as sentencias sql, e estas deben rematar en ";".
.help amosa a axuda do xestor.
O resto da axuda do xestor.
.databases amosa a base de datos á que se está conectado.
.show amosa os valores para distintos parámetros de configuración, entre eles, mode.
.tables amosa as táboas da BD.
select * from raw_contacts (observar que falta o ";", o cal é introducido na seguinte liña). Amosa os nomes dos contactos.
select * from view_v1_phones; amosa os números de teléfono.
Executando .help vese como poder cambiar o modo en que se visualiza o contido dunha táboa.
.mode line indica que amose cada campo dunha táboa co seu valor nunha liña por campo. select * from raw_contacts;
.exit serve para saír do xestor e volver á consola do dispositivo.
Con exit saímos da consola do dispositivo e volvemos á consola do ordenador.
Con adb shell comando execútase o comando na consola do dispositivo e a saída amósase na consola do ordenador.

Nota: Se queremos reiniciar o dispositivo teremos que executar, dentro do shell, as seguintes ordes:

stop
start

Con isto faremos o 'efecto' de reiniciar. Isto é necesario no caso de ter un servizo que se executa cando se acende o dispositivo Android e queiramos comprobar o seu funcionamento.

Sacar ficheiros do dispositivo

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

adb pull
Neste caso sácase do dispositivo a BD anterior de contactos: contacts2.db. Co parámetro: adb pull. (<ruta sdk>/platform-tools/adb pull /data/data/com.android.providers.contacts/databases/contacts2.db)
Observar a BD contacts2.db no cartafol do ordenador.
Existen moitos xestores para manipular BBDD sqlite3, neste caso vaise instalar no ordenador un complemento no Mozilla Firefox e así vale para os tres SOs. Ir Ferramentas->Complementos en Firefox. Buscar sqlite e instalar o complemento Sqlite Manager
Reiniciar o Firefox.
Complemento instalado e activo.
En Ferramentas->SQLite Manager ábrese o xestor de BBDD.
Conectar á BD ...
... descargada do dispositivo.
Agora pódese manipular a BD.

Instalar unha aplicación

As aplicacións instalables teñen extensión apk como se verá na UNIDADE 2 do curso: adb installl.
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.
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 ...
... { } 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.