Depuración remota en Firefox para Android

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

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.

Ves a la dirección about:config con 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:

Si estás utilizando una versión de Firefox anterior a la 27, tendrás que reiniciar el navegador para que se aplique la nueva configuración.

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

Ves 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/local/debugger-socket

Tendrá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, ves 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

A continuación verás un cuadro de diálogo en el dispositivo Android que pide que  confirmes la conexión:

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.

Archivos adjuntos

Archivo Tamaño Fecha Adjunto por
remote-debugger-about-config-toggle
95831 bytes 2013-08-01 15:36:19 wbamberg
remote-debugging-connect-menuitem
81023 bytes 2013-08-01 17:15:16 wbamberg
remote-debugging-deskopt-connect
85186 bytes 2013-08-01 17:20:07 wbamberg
remote-debugging-device-connect
167472 bytes 2013-08-01 17:26:11 wbamberg
remote-debugging-deskopt-select-target
90358 bytes 2013-08-01 19:41:30 wbamberg
remote-debugging-console
124892 bytes 2013-08-01 20:35:29 wbamberg
remote-debugging-debugger
266637 bytes 2013-08-01 20:35:45 wbamberg
remote-debugger-toolbox-settings
123586 bytes 2013-08-01 23:09:18 wbamberg
remote-debugging-device-enable
45182 bytes 2013-08-02 09:37:26 wbamberg
remote-debugging-overview
394293 bytes 2013-08-02 12:25:02 wbamberg

Etiquetas y colaboradores del documento

Colaboradores de esta página: StripTM, pacommozilla
Última actualización por: pacommozilla,