Esta guía explica como usar la depuración remota para inspeccionar o depurar código funcionando en Firefox para Android conectado por USB.
Esta guía se divide en dos partes: la primera parte, "Requisitos previos" cubre la materia que solo hay que hacer una vez, mientras que la segunda parte, "Conectando", cubre la materia que hay que hacer cada vez que conectas el dispositivo.
Requisitos previos
Primero, lo que necesitará:
- un ordenador de sobremesa o un portátil con Firefox funcionando
- un dispositivo Android con capacidad de arrancar Firefox para Android con Firefox para Android funcionando en él
- un cable USB que conecte ambos dispositivos
Configuración ADB
A continuación, necesitarás que el ordenador de sobremesa y el dispositivo Android hablen entre si utilizando la herramienta de la línea de comandos del adb.
En el dispositivo Android
- Habilita la depuración USB (solo el paso 2 de este enlace).
- Conecta el dispositivo con el ordenador mediante el cable USB.
En el ordenador de sobremesa
- Instala la versión correcta del SDK de Android para tu dispositivo.
- Utilizando el SDK de Android, instala las herramientas de la plataforma Android.
- Las herramientas de la plataforma Android instalan adb en un subdirectorio llamado "platform-tools" dentro del directorio donde hayas instalado el Android SDK. Asegúrate que el directorio "platform-tools" aparece en la variable "path" de tu sistema operativo.
Para comprobar que funciona, abre en tu ordenador de sobremesa la aplicación que te deja escribir comandos en línea del sistema operativo y teclea:
adb devices
Deberías ver una respuesta parecida a esta:
List of devices attached 51800F220F01564 device
(La cadena de texto hexadecimal será diferente.)
Si obtienes ésto, entonces adb ha encontrado tu dispositivo y has configurado correctamente el ADB.
Habilitar la depuración remota
A continuación, tienes que activar la depuración remota en el ordenador de sobremesa y en el dispositivo Android.
Firefox versión 24 y anteriores para Android
Para habilitar la depuración remota en el dispositivo, tienes que ajustar la preferencia devtools.debugger.remote-enabled al valor true.
Introduce la dirección about:config en Firefox para Android, escribe "devtools" dentro del cuadro de búsqueda y pulsa la tecla Search. Verás todas las preferencias de DevTools. Busca la preferencia devtools.debugger.remote-enabled preference, y pulsa "Toggle".
Firefox versión 25 y posteriores para Android
En Firefox v.25 y posteriores para Android, hay un elemento de menú para habilitar la depuración remota. Abre el menú, selecciona "Settings", luego "Developer tools" (en algunos dispositivos Android puede que necesites seleccionar "More" para ver la opción "Settings"). Marca la casilla "Remote debugging":
El navegador mostrará una notificación para recordarte que debes configurar el redireccionamiento de puertos, lo cuál haremos más adelante.
En el ordenador de sobremesa
En el ordenador, la depuración remota se habilita a través de un ajuste en la caja de herramientas. Abre la caja de herramientas, haz clic en el botón "Settings" de la barra de herramientas, y marca "Enable remote debugging" en la pestaña de Settings:
Verás una nueva opción en el menú "Web Developer" con la etiqueta "Connect...":
Conectarse
Ahora puedes conectar la herramienta de depuración remota con el dispositivo. En primer lugar, conecta el dispositivo al ordenador con un cable USB, si no lo has hecho todavía.
En el ordenador de sobremesa
Ve al símbolo del sistema y teclea:
adb forward tcp:6000 tcp:6000
(Si has cambiado el valor que el dispositivo Android usa para el puerto de depuración, deberás modificarlo a este valor.)
Para Firefox OS, teclea:
adb forward tcp:6000 localfilesystem:/data/data/org.mozilla.firefox/firefox-debugger-socketTendrás que volver a ejecutar este comando cada vez que conectes físicamente el ordenador de sobremesa y el dispositivo con el cable USB.
A continuación, ve al menú Web Developer del Firefox, y selecciona "Connect...". Verás una página parecida a ésta:
Si no has cambiado los números de puerto, elige 6000 y pulsa el botón 'Connect'.
En el dispositivo Android
Haz click en "OK". El ordenador de sobremesa espera unos segundos para darte tiempo para que confirmes en el cuadro de diálogo: si se agota el tiempo de espera, solo tienes que volver a hacer click en "Connect" en el cuadro de diálogo del ordenador de sobremesa.
En el ordenador de sobremesa
A continuación, el ordenador te muestra un cuadro de diálogo parecido a este:
Te pregunta si quieres depurar el contenido de la web que se ejecuta en alguna pestaña del navegador, o depurar el código del propio navegador.
- Verás una entrada por cada pestaña abierta debajo de "Available remote tabs", y haciendo click sobre una conectarás la herramienta de depuración al contenido web de la pestaña. Si quieres depurar el contenido de tu web, elige la pestaña pertinente.
- Verás una entrada debajo de "Available remote processes": este es el propio proceso del navegador. Elige esta opción si quieres depurar el código del navegador.
Elegimos conectarnos al sitio web mozilla.org. Se abrirá una ventana con la Caja de herramientas, vinculada a la pestaña del Firefox para Android que muestra el sito de mozilla.org:
La caja de herramientas y las herramientas que contiene, funcionan de la misma manera que lo hacen cuando están conectadas a un contenido local.