Curso de Android

De WikiEducator
Saltar a: navegación, buscar


¿Qué es ADB?

  • ADB son las siglas de Android Debug Bridge
  • Es una herramienta de desarrollo incluida en el SDK de Android.
  • Comunica el dispositivo Android o el emulador con el ordenador.
  • Sirve para instalar aplicaciones, ver ficheros de log, hacer push o pull de ficheros...

Cómo usar ADB

  • Debemos instalar el SDK de Android o el ADT-Bundle
  • Está situado en el directorio platform-tools.
  • Es conveniente añadirlo en la variable de entorno $PATH (fichero $HOME/.bashrc en Linux):
juanda@juanda-PC:~$ echo $PATH
/usr/local/bin:/usr/bin:/bin:/usr/games:/home/juanda/Android/sdk/tools:/home/juanda/Android/sdk/platform-tools
  • No es necesario ser root para utilizarlo
  • Normalmente se utiliza vía USB pero también puede hacerse vía wifi.

Configuración previa para usar adb

Windows

  • Tendremos que descargar el driver adb para el dispositivo.
  • En la web de Android hay un listado de enlaces para la descarga de los drivers de los principales fabricantes.
  • Puedes encontrar un driver genérico que se encuentra en la carpeta android-sdk-windows\usb_driver del SDK Android.
  • Lo más probable es que tengas que utilizar el driver del fabricante.
  • A veces también hace falta otro ejecutable adb distinto al que aparece en el Android SDK.
  • Para los que no aparecen habrá que ir a sus webs o contactar con su servicio de soporte.
  • No siempre existen los drivers o funcionan como debieran ¡ojo!
  • En ocasiones para que funcione se utiliza el driver de google pero modificando el fichero de instalación del driver: adb_usb.ini

Mac

  • No hace falta hacer nada.
  • Filosofia MAC: O funciona directamente o no funciona.
Ubuntu
  • Es conveniente leer la documentación sobre udev (gestión dinámica de dispositivos en Linux)
  • Tendremos que añadir el fichero 51-android.rules con los permisos y texto que figura a continuación:
root@juanda-PC:/etc/udev/rules.d# ls -l 51-android.rules 
-rw-r--r-- 1 root root 76 feb 24 11:33 51-android.rules
root@juanda-PC:/etc/udev/rules.d# cat 51-android.rules 
SUBSYSTEM=="usb", ATTR{idVendor}=="ID_DISPOSITIVO", MODE="0666", GROUP="plugdev"
root@juanda-PC:/etc/udev/rules.d#
  • Tendremos que conocer el identificador del dispositivo (ID_DISPOSITIVO), así que conectamos el dispositivo y observamos las trazas del fichero de logs del sistema:
tail -100f /var/log/syslog
Feb 24 11:12:27 juanda-PC kernel: [ 1918.767308] usb 3-1: new high-speed USB device number 6 using xhci_hcd
Feb 24 11:12:27 juanda-PC mtp-probe: checking bus 3, device 6: "/sys/devices/pci0000:00/0000:00:14.0/usb3/3-1"
Feb 24 11:12:27 juanda-PC kernel: [ 1918.784245] usb 3-1: ep 0x81 - rounding interval to 32768 microframes, ep desc says 0 microframes
Feb 24 11:12:27 juanda-PC kernel: [ 1918.784252] usb 3-1: ep 0x83 - rounding interval to 32768 microframes, ep desc says 0 microframes
Feb 24 11:12:27 juanda-PC kernel: [ 1918.784256] usb 3-1: ep 0x4 - rounding interval to 32768 microframes, ep desc says 0 microframes
Feb 24 11:12:27 juanda-PC kernel: [ 1918.784796] scsi11 : usb-storage 3-1:1.0
Feb 24 11:12:27 juanda-PC mtp-probe: bus: 3, device: 6 was not an MTP device
Feb 24 11:12:28 juanda-PC kernel: [ 1919.781950] scsi 11:0:0:0: Direct-Access     Linux    File-CD Gadget   0000 PQ: 0 ANSI: 2
Feb 24 11:12:28 juanda-PC kernel: [ 1919.782212] scsi 11:0:0:1: Direct-Access     Linux    File-CD Gadget   0000 PQ: 0 ANSI: 2
Feb 24 11:12:28 juanda-PC kernel: [ 1919.782607] sd 11:0:0:0: Attached scsi generic sg8 type 0
  • De las trazas observamos que el dispositivo se conecta como bus:3, device: 6
  • Ejecutamos lsusb para ver el vendor id del dispositivo, en nuestro caso 2207:0010:
