FAQ de desarrolladores de complementos

Desarrollar un complemento

How do I build an Add-on?

Mozilla provides documentation on how to build an add-on via the Mozilla Developer Network.

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:

You can also learn more about setting up your development environment via the MDN article Setting up extension development environment

¿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?

Yes. It's possible, but some of the functionality provided by these libraries are available through XPCOM, XUL, and JavaScript. In addition, authors should take care if libraries modify primitive object prototypes (String.prototype, Date.prototype, etc.) and/or define global functions (eg. the $ function). These are prone to cause conflict with other add-ons, in particular if different add-ons use different versions of libraries and so on. Developers need to be very, very careful with using them. Mozilla does not offer documentation on using them to build add-ons.

How do I debug my add-on?

You can use the Add-on Debugger.

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

To ensure compatibility with the latest Mozilla software, it's important to download updates as they become available and test your add-on to ensure that it is still functioning as expected. In many cases, the latest version of Mozilla software may be a beta release. Since these releases at times introduce architectural changes that may impact the functionality of your add-on, it's important to be actively involved in the beta process to ensure that your add-on users are not negatively impacted upon final release of Mozilla software.

How to improve the performance of my add-on?

Poorly written extensions can have a severe impact on the browsing experience, including on the overall performance of Firefox itself. The following page contains many good guides that help you improve performance, whether you're developing core Mozilla code or an add-on.

¿Puede mi complemento ser compatible con otros idiomas?

Yes. Details on localizing your add-on can be found in the the Mozilla Developer Network Localization page. The BabelZilla project is also a great resource for learning about localization and volunteering to help translate add-ons.

Recursos de asistencia

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

¿Mozilla ofrece servicios de desarrollo?

No.

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

Yes. You may find 3rd party developers via the Add-ons forum, mozilla.jobs list, mozillaZine forums or the Mozilla Wiki. Please note that Mozilla does not offer developer recommendations.

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?

Los complementos los revisan los editores AMO, un grupo de desarrolladores con talento que voluntariamente ayudan al proyecto Mozilla revisando complementos y garantizando que los usuarios de Mozilla disfruten de una experiencia estable y segura. Al comunicarte con los editores, intenta ser educado, paciente y respetuoso mientras dedican sus esfuerzos a revisar que tu complemento está configurado correctamente y cumple las directrices detalladas en la Guía de revisión para editores.

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

The Mozilla editorial team follows the Editors Reviewing Guide when testing an add-on for acceptance onto AMO. It is important that add-on developers review this guide to ensure that common problem areas are addressed prior to submitting their add-on for review. This will greatly assist in expediting the review process.

¿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.

https://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.

https://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.gnu.org/licenses/license-list.html

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

http://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.

https://en.wikipedia.org/wiki/Comparison_of_free_and_open-source_software_licenses

A comparison of known open source licenses on Wikipedia.

http://choosealicense.com/

A site to provide non-judgmental guidance on choosing a license for your open source project.