Saltar al contenido principal

Versionado

Extensiones permite llevar un versionado de cada Extensión de manera que el desarrollador pueda probar la Extensión en Auravant durante el proceso de desarrollo y publicar actualizaciones disponibles para todos los usuarios. Para esto, sólo es necesario comprender los siguientes conceptos:

  • Cada Extensión tiene una sucesión de Versiones
    • La Versión tiene un Estado asociado
  • Cada Versión tiene una sucesión de Commits

La Versión es una instancia de la Extensión cuyo Estado puede ser:

  • Development: la Versión está en el proceso de desarrollo, visible y accesible sólo por el desarrollador desde el marketplace.
  • Revision: La Versión fue enviada a revisión para que el equipo de Auravant la revise y publique, solicite correcciones, o rechace.
  • Production: La Versión aprobó la revisión fue publicada. Se encuentra accesible por cualquier usuario desde el Marketplace de Auravant.
  • Denied: La Versión fue rechazada por la revisión.
  • Down: La Versión fue dada de baja.

Los Commits son, al igual que en Git, avances en el código de la Extensión. Cuando se realizan cambios en el código y se desean probar en Auravant, se crea un nuevo Commit con esos cambios.

Ciclo de vida de una Extensión

Cuando se declara una Extensión, instantáneamente se crea la Versión 1.0 en estado Development. El “1” corresponde al número de Versión y el “0” al número de Commit. El primer Commit contiene el boilerplate, es decir, el código mínimo que la Extensión necesita para inicializarse. A partir de allí, el desarrollador podrá subir nuevo código, creando un nuevo Commit cada vez, obteniendo las Versiones 1.1, 1.2, etc.

Además el desarrollador podrá seleccionar y cambiar, de todos los Commits realizados, cuál desea que esté asignado a la Versión en estado Development y acceder a él desde el Marketplace. Es decir que el código que se ejecutará al abrir una Extensión del Marketplace será el del Commit seleccionado.

Sólo puede haber una Versión en estado Development.

Cuando el desarrollador haya probado lo suficiente la Versión y esté lista para ser publicada, debe seleccionar "publicar" en las opciones de la misma. Ahí cambiará el estado a Revision y no podrá realizar ningún cambio sobre la Versión o sus Commits. A su vez, se generará una nueva Versión Development cuyo primer commit será el seleccionado en la Versión anterior.

  • Si la Versión en estado Revision no es aceptada, será puesta en estado Denied y el desarrollador no podrá hacer cambios sobre ella. Se deberán realizar las correcciones correspondientes sobre la Versión en estado Development y enviarla a revisión nuevamente.
  • Si la Versión es aprobada, le será asignado el estado Production y será accesible por todos los usuarios de Auravant desde el Marketplace. En caso de ya existir una Versión Production, cuando sea aprobada la nueva la Versión actual será dada de baja y la nueva Versión pasará a estado Production.

Sólo puede haber una Versión en estado Production.

De esta manera, puede coexistir una Versión Development y una Versión Production de la misma Extensión. Todos los usuarios verán la Versión Production y el desarrollador verá tanto Production como Development listadas como dos Extensiones distintas.