juanda@juanda-PC:/etc/udev$ lsusb
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 004 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 001 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub
Bus 002 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub
Bus 001 Device 003: ID 413c:2111 Dell Computer Corp. 
Bus 001 Device 004: ID 046d:c063 Logitech, Inc. DELL Laser Mouse
Bus 004 Device 002: ID 059f:104a LaCie, Ltd 
Bus 002 Device 003: ID 058f:6362 Alcor Micro Corp. Flash Card Reader/Writer
Bus 001 Device 006: ID 0cf3:e004 Atheros Communications, Inc. 
Bus 003 Device 006: ID 2207:0010
  • Actualizamos el fichero anterior:
juanda@juanda-PC:/etc/udev/rules.d$ cat 51-android.rules 
SUBSYSTEM=="usb", ATTR{id_vendor}=="2207", MODE="0666", GROUP="plugdev"
  • Reiniciamos el servicio de udev:
juanda@juanda-PC:/etc/udev/rules.d$ sudo service udev restart
udev stop/waiting
udev start/running, process 9069
juanda@juanda-PC:/etc/udev/rules.d$
  • Paramos y arrancamos adb (android device bridge) y comprobamos la lista de dispositivos:
juanda@juanda-PC:/etc/udev/rules.d$ adb kill-server
juanda@juanda-PC:/etc/udev/rules.d$ adb start-server
* daemon not running. starting it now on port 5037 *
* daemon started successfully *
juanda@juanda-PC:/etc/udev/rules.d$ adb devices
List of devices attached 
emulator-5554	device

Configuración del dispositivo

(Configuración de dispositivo físico Android para despliegue de aplicaciones de desarrollo)
  • En Android 4 la habilitación del USB Debug está en Ajustes > Opciones de Desarrollo.
  • Nota: A partir de Android 4.2, las opciones de desarrollo no están visibles por defecto: "To make it available, go to Settings > About phone and tap Build number seven times. Return to the previous screen to find Developer options."


Usos más frecuents de adb

adb help

  • adb provee numerosas funciones que se pueden ver en detalle mediante el comando:
adb help
  • Veremos a continuación las más importantes

Comprobación comunicación

  • Mediante el comando: adb devices
  • Si nos sale un número de serie, es que todo está correcto:
juanda@juanda-PC:~$ adb devices
List of devices attached 
01a927828f90ccde	device
juanda@juanda-PC:~$

Comunicación vía shell

  • Mediante el comando: adb shell
  • Se pueden mandar comandos individuales de shell mediante: adb shell <command_to_be_executed_on_the_device>
  • Desde Android 4.2.2 se pide autorizar el acceso a cada ordenador desde una ventana emergente el el dispositivo movil.
  • Si el terminal resulta pequeño podemos ejecutar el siguiente comando:
stty rows 60 cols 156

Transferencia de ficheros

  • adb push <local> <remote>
Copiamos un fichero del ordenador al movil.
Se pueden incluir tanto el path local como el remoto.
  • adb pull <remote> [<local>]
Copiamos un fichero remoto (del movil) al PC.

Ver el fichero de log en tiempo real

  • adb logcat
  • Devuelve una ingente cantidad de eventos escritos en diversos registros sobre el funcionamiento del sistema
  • Es útil usar algún filtro o redirigir a un fichero.

Instalación de aplicaciones

  • adb install <file>
  • Los ficheros (aplicaciones) deben tener extensión .apk
  • Es necesario tener el side-load marcado.
  • adb install -r <file>: Para actualizar
  • adb uninstall Aplicacion.apk: Para desinstalar

Reiniciar el dispositivo

  • adb reboot
  • adb reboot bootloader
  • adb reboot recovery

Error "Device not found"

  • Se producen cuando adb no encuentra el dispositivo.
  • Podemos reiniciar el servicio de adb:
adb kill-server 
adb start-server
  • Hay que asegurarse que la opción USB debugging o Android Debug Bridge desde Ajustes->Herramientas de Desarrollo (varía un poco de versión a versión).

Errores habituales

  • No se reconoce el dispositivo:
juanda@juanda-PC:~$ adb devices
List of devices attached 
??????????	device
  • False de permisos:
juanda@juanda-PC:~$ adb devices
List of devices attached 
????????????	no permissions
juanda@juanda-PC:~$
  • Driver incorrecto
  • Configuración errónea fichero udev
  • Reiniciar udev:
juanda@juanda-PC:/etc/udev/rules.d$ sudo service udev restart
udev stop/waiting
udev start/running, process 9069
juanda@juanda-PC:/etc/udev/rules.d$
  • Reiniciar servicio adb:
adb kill-server 
adb start-server

Error en funcionamiento de dispositivos físicos y emuladores

  • El error es el siguiente:
