FAQ de desarrolladores de complementos

Desarrollar un complemento

¿Cómo crear un complemento?

Mozilla ofrece la documentación necesaria para crear un complemento a través del Centro de Desarrolladores de Mozilla. El tutorial Construir una extensión explica cómo configurar el entorno de trabajo para avanzar en la creación de un complemento.

Otros recursos incluyen:

¿Qué herramientas necesito para poder crear un complemento?

Necesitas tener una versión del software de Mozilla para el que estés creando el complemento y elegir un editor de código. Los complementos pueden crearse para prácticamente cualquier software de Mozilla, pero están dirigidos principalmente a:

Los editores de código más populares incluyen:

También puedes descubrir cómo configurar tu entorno de desarrollo en el artículo de MDC Setting up extension development environment

¿Dónde puedo encontrar documentación sobre creación de complementos?

Toda la documentación de Mozilla sobre desarrollo de complementos que incluye tutoriales y API puede encontrarse en el Centro de Desarrolladores de Mozilla.

¿Qué es un archivo ".xpi"?

Las extensiones se empaquetan y distribuyen en archivos ZIP o lotes con la extensión de archivo XPI.

¿Qué es XUL?

XUL (XML User Interface Language, Lenguaje XML para la Interfaz de Usuario) es el lenguaje basado en XML de Mozilla que te permite crear aplicaciones multiplataforma y con una amplia variedad de características. Ofrece widgets para la interfaz de usuario como botones, menús, barras de herramientas, árboles, etc. que pueden usarse para mejorar los complementos porque permiten la modificación de las partes de la IU del navegador.

¿Para qué se usa el archivo "install.rdf"?

Este archivo, llamado un Manifiesto de instalación, lo usan las aplicaciones XUL que habilitan el Administrador de complementos para determinar la información sobre un complemento al ser instalado. Contiene metadatos que identifican el complemento y proporcionan información sobre quién lo creó, dónde se puede encontrar más información al respecto, con qué versiones de qué aplicaciones es compatible, cómo debe actualizarse, etc. El formato del archivo manifest de instalación es RDF/XML.

¿Qué significa "maxVersion"?

Determina la versión máxima de Firefox con la que funcionará esta extensión. ¡Configura este valor para que no sea superior a la versión más reciente disponible!

¿Puede contener mi complemento componentes binarios?

Sí, puedes usar el modelo de objeto de componentes XPCOM de Mozilla para mejorar tus complementos. Los componentes XPCOM pueden usarse e implementarse en JavaScript, Java y Python, además de C++.

¿Puedo usar una biblioteca de JavaScript como jQuery, MooTools o Prototype para crear mi complemento?

Sí, es posible, pero algunas de las funciones que ofrecen esas bibliotecas están disponibles a través de XPCOM, XUL y JS 1.8. Además, los creadores deben tener en cuenta que las bibliotecas pueden modificar los prototipos de objetos primitivos (String.prototype, Date.prototype, etc.) y/o definir funciones globales (por ejemplo, la función $). Es bastante probable que causen conflictos con otros complementos, en especial si se trata de complementos que usan versiones de bibliotecas diferentes. Los desarrolladores deben tener todo esto muy en cuenta al usarlas. Mozilla no ofrece documentación sobre cómo utilizarlas para crear complementos.

¿Cómo pruebo mi complemento?

Los detalles sobre cómo probar tu complemento están en las secciones Probar y Depurar extensiones del tutorial Construir una extensión.

¿Cómo pruebo la compatibilidad con la última versión de software de Mozilla?

Para garantizar la compatibilidad con el último software de Mozilla, es importante que descargues las actualizaciones cuando estén disponibles y compruebes el complemento para asegurarte de que funciona según lo esperado. Lo mejor es seguir los pasos que se describen en el tutorial Construir un complemento para poder probarlo. En la mayoría de los casos, la última versión del software de Mozilla puede ser una beta y, a veces, introduce cambios en la arquitectura que pueden influir en la funcionalidad de un complemento. Por eso es importante que participes de forma activa en el proceso de versiones beta para asegurarte de que los usuarios de tu complemento no se ven afectados de manera negativa al utilizar la versión final del software de Mozilla.

¿Qué son las pruebas de pérdida de memoria?

