Simulador de Firefox OS

El complemento Simulador de Firefox OS es una herramienta que le permite probar y depurar aplicaciones para Firefox OS en el escritorio. El ciclo de «programar–probar–depurar» es mucho más rápido con el Simulador que con un dispositivo de hardware real y, obviamente, no necesitará uno para utilizarlo.

En esencia, el complemento del Simulador consiste de:

• el Simulador en sí: éste incluye el cliente de escritorio de Firefox OS, que es una versión de las capas superiores de Firefox OS que se ejecuta en su sistema operativo de escritorio. El Simulator también incluye algunas funciones de emulación adicionales que no están disponibles en las compilaciones de Firefox OS para escritorio estándares.
• el tablero: una herramienta ubicada en el navegador Firefox que permite iniciar y detener el Simulador; e instalar, desinstalar y depurar aplicaciones ejecutadas en él. El tablero también le permite instalar aplicaciones en un dispositivo real, y realiza comprobaciones a los archivos manifest para detectar problemas comunes.

La siguiente captura de pantalla muestra una sesión de depuración utilizando el Simulador.

El tablero se encuentra en la esquina superior derecha de la imagen, ubicado en una pestaña de Firefox. Hemos añadido una aplicación empaquetada, llamada «Where am I?». En la esquina superior izquierda, hay una aplicación ejecutándose en el Simulador. Asimismo, hemos conectado las herramientas de depuración, que están en la ventana inferior. Puede ver que se ha alcanzado un punto de interrupción en la aplicación.

Esta guía abarca los temas siguientes:

• cómo instalar el complemento del Simulador
• cómo añadir, eliminar y actualizar aplicaciones
• validación de manifest
• cómo ejecutar el Simulador
• cómo conectar herramientas de desarrollo como el depurador de JS a las aplicaciones ejecutándose en el Simulador
• las limitaciones del Simulador al compararlo cun un dispositivo con Firefox OS real

Para un tutorial práctivo que le muestra cómo utilizar el Simulador para depurar una aplicación web real, véase la página Paso a paso con el Simulador.

Instalar el complemento del Simulador

El Simulador está empaquetado y distribuido como un complemento de Firefox. Para instalarlo:

1. Mediante Firefox, vaya a la página del Simulador en addons.mozilla.org.
2. Pulse en «Añadir a Firefox».
3. Una vez que se haya descargado completamente el complemento, se le solicitará instalarlo: pulse en «Instalar ahora».

Debido al tamaño del complemento, Firefox puede colgarse durante unos segundos mientras se instala, y es posible que aparezca el cuadro de diálogo «Aviso: script sin respuesta». Si esto ocurre, pulse en «Continuar» y espere a que la instalación finalice. Este problema se sigue en el error n.º 814505.

Una vez instalado el complemento, Firefox comprobará si hay actualizaciones regularmente y lo mantendrá actualizado automáticamente.

Cuando instala el Simulador, el tablero se abre automáticamente; y puede volverlo a abrir en cualquier momento yendo al menú «Firefox» (o el menú «Herramientas» en OS X y Linux) ▸ «Desarrollador web» ▸ «Firefox OS Simulator»:

El tablero es la herramienta que usará para añadir su aplicación al Simulador y ejecutarla. Así es como luce:

Añadir, actualizar y desinstalar aplicaciones

Añadir aplicaciones

Para añadir una aplicación empaquetada al Simulador, abra el tablero, pulse en «Añadir un directorio» y seleccione el archivo manifest para su aplicación.

Para añadir una aplicación alojada en la Web, escriba un URL en el cuadro de texto «URL de página o manifest.webapp», y luego pulse en «Añadir URL». Si el URL apunta a un manifest, ese manifest se utilizará. Si no, el tablero generará un manifest para el URL. De este modo puede añadir cualquier sitio como aplicación con tan solo introducir su URL.

Cuando añade una aplicación, el tablero ejecutará una sserie de pruebas en el archivo manifest para comprbar problemas comunes. Consulte la sección Validación de manifest para obtener detalles sobre las pruebas que se ejecutan.

A menos de que la validación del manifest muestre que su aplicación tiene errores, el tablero ejecutará la aplicación en el Simulador automáticamente.

Gestión de aplicaciones

Una vez que ha añadido una aplicación, ésta aparecerá en la lista de aplicaciones instaladas del gestor:

