Diferencia entre revisiones de «Usuario:Juanda/android/adb»
De WikiEducator
(→2º método: desde el PC) |
|||
(63 revisiones intermedias por el mismo usuario no mostrado) | |||
Línea 3: | Línea 3: | ||
<div class="slides layout-regular template-default"> | <div class="slides layout-regular template-default"> | ||
<div class="slide"> | <div class="slide"> | ||
− | + | =Herramienta adb= | |
+ | </div> | ||
+ | <div class="slide"> | ||
+ | ==== ¿Qué es ADB? ==== | ||
+ | *[[wikipedia:Android_Debug_Bridge|ADB]] son las siglas de Android Debug Bridge | ||
+ | *Es una herramienta de desarrollo [http://developer.android.com/tools/help/adb.html 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... | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | ====Cómo usar ADB==== | ||
+ | *Debemos instalar el SDK de Android o el [http://developer.android.com/sdk/index.html ADT-Bundle] | ||
+ | *Está situado en el directorio platform-tools. | ||
+ | *Es conveniente añadirlo en la variable de entorno $PATH (fichero $HOME/.bashrc en Linux): | ||
+ | <source lang="bash"> | ||
+ | juanda@juanda-PC:~$ echo $PATH | ||
+ | /usr/local/bin:/usr/bin:/bin:/usr/games:/home/juanda/Android/sdk/tools:/home/juanda/Android/sdk/platform-tools | ||
+ | </source> | ||
+ | *No es necesario ser root para utilizarlo | ||
+ | *Normalmente se utiliza vía USB pero también puede hacerse vía wifi. | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | ==Configuración previa para usar adb== | ||
</div> | </div> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
<div class="slide"> | <div class="slide"> | ||
− | === | + | ====Windows==== |
− | + | *Tendremos que descargar el driver adb para el dispositivo. | |
− | + | *En la web de Android hay un [http://developer.android.com/tools/extras/oem-usb.html 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. |
− | * | + | |
</div> | </div> | ||
<div class="slide"> | <div class="slide"> | ||
− | |||
− | |||
− | |||
− | |||
*Para los que no aparecen habrá que ir a sus webs o contactar con su servicio de soporte. | *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! | *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 | ||
+ | </div> | ||
− | = | + | <div class="slide"> |
− | + | ||
+ | ====Mac==== | ||
+ | *No hace falta hacer nada. | ||
+ | *Filosofia MAC: O funciona directamente o no funciona. | ||
+ | </div> | ||
+ | <div class="slide"> | ||
=====Ubuntu===== | =====Ubuntu===== | ||
+ | *Es conveniente leer la documentación sobre [https://www.kernel.org/pub/linux/utils/kernel/hotplug/udev/udev.html 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: | *Tendremos que añadir el fichero 51-android.rules con los permisos y texto que figura a continuación: | ||
<source lang="bash"> | <source lang="bash"> | ||
Línea 80: | Línea 59: | ||
root@juanda-PC:/etc/udev/rules.d# | root@juanda-PC:/etc/udev/rules.d# | ||
</source> | </source> | ||
+ | </div> | ||
+ | <div class="slide"> | ||
*Tendremos que conocer el identificador del dispositivo (ID_DISPOSITIVO), así que conectamos el dispositivo y observamos las trazas del fichero de logs del sistema: | *Tendremos que conocer el identificador del dispositivo (ID_DISPOSITIVO), así que conectamos el dispositivo y observamos las trazas del fichero de logs del sistema: | ||
<source lang="bash"> | <source lang="bash"> | ||
Línea 95: | Línea 76: | ||
</source> | </source> | ||
*De las trazas observamos que el dispositivo se conecta como bus:3, device: 6 | *De las trazas observamos que el dispositivo se conecta como bus:3, device: 6 | ||
+ | </div> | ||
+ | |||
+ | <div class="slide"> | ||
*Ejecutamos lsusb para ver el vendor id del dispositivo, en nuestro caso 2207:0010: | *Ejecutamos lsusb para ver el vendor id del dispositivo, en nuestro caso 2207:0010: | ||
<source lang="bash"> | <source lang="bash"> | ||
Línea 111: | Línea 95: | ||
Bus 003 Device 006: ID 2207:0010 | Bus 003 Device 006: ID 2207:0010 | ||
</source> | </source> | ||
+ | </div> | ||
+ | |||
+ | <div class="slide"> | ||
*Actualizamos el fichero anterior: | *Actualizamos el fichero anterior: | ||
<source lang="bash"> | <source lang="bash"> | ||
Línea 116: | Línea 103: | ||
SUBSYSTEM=="usb", ATTR{id_vendor}=="2207", MODE="0666", GROUP="plugdev" | SUBSYSTEM=="usb", ATTR{id_vendor}=="2207", MODE="0666", GROUP="plugdev" | ||
</source> | </source> | ||
− | |||
*Reiniciamos el servicio de udev: | *Reiniciamos el servicio de udev: | ||
<source lang="bash"> | <source lang="bash"> | ||
Línea 124: | Línea 110: | ||
juanda@juanda-PC:/etc/udev/rules.d$ | juanda@juanda-PC:/etc/udev/rules.d$ | ||
</source> | </source> | ||
+ | </div> | ||
+ | |||
+ | <div class="slide"> | ||
*Paramos y arrancamos adb (android device bridge) y comprobamos la lista de dispositivos: | *Paramos y arrancamos adb (android device bridge) y comprobamos la lista de dispositivos: | ||
<source lang="bash"> | <source lang="bash"> | ||
Línea 134: | Línea 123: | ||
emulator-5554 device | emulator-5554 device | ||
</source> | </source> | ||
− | * | + | </div> |
+ | |||
+ | <div class="slide"> | ||
+ | |||
+ | ====Configuración del dispositivo==== | ||
+ | [[Archivo:Android_phone_settings.png|600px|thumb|center|(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. | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | *'''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."'' | ||
+ | </div> | ||
+ | |||
+ | |||
+ | <div class="slide"> | ||
+ | == Usos más frecuents de adb == | ||
+ | </div> | ||
+ | |||
+ | <div class="slide"> | ||
+ | ====adb help==== | ||
+ | *<code>adb</code> provee numerosas funciones que se pueden ver en detalle mediante el comando: | ||
+ | <source lang="bash">adb help</source> | ||
+ | *Veremos a continuación las más importantes | ||
+ | </div> | ||
+ | |||
+ | <div class="slide"> | ||
+ | ====Comprobación comunicación==== | ||
+ | * Mediante el comando: <code>adb devices</code> | ||
+ | *Si nos sale un número de serie, es que todo está correcto: | ||
<source lang="bash"> | <source lang="bash"> | ||
− | juanda@juanda-PC:~$ | + | juanda@juanda-PC:~$ adb devices |
− | + | List of devices attached | |
+ | 01a927828f90ccde device | ||
+ | juanda@juanda-PC:~$ | ||
</source> | </source> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
</div> | </div> | ||
− | |||
− | === | + | <div class="slide"> |
− | * | + | ====Comunicación vía shell==== |
− | : | + | * Mediante el comando: <code>adb shell</code> |
− | * | + | *Se pueden mandar comandos individuales de shell mediante: <code>adb shell <command_to_be_executed_on_the_device></code> |
+ | *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: | ||
<source lang="bash"> | <source lang="bash"> | ||
− | + | stty rows 60 cols 156 | |
− | + | ||
</source> | </source> | ||
</div> | </div> | ||
+ | <div class="slide"> | ||
+ | ====Transferencia de ficheros==== | ||
+ | * <code>adb push <local> <remote></code> | ||
+ | : Copiamos un fichero del ordenador al movil. | ||
+ | : Se pueden incluir tanto el path local como el remoto. | ||
+ | * <code>adb pull <remote> [<local>]</code> | ||
+ | :Copiamos un fichero remoto (del movil) al PC. | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | ====Ver el fichero de log en tiempo real==== | ||
+ | * <code>adb logcat</code> | ||
+ | * 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. | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | ====Instalación de aplicaciones==== | ||
+ | * <code>adb install <file></code> | ||
+ | *Los ficheros (aplicaciones) deben tener extensión .apk | ||
+ | *Es necesario tener el side-load marcado. | ||
+ | * <code>adb install -r <file></code>: Para actualizar | ||
+ | *adb uninstall Aplicacion.apk: Para desinstalar | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | ====Reiniciar el dispositivo==== | ||
+ | *<code>adb reboot</code> | ||
+ | *<code>adb reboot bootloader</code> | ||
+ | *<code>adb reboot recovery</code> | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | ==== Error "Device not found" ==== | ||
+ | *Se producen cuando adb no encuentra el dispositivo. | ||
+ | *Podemos reiniciar el servicio de adb: | ||
+ | <source lang="bash">adb kill-server | ||
+ | adb start-server</source> | ||
+ | *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). | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | ====Errores habituales==== | ||
+ | *No se reconoce el dispositivo: | ||
+ | <source lang="bash"> | ||
+ | juanda@juanda-PC:~$ adb devices | ||
+ | List of devices attached | ||
+ | ?????????? device | ||
+ | </source> | ||
+ | *False de permisos: | ||
+ | <source lang="bash"> | ||
+ | juanda@juanda-PC:~$ adb devices | ||
+ | List of devices attached | ||
+ | ???????????? no permissions | ||
+ | juanda@juanda-PC:~$ | ||
+ | </source> | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | *Driver incorrecto | ||
+ | *Configuración errónea fichero udev | ||
+ | *Reiniciar udev: | ||
+ | <source lang="bash"> | ||
+ | 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$ | ||
+ | </source> | ||
+ | *Reiniciar servicio adb: | ||
+ | <source lang="bash"> | ||
+ | adb kill-server | ||
+ | adb start-server | ||
+ | </source> | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | ====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: | ||
+ | <source lang="bash"> | ||
+ | sudo apt-get update | ||
+ | sudo apt-get install ia32-libs | ||
+ | </source> | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | ==adb vía wifi== | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | ====Primer método: desde el terminal==== | ||
+ | *Habilitar adb desde el dispositivo movil (debemos ser root): | ||
+ | <source lang="bash"> | ||
+ | setprop service.adb.tcp.port 5555 | ||
+ | stop adbd | ||
+ | start adbd | ||
+ | </source> | ||
+ | *Para deshabilitarlo: | ||
+ | <source lang="bash"> | ||
+ | setprop service.adb.tcp.port -1 | ||
+ | stop adbd | ||
+ | start adbd | ||
+ | </source> | ||
+ | </div> | ||
+ | <div class="slide"> | ||
− | === | + | ====2º método: desde el PC==== |
− | + | *Desde un equipo, '''con acceso USB''' | |
− | + | <source lang="bash"> | |
+ | adb tcpip 5555 | ||
+ | adb connect <ip>:5555 | ||
+ | </source> | ||
+ | *El puerto no hace falta, por defecto es el 5555 | ||
+ | *Para volver a escuchar por USB: | ||
+ | <source lang="bash"> | ||
+ | adb usb | ||
+ | </source> | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | *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! | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | ==Eclipse y adb== | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | *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á. | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | ==Ejemplos uso terminal Linux en en Android== | ||
+ | </div> | ||
+ | <div class="slide"> | ||
+ | ====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: | ||
+ | <source lang="bash"> | ||
+ | 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 | ||
+ | </source> | ||
+ | </div> | ||
− | + | <div class="slide"> | |
+ | *Añado una o varias entradas en el fichero pero hay un error al hacer el push: | ||
+ | <source lang="bash"> | ||
+ | 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$ | ||
+ | </source> | ||
+ | </div> | ||
− | ==adb | + | <div class="slide"> |
− | + | *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: | ||
+ | <source lang="bash"> | ||
+ | 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:~/ | ||
+ | </source> | ||
+ | </div> | ||
− | + | <div class="slide"> | |
+ | *La partición ya tiene permisos de lectura, hacemos el push: | ||
+ | <source lang="bash"> | ||
+ | juanda@dpto-01:~/Android/sdk/tools$ adb push hosts /etc/hosts | ||
+ | failed to copy 'hosts' to '/etc/hosts': Permission denied | ||
+ | juanda@dpto-01:~/ | ||
+ | </source> | ||
+ | *¡Vaya! Ahora fallan los permisos.... | ||
+ | </div> | ||
− | + | <div class="slide"> | |
+ | *Cambiamos permisos fichero /etc/hosts para su sustitución: | ||
+ | <source lang="bash"> | ||
+ | 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$ | ||
+ | </source> | ||
+ | </div> | ||
− | + | <div class="slide"> | |
− | + | *Comprobamos que todo ha ido bien y ponemos todo como estaba: | |
− | + | <source lang="bash"> | |
− | + | 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 # | ||
+ | </source> | ||
+ | </div> |
Última revisión de 11:10 15 may 2013