Las fugas de memoria suelen ser errores en el código fuente utilizado para crear aplicaciones que consumen memoria del sistema sin una correcta liberación una vez que la aplicación haya finalizado. Las pruebas de fugas te permiten identificar qué parte del código está causando la fuga de memoria. La siguiente es una buena guía para encontrar herramientas y estrategias que te ayuden a gestionar las pruebas de fugas. Carsten Book, de Mozilla, también ha escrito un excelente artículo HOW-TO sobre el tema de pruebas de fugas en Firefox.

¿Puede mi complemento ser compatible con otros idiomas?

Sí, puedes encontrar más detalles sobre cómo localizar tu complemento en el tutorial Construir una extensión así como en la página de localización del Centro de Desarrolladores de Mozilla. El proyecto BabelZilla es también un gran recurso para aprender sobre localización y colaborar como voluntario en la traducción de complementos.

Recursos de asistencia

Necesito que me aconsejen sobre cómo crear un complemento. ¿Dónde me pueden ayudar?

Mozilla ofrece la siguientes opciones de ayuda para desarrolladores de complementos:

¿Mozilla ofrece servicios de desarrollo?

No.

¿Es posible contratar a desarrolladores de terceros para crear mi complemento?

Sí, puedes encontrar desarrolladores de terceros a través de la lista de mozilla.jobs, los foros de mozillaZine o el wiki de Mozilla. Por favor, ten en cuenta que Mozilla no ofrece recomendaciones de desarrolladores.

Aportar un complemento

¿Puedo alojar mi propio complemento?

Sí, muchos desarrolladores eligen alojar sus propios complementos. Sin embargo, hacerlo en el sitio de complementos de Mozilla le permite a tu complemento tener una mayor exposición debido al gran volumen de visitas al sitio. mozdev.org ofrece alojamiento gratuito para proyectos de aplicaciones y extensiones de Mozilla y proporciona herramientas para administrar el código fuente, control de versiones, seguimiento de errores y documentación para desarrolladores.

¿Puede Mozilla alojar mi complemento?

Sí, puedes alojar tu complemento en el sitio web de complementos de Mozilla.

¿Qué es AMO?