Cada entrada proporciona información sobre la aplicación:

• su nombre, tomado del manifest
• su tipo, que puede ser «Empaquetada», «Alojada» o «Generada»
• un enlace a su archivo manifest
• el resultado de la validación del manifest

También proporciona tres órdenes:

• «Eliminar»: elimina la aplicación del Simulador o del tablero. Puede deshacer esta operación mientras no cierre la pestaña del tablero.
• «Actualizar»: utilice esta orden para actualizar la aplicación en el Simulador después de que le haya realizado cambios. Esto provoca que el tablero valide el manifest de nuevo. Si realiza cambios a su aplicación, éstos no se reflejarán automáticamente en la aplicación instalada: necesitará pulsar en «Actualizar» y reiniciar el Simulador si estuviera en ejecución.
• «Ejecutar»: ejecuta la aplicación en el Simulador.

Si ha conectado un dispositivo con Firefox OS a su equipo, verá una cuarta orden llamada «Instalar en dispositivo».

Validación de manifest

Cuando proporciona un manifest, el gestor ejecutará algunas pruebas de validación en él. El gestor informa tres clases de problemas:

• errores del manifest: problemas que evitarán que la aplicación se ejecute
• avisos del manifest: problemas que pueden evitar que la aplicación se ejecute correctamente
• avisos específicos del Simulador: funciones que su aplicación utiliza que aún no son compatibles con el Simulador

Se muestran resúmenes de los problemas encontrados en la entrada de la aplicación, al pulsar en los resúmenes se muestran más detalles.

Errores del manifest

El tablero informará las condiciones siguientes como errores, lo cual significa que no podrá ejecutar su aplicación si no los corrige:

• el manifest no incluye el campo obligatorio «name»
• el manifest no contiene código JSON válido
• la aplicación es alojada, pero el campo «type» en su manifest es «privileged» o «certified», que solo están disponibles para aplicaciones empaquetadas

A continuación se muestra el resultado de intentar añadir un archivo manifest que carece del campo «name»:

Avisos del manifest

El tablero informará de los siguientes problemas de manifest como avisos:

• faltan iconos
• el icono es más pequeño que 128 píxeles: todas las aplicaciones enviadas al Marketplace deben tener al menos un icono de al menos 128 × 128 píxeles
• el campo «type» es desconocido
• el manifest solicita un permiso no reconocido
• el manifest solicita un permiso que se denegará
• el manifest solicita un permiso para el que no se pudo determinar el nivel de acceso

Avisos específicos del Simulador

Finalmente, el gestor emitirá avisos para las aplicaciones que utilicen funciones de Firefox OS que todavía no son totalmente compatibles con el Simulador:

• el campo «type» es «certified», pero el Simulador no es compatible completamente con aplicaciones certificadas
• el manifest solicita un permiso para usar una API que el Simulador todavía no admite

Ejecutar el Simulador

El Simulador se puede abrir de dos maneras:

• si añade, actualiza o elimina una aplicación, o pulsa en el botón «Ejecutar» junto a una entrada de aplicación, el tablero abrirá automáticamente el Simulador y ejecutará su aplicación directamente
• si pulsa en el botón que dice «Detenido» en el lado izquierdo del tablero, el Simulador arrancará a la pantalla de inicio y necesitará navegar hacia su aplicación

Una vez que inició el Simulador mediante cualquiera de estas formas, el botón «Detenido» se vuelve verde y su etiqueta cambia a «Ejecutándose». Para detener el Simulador, pulse en este botón de nuevo.

El Simulador aparece en una ventana separada cuyo tamaño simula las dimensiones de una pantalla de 320 × 480 píxeles, y posee una barra de herramientas en la parte inferior que contiene algunas funciones adicionales.

Para simular toques, puede pulsar con el ratón y arrastrar mientras mantiene oprimido el botón izquieerdo. Asi que, para ver las aplicaciones incorporadas en el sistema —y las que haya instalado—, pulse y arrastre con el ratón sobre la pantalla de inicio:

Barra de herramientas del Simulador

La barra de herramientas ubicada en la parte inferior de la ventana contiene tres botones:

De izquierda a derecha, son el botón «Inicio», «Simulación de giro» y «Simulación de geolocalización».

