Atlassian Marketplace: Algunos consejos al hacer tu add-on

Atlassian Marketplace: Algunos consejos al hacer tu add-on

Atlassian connect add-ons

El desarrollo de add-ons o plugins para plataformas que tengan un Marketplace se ha popularizado con el paso del tiempo. Al desarrollar Votes y Recognitions for Confluence, hemos notado que las ventajas que ofrece este tipo de mercado son bastantes, entre ellas podemos encontrar:

  • No tienes que preocuparte “demasiado” por conseguir audiencia, puesto que la plataforma por si misma provee un mercado potencial.
  • Plataformas grandes, como Atlassian, proveen buenas herramientas para facilitar el desarrollo de tu complemento.
  • Hay toda una comunidad que te apoyara con las dudas que tengas durante el desarrollo. Ademas que de la plataforma por si misma te brindara su ayuda.

Adicionalmente, Atlassian provee un framework basado en Node.js, el cual acelera mucho el inicio del proceso de desarrollo de tu add-on.

A pesar de estas ventajas, es normal que en un inicio tengas muchas dudas sobre que te espera al hacer tu add-on. Para ello, te recomiendo leer los siguientes puntos.

Documentacion

La documentacion ha sido siempre ha sido un tabu en el desarrollo de software, y el desarrollo de complementos no es la excepcion. Si bien es cierto que mantener la documentacion al dia tras cada cambios es una tarea sumamente complicada, tambien lo es el hecho de que Atlassian provee buenas fuentes de documentacion cuando se trata de desarrollar complementos.

Probablemente el primer link que deberias visitar es este: https://developer.atlassian.com/cloud/jira/platform/integrating-with-jira-cloud/ puesto que Jira es el producto estrella de la empresa y cuenta con una buena cantidad de documentacion.

Hay ocasiones en que la documentacion estatica es insuficiente, por lo que los foros son una recurso vital. Atlassian tambien cuenta con un par de foros que te ayudaran enormemente en la tarea; uno para preguntas generales sobre la plataforma y otro especial para desarrolladores.

Framework de desarrollo

Como ya se menciono anteriormente, Atlassian tambien provee un framework escrito en Node.js que te permitira iniciar rapidamente con el desarrollo.

Ademas de poderlo incluir mediante la herramienta mencionada en los tutoriales, el codigo fuente lo podras encontrar en este repo de bitbucket. Personalmente recomiendo utilizar la version 2.x.

Un punto importante es no olvidarte de actualizar este framework! A fin de cuentas es un modulo de npm que se actualiza activamente para librar problemas de seguridad y performance.

De igual forma, es importante que mas alla de simplemente utilizarlo, dediques un poco de tiempo a entenderlo, pues mientra mas comprenda como funciona este framework, mas podras hacer con el.

Lee documentacion para Server y para Cloud

Como ya sabras, Atlassian ofrece Jira y Confluence en sus versiones Cloud y Self-hosted (tambien conocido como Server). A manera de anecdota personal, puedo decir que muchas veces he encontrado cosas interesantes que se pueden hacer en la version Self-hosted y que no vienen documentadas para Cloud; pero que si se pueden hacer!

Por lo tanto, cuando busque como hacer algo, vale la pena echar un vistazo a la version self-hosted para ver si de verdad es posible hacerlo.

Elige sabiamente las tecnologias a utilizar

Si hablamos de elegir tu tech stack, posiblemente iras por node en el back-end, y esto es algo muy obvio puesto que el framework de Atlassian esta escrito en este lenguaje. Sin embargo, en el lado del front-end, tienes un mundo de posibilidades, las cuales van desde JS simple y JQuery, pasando por cosas mas exoticas como Vue.js, hasta llegar a React y Angular.

La realidad es que puedes utilizar lo que quieras, pero debes saber que si eliges React, es muy probable que tengas una ligera (o no tan ligera) ventaja, pues Atlassian ha desarrollado una libreria con sus componentes totalmente en React.

Revisa los guidelines!

A diferencia de desarrollar una aplicacion de forma independiente, Atlassian es mas estricto con respecto a como luce tu add-on. Para ello, se han tomado el tiempo de proveer buenos recursos que te ayudaran a refinar el look and feel de tu app, de tal manera que parezca parte de la UI nativa de sus productos.

En especifico, te recomiendo buscar en el siguiente link https://atlassian.design/

En general, la plataforma brinda mucha ayuda a los desarrolladores y todo es cuestion de dedicar tiempo a entenderla y hacer un mapa en nuestra mente de donde esta cada uno de los recursos. Veras que con un poco de practica hacer add-ons se volvera cosa de nada!

Espero que este artículo te sea de gran ayuda. Si tienes algún otro consejo que quieras compartir, no olvides dejarlo en la caja de comentarios.

También recuerda darte una vuelta por nuestro sitio web http://regosdevstudio.com/ y echarle un ojo a los productos y servicios que ofrecemos.

No olvides seguirnos en nuestro Twitter https://twitter.com/regosdevstudio y ser feliz.

Que tengas un excelente día y nos vemos en la próxima.

Leave a Reply

Your email address will not be published. Required fields are marked *