[2013-02-22 13:55:20 - adb] Unexpected exception 'Cannot run program "/home/juanda/Android/sdk/platform-tools/adb": java.io.IOException: error=2, No existe el archivo o el directorio' while attempting to get adb version from '/home/juanda/Android/sdk/platform-tools/adb'
  • Solución, instalar los siguientes paquetes:
sudo apt-get update
sudo apt-get install ia32-libs

adb vía wifi

Primer método: desde el terminal

  • Habilitar adb desde el dispositivo movil (debemos ser root):
setprop service.adb.tcp.port 5555
stop adbd
start adbd
  • Para deshabilitarlo:
setprop service.adb.tcp.port -1
stop adbd
start adbd

2º método: desde el PC

  • Desde un equipo, con acceso USB
adb tcpip 5555
adb connect <ip>:5555
  • El puerto no hace falta, por defecto es el 5555
  • Para volver a escuchar por USB:
adb usb
  • Primer método: hay que teclear mucho desde el movil, ¡muy pesado!
  • Segundo método: hace falta llevar el cable usb, ¡una lata!
  • Tercer método: Instalar una aplicación en el móvil: adbWireless, WiFi ADB o ADB WiFi. ¡Necesitan acceso root!

Eclipse y adb

  • Si adb no está correctamente configurado desde Eclipse no funcionará.
  • Indicar que queremos desplegarlo en el dispositivo al ejecutar la aplicación
  • Cuando ejecutemos la aplicación veremos una pantalla similar a la siguiente:
Eclipse->Windows->Open Perspective->DDMS
  • Aparecerán los emuladores que tengamos corriendo y los dispositivos físicos que estén enchufados a la entrada USB del PC
  • En caso de tener un solo dispositivo disponible esta pantalla no aparecerá.

Ejemplos uso terminal Linux en en Android

Actualización fichero /etc/hosts

  • El comando para ver las interfaces del movil es netcfg (no ifconfig)
  • El fichero hosts se encuentra en /system/etc/hosts
  • Obtenemos el fichero hosts del movil para modificarlo:
juanda@dpto-01:~/Android/sdk/tools$ adb pull /etc/hosts
0 KB/s (25 bytes in 0.038s)
juanda@dpto-01:~/Android/sdk/tools$ cat hosts
127.0.0.1		    localhost
  • Añado una o varias entradas en el fichero pero hay un error al hacer el push:
juanda@dpto-01:~/Android/sdk/tools$ vi hosts 
juanda@dpto-01:~/Android/sdk/tools$ cat hosts
127.0.0.1    localhost
192.168.1.1  incidencias.jd  www.incidencias.jd
192.168.1.1  spp.jd  www.spp.jd
juanda@dpto-01:~/Android/sdk/tools$ adb push hosts /etc/hosts
failed to copy 'hosts' to '/etc/hosts': Read-only file system
juanda@dpto-01:~/Android/sdk/tools$
  • En muchos dispositivos la partición /system se monta como solo lectura así que hay que montarla con permisos de escritura.
  • A continuación todas las trazas al cambiarlo en mi sistema:
juanda@dpto-01:~/Android/sdk/tools$ adb shell
shell@android:/ $ su -
shell@android:/ # mount -o rw,remount /system                              
shell@android:/ # exit
shell@android:/ $ exit
juanda@dpto-01:~/
  • La partición ya tiene permisos de lectura, hacemos el push:
juanda@dpto-01:~/Android/sdk/tools$ adb push hosts /etc/hosts
failed to copy 'hosts' to '/etc/hosts': Permission denied
juanda@dpto-01:~/
  • ¡Vaya! Ahora fallan los permisos....
  • Cambiamos permisos fichero /etc/hosts para su sustitución:
juanda@dpto-01:~/Android/sdk/tools$ adb shell
shell@android:/ $ cd etc
shell@android:/etc $ su - 
shell@android:/system/etc # chmod 777 hosts
shell@android:/system/etc # exit
shell@android:/etc $ exit
juanda@dpto-01:~/Android/sdk/tools$ adb push hosts /etc/hosts
2 KB/s (103 bytes in 0.040s)
juanda@dpto-01:~/Android/sdk/tools$
  • Comprobamos que todo ha ido bien y ponemos todo como estaba:
juanda@dpto-01:~/Android/sdk/tools$ adb shell
shell@android:/ $ su -
shell@android:/ # cd etc 
shell@android:/etc # chmod 644 hosts
shell@android:/etc # ls -l hosts
-rw-r--r-- root     root          103 2013-04-12 13:00 hosts
shell@android:/etc # mount -o ro,remount /system
shell@android:/etc # cat hosts
127.0.0.1    localhost
192.168.1.1  incidencias.jd  www.incidencias.jd
192.168.1.1  spp.jd  www.spp.jd
shell@android:/etc #