• el primero le lleva a la pantalla de inicio,
• el segundo conmuta la orientación de la pantalla entre horizontal y vertical. Este cambio disparará el evento «deviceorientation»,
• y el tercero abre un cuadro de diálogo que le pedirá compartir su ubicación geográfica, ya sea utilizando sus coordenadas actuales o proporcionando coordenadas personalizadas; la API de geolocalización permite que las aplicaciones hagan uso de esta ubicación.

Activar el registro de consola

Si activa la casilla «Consola» que se ubica bajo el botón «Detenido/Ejecutándose», la Consola de errores se abrirá junto al Simulador. Su aplicación podrá crear registros en esta consola mediante el bojeto global «console».

Adjuntar herramientas para desarolladores

Puedes adjuntar herramientas para desarrolladores en el Simulador, para ayudar a depurar tu aplicación. Por el momento, puedes adjuntar únicamente el Depurador de JavaScript y la Consola Web, pero estamos trabajando para añadir soporte para mas herramientas para desarrolladores.

Mientras que el Simulador esté en funcionamiento otro botón aparecerá debajo de la casilla "Consola". Está etiquetado "Conectar...":

Haz clic, y te llevará a una página parecida a esta:

Haz clic en "Conectar" aquí y verás otra página, esta vez como esta:

Para usar el Depurador de JavaScript, selecciona aquí "chrome://prosthesis/content/shell.xul". Una vez ejecutado, necesitarás buscar los scripts de tu aplicación en el seleccionador de script, pero si abres tu aplicación y luego te conectas al depurador, el script principal de tu aplicación será seleccionado como predeterminado:

Para usar la Consola Web con tu aplicación, selecciona "Proceso Principal" en la ventana "Conectar a dispositivo remoto".

Lamentablemente, no hay depuración de objetivo único que funcione con ambos la Consola Web y el Depurador JS - pero puedes ejecutar dos dos casos simultáneamente de las herramientas de depuración, una dirigida a "shell.xul" y otra a "Proceso Principal".

Subir al dispositivo

Si tienes un dispositivo Firefox OS puedes conectarlo al Simulador, y por ello puedes subirlo desde el panel de control a el dispositivo.

Conectar un dispositivo

Para conectar un dispositivo, sigue las instrucciones en la guía de connecting a Firefox OS device to the desktop. Recuerda que no tienes que instalar adb, ya que el complemento del Simulador ya lo incluye.

Subir aplicaciones al dispositivo

Una vez que hayas configurado el dispositivo y escritorio, y conectado el dispositivo a tu escritorio mediante USB, verás aparecer el comentario "Dispositivo conectado." a la izquierda del panel de control, y un nuevo comando en la entrada por cada aplicación etiquetada "Subir":

Click "Push", and the app will be installed on the Firefox OS device.

Solucionar problemas en Linux

Si no puedes conectar tu dispositivo después de crear reglas udev, por favor vea este bug.

Limitaciones del Simulador

Recuerda que el Simulador de Firefox OS no es una simulación perfecta.

Limitaciones de hardware

Aparte del tamaño de la pantalla, el Simulador no simula las limitaciones de hardware del dispositivo Firefox OS tales como memoria disponible o velocidad de la CPU.

Códecs de Audio/Video

Los siguientes códecs dependen en decodificación acelerada por hardware y por lo cual no hay asistencia todavía:

• MP3
• AAC
• H.264 (MP4)
• WebM

Esto significa que no es posible usar el Simulador para probar la reproducción de video en aplicaciones y en páginas web como Youtube que dependen de esos códecs.

APIs no admitidas

Ciertas APIs que funcionan en el dispositivo no funcionarán en el Simulador, generalmente porque el soporte hardware no está disponible para el escritorio. Hemos implementado simulaciones para algunas APIs como geolocalización, y esperamos añadir más en futuras versiones. Sin embargo, por el momento las siguientes APIs no son compatibles. Usárlas podría traer errores o dar resultados incorrectos:

• Telephony
• WebSMS
• WebBluetooth
• Ambient Light
• Proximity
• Network Information
• eventos navigator.onLine y offline
• Vibración

Obtener ayuda

Si encuentras algún bug, por favor archívalos en GitHub. Si tienes alguna cuestión, preguntanos en dev-developer-tools mailing list o en #devtools en irc.mozilla.org.