Empaquetado e Instalaci贸n

Empaquetando tu extensi贸n

Mozilla actualmente esta considerando implementar una aplicaci贸n con interfaz visual para empaquetar y cargar extensiones. Mira el Bug 1185460 para m谩s informaci贸n. Hasta entonces, sigue los pasos que aparecen a continuaci贸n.

Las extensiones para Firefox son empaquetadas como archivos XPI, los cuales son solamente archivos ZIP, con extensi贸n "xpi".

Un truco es que el archivo ZIP debe ser un archivo que contenga los archivos de la extensi贸n y no la carpeta que los contiene.

Windows

  1. Abre la carpeta que contiene los archivos de tu extensi贸n.
  2. Selecciona todos los archivos.
  3. Con clic derecho elige Enviar a  鈫 Carpeta comprimida (zip).
  4. Cambia el nombre del archivo resultante de something.zip a something.xpi.

Screenshot of the Windows Explorer context menu showing Send to compressed (zipped) folder

Mac OS X

  1. Abre la carpeta que contiene los archivos de tu extensi贸n.
  2. Selecciona todos los archivos.
  3. Con clic derecho elige Comprimir n elementos.
  4. Cambia el nombre del archivo resultante de something.zip a something.xpi.

Screenshot of the Finder context menu showing the Compress 15 Items option

Linux / Mac OS X Terminal

  1. cd path/to/my-extension/
  2. zip -r ../my-extension.xpi *

Instalando tu extensi贸n

  1. Navega a about:addons
  2. Arrastra y suelta el XPI dentro de la p谩gina, o abre el men煤 de opciones y escoge "Instalar complemento desde archivo..."
  3. Da clic en "Instalar" en el di谩logo que aparecer谩

Instalando tu extensi贸n en Firefox OS

Tu puedes instalar tu extensi贸n desde WebIDE en un escritorio conectado v铆a USB o Wifi. Abre path/to/my-extension/ como una Aplicaci贸n empaquetada en WebIDE.

Cuando la validaci贸n de manifest.json es correcta podr谩s instalar y ejecutar tu extensi贸n en el dispositivo con Firefox OS conectado.

Para instalar extensiones debe tener habilitada la opci贸n en Configuraci贸n->Complementos del dispositivo con Firefox OS.

Resoluci贸n de problemas

Aqu铆 est谩n algunos de los problemas m谩s comunes que podr铆as encontrarte:

"Este complemento no puede ser instalado porque no ha sido verificado."

"Este complemento no puede ser instalado porque para estar corrupto."

  • Aseg煤rate que has comprimido los archivos directamente, no la carpeta que contiene los archivos de tu extensi贸n. Tu archivo manifest.json debe estar en la carpeta ra铆z del archivo ZIP.
  • Aseg煤rate que est谩s usando la versi贸n Nightly de Firefox.

No pasa nada

  • Aseg煤rate que tu archivo actualmente termina en .xpi, existen algunos sistemas operativos que le gusta ocultar las extensiones de los archivos.
    • En Windows, comprueba con Vista 鈫 Mostrar / Ocultar: Extensiones de los archivos.
    • En Mac OS X, comprueba con Archivo 鈫 Obtener informaci贸n 鈫 Nombre y Extensi贸n.
  • Es posible que te hayas perdido u ocultado el di谩logo de instalaci贸n. Mira si un icono parecido a una pieza de rompecabezas est谩 al lado del bot贸n Atr谩s en Nightly. Has clic sobre 茅l para trae nuevamente el di谩logo de instalaci贸n.