AMO de Mozilla (https://addons.mozilla.org) es la incubadora que ayuda a desarrolladores a construir, distribuir, y apoyar fantásticos productos de consumo impulsados por Mozilla. Te provee con las herramientas e infraestructura necesarias para gestionar, alojar y exponer tu complemento ante una enorme base de usuarios de Mozilla.

¿Mozilla mantiene la privacidad de la información de mi cuenta?

Sí, nuestra política de privacidad describe cómo administra tu información Mozilla.

¿Qué son las «herramientas para desarrolladores» que se listan en AMO?

El panel de «Herramientas para desarrolladores» es el área donde encontrarás las herramientas para la gestión eficiente de tus complementos. Ofrece las funcionalidades necesarias para enviar tus complementos a AMO, gestionar la información de los complementos y las estadísticas de las valoraciones.

¿Dispone Mozilla de una política en relación a lo que se considera un envío aceptable?

Sí, la política sobre complementos de Mozilla describe qué se considera un envío aceptable, aunque está sujeta a cambios sin previo aviso. Además, el equipo editorial de AMO usa la Guía de revisión para editores que garantiza que tu complemento cumple las directrices específicas de funcionalidad y seguridad.

¿Cómo envío mi complemento a revisión?

El panel de Herramientas para desarrolladores te permite subir y enviar complementos a AMO. Para poder hacerlo, debes ser un usuario de AMO registrado. Asegúrate de leer primero la Guía de revisión para editores antes de enviar tu complemento con el fin de que cumpla con las directrices que los editores aplican en la revisión de complementos.

¿Qué sistema operativo elijo para mi complemento?

Debes elegir el sistema operativo con el que tu complemento funcione correctamente.

¿Qué categoría elijo para mi complemento?

La elección de la categoría depende del tipo de audiencia a la que vaya dirigido y la funcionalidad de tu complemento. Si no estás seguro de a qué categoría pertenece tu complemento, por favor, elige "Otros". El equipo de AMO volverá a aplicarle una categoría diferente a tu complemento si se estima adecuado.

¿Qué significa «nominar» mi complemento?

Los complementos nominados son complementos nuevos que el autor ha nominado para hacerlos públicos a través de las Herramientas para desarrolladores.

¿Puedo especificar un acuerdo de licencia para usar mi complemento?

Sí, puedes especificar un acuerdo de licencia al enviar tu complemento. También puedes agregar o actualizar un acuerdo de licencia después de enviar el complemento usando el panel de Herramientas para desarrolladores.

¿Puedo incluir una política de privacidad para mi complemento?

Sí, puedes especificar una política de privacidad al enviar tu complemento. También puedes agregar o actualizar una política de privacidad después de enviar tu complemento usando el panel de Herramientas para desarrolladores.

Proceso de revisión de complementos

¿Por qué se tiene que revisar mi complemento?

Todos los complementos enviados, tanto si son nuevos como actualizados, son revisados para garantizar que los usuarios de Mozilla tengan una experiencia estable y segura. Todos los envíos de complementos son revisados de acuerdo a las directrices definidas en la Guía de revisión para editores.

¿Quién revisa mi complemento?

Add-ons are reviewed by the AMO Editors, a group of talented developers that volunteer to help the Mozilla project by reviewing add-ons to ensure a stable and safe experience for Mozilla users. When communicating with editors, please be courteous, patient and respectful as they are working hard to ensure that your add-on is set up correctly and follows the guidelines outlined in the Editors Reviewing Guide.

¿Cuáles son las directrices que se aplican para revisar mi complemento?

El equipo editorial de Mozilla sigue la Guía de revisión para editores para comprobar si un complemento se acepta en AMO. Es importante que los desarrolladores de complementos revisen esta guía para asegurarse de que se abordan los aspectos más problemáticos antes de enviar su complemento a revisión. Esto ayudará en gran medida a acelerar el proceso de revisión.

¿Cuánto tiempo llevará revisar mi complemento?

No podemos ofrecer una estimación sobre cuánto tiempo llevará revisar un complemento porque hay una serie de factores que influyen:

  • número de envíos de complementos
  • complejidad del código de un complemento
  • número de aspectos problemáticos descubiertos

Por eso es tan importante que leas la Guía de revisión para editores y te asegures de que tu complemento está configurado según lo establecido. También es una buena idea leer el post Cómo lograr que tu complemento sea revisado con éxito, que ofrece un excelente análisis sobre cómo asegurarte de que tu complemento obtenga una revisión satisfactoria.

Administrar tus complementos

¿Cómo puedo ver cuántas veces se ha descargado mi complemento?

El Panel de estadísticas, localizado en el panel de Herramientas para desarrolladores, contiene información que puede ayudarte a calcular el número de descargas del complemento desde su publicación en AMO.

¿Cómo puedo ver cuántos usuarios activos están usando mi complemento?

El Panel de estadísticas, localizado en el panel de Herramientas para desarrolladores, contiene información que puede ayudarte a determinar cuántos usuarios han estado usando activamente tu complemento desde su publicación en AMO.

¿Cómo puedo enviar una actualización de mi complemento?

Puedes enviar una actualización de tu complemento accediendo al panel de Herramientas para desarrolladores y seleccionando la opción "Subir nueva versión" para subir un nuevo archivo .xpi de tu complemento.

¿Es necesario que los editores revisen mi actualización?

Depende. Si solo estás modificando la descripción del complemento o actualizando una «maxVersion» para asegurar la compatibilidad con una nueva actualización del software de Mozilla, tu complemento no será revisado. Sin embargo, si envías un archivo nuevo y actualizado, la actualización de tu complemento deberá ser revisada por un editor.

¿Qué son las Listas de recomendaciones?

Las listas de Recomendados son importantes para mostrar complementos útiles e importantes a los visitantes de AMO mediante listas breves y especializadas. Las listas nos permiten destacar complementos que han dado buenos resultados creando atractivas y únicas mejoras en el software de Mozilla. Asimismo, nos permite dar a conocer complementos entre los miles alojados en AMO. Las listas se dividen en dos categorías: Recomendados y Recomendados por categoría. La primera se encuentra en la página principal de AMO y, normalmente, se limita a 40 complementos destacados. La segunda la conforman listas de complementos recomendados por categoría. La única diferencia entre ambas listas es que los complementos Recomendados por categoría no aparecen como destacados en la página principal. Aparte de eso, el propósito de ambas listas es reconocer los logros y el trabajo llevado a cabo por los autores de complementos.

¿Qué es un complemento Destacado?

La página principal de AMO, así como la página principal de cada categoría, contienen tres espacios que se utilizan para mostrar una serie de complementos Destacados. Estos complementos son seleccionados de las listas de Recomendados y Recomendados por categoría, respectivamente. Los complementos Destacados se alternan periódicamente, acorde a lo establecido en la página de Preguntas frecuentes sobre complementos Destacados para así aumentar la visibilidad de todos los complementos recomendados. Los complementos Destacados se alternan a menudo para evitar su caducidad.

¿Cuántos complementos pueden incluirse en la lista de Recomendados?

Esta página describe el proceso por el cual se gestionan las listas de complementos recomendados.

¿Puedo pagar para que mi complemento aparezca como Recomendado?

No.

¿Por qué ya no aparece mi complemento como Recomendado?

Esta página describe el proceso por el cual se gestionan las listas de complementos recomendados.

Valoraciones de los usuarios

¿Cómo puedo responder a un usuario que ha publicado una valoración negativa de mi complemento?

Un desarrollador puede contestar a cualquier valoración publicada en su complemento siempre y cuando haya iniciado sesión en AMO. Asimismo, cualquier usuario puede marcar críticas como:

  • Publicidad u otro contenido no relacionado
  • Lenguaje/diálogo inapropiado
  • Informe de problema o petición de asistencia en una ubicación incorrecta
  • Otro (incluye información adicional en una ventana emergente)

Actualmente, AMO no incluye ningún sistema para contactar directamente con el autor de una valoración, pero es una opción que está siendo investigada y considerada para futuras versiones.

¿Puedo solicitar la eliminación de una valoración negativa?

No. No eliminamos valoraciones negativas de los complementos a menos que sean falsas.

¿Puedo solicitar la eliminación de una valoración si es imprecisa?

Si un autor se pone en contacto con nosotros y solicita que una valoración falsa o imprecisa sea eliminada, revisaremos la entrada para considerar su eliminación.

Referencias para licencias de código abierto

¿Necesitas más información sobre las distintas licencias de código abierto? ¿No sabes qué tipo de licencia seleccionar o qué derechos implican cada una de ellas? Aunque lo mejor es la lectura completa de los términos de cada licencia, incluimos a continuación algunas páginas web que contienen información sobre las distintas licencias de código abierto más relevantes para ayudarte a distinguirlas. La inclusión de estas páginas web ha sido realizada solo para tu comodidad y como referencia de uso personal. Estos recursos no deben entenderse ni sustituirse por ningún tipo de asesoramiento legal. Mozilla no garantiza ni se hace responsable del contenido de estas páginas web ni de tu confianza depositada ellas.

http://www.mozilla.org/MPL/

Además del texto completo de Licencia Pública de Mozilla ("MPL"), también se incluye una versión comentada de la MPL y una página de Preguntas de usuario frecuentes para ayudarte si deseas usar o distribuir el código autorizado bajo dicha licencia.

http://techbase.kde.org/Policies/Licensing_Policy

Tabla comparativa que incluye información resumida sobre algunas de las licencias de código abierto más relevantes en materia de distribución, vinculación de software patentado y redistribución de código modificado.

http://www.fsf.org/licensing/licenses/

La Fundación para el Software Libre (Free Software Foundation) proporciona breves resúmenes sobre las licencias de código abierto más relevantes, incluyendo información sobre si cierto tipo de licencia se encuentra clasificada como software libre o copyleft. Asimismo, contiene debates sobre qué constituye licencia de software libre y licencia de copyleft (por ejemplo, una licencia de copyleft es uno de los métodos generales para distribuir un programa o cualquier otro tipo de trabajo gratuitamente. Asimismo, requiere que todas las versiones modificadas o extendidas del programa también lo sean).

http://www.opensource.org/licenses/category

La Open Source Initiative proporciona información sobre los términos de algunas de las licencias de código abierto más relevantes.

http://en.wikipedia.org/wiki/Open_source_license

Listado de Wikipedia de licencias de código libre reconocidas.