Versiones y canales
Publicar un paquete crea una versión: una instantánea de su nombre, su resumen y su contenido en ese momento, con su fecha, las plataformas en las que funciona y unas notas de la versión opcionales. Una versión publicada nunca cambia; editar el paquete prepara la siguiente.
Dos canales
Sección titulada «Dos canales»| Canal | Número | Ejemplo | Para |
|---|---|---|---|
| Estable | MAJOR.MINOR.PATCH |
1.2.0 |
Todas las plataformas: la actualización que se les ofrece. |
| Desarrollo | MAJOR.MINOR.PATCH-dev.N |
1.3.0-dev.2 |
Pruebas: una versión preliminar de la próxima versión estable. |
Las versiones de desarrollo siempre se muestran aparte: una insignia naranja, su propia tarjeta En desarrollo y su botón Descargar la versión de desarrollo en la página del paquete.
Elegir el número
Sección titulada «Elegir el número»Nunca escribe un número de versión: elige un incremento, y la ventana muestra el número resultante (Publica la versión 1.1.0.).
Estable: el incremento se aplica a la versión estable más alta.
| Incremento | Cuándo | Desde 1.2.3 |
|---|---|---|
| Parche | Correcciones: una errata en una descripción, una línea de script corregida | 1.2.4 |
| Menor | Adiciones: nuevos modelos, un nuevo perfil | 1.3.0 |
| Mayor | Cambios incompatibles: elementos eliminados o reorganizados | 2.0.0 |
La primera versión estable es Mayor 1.0.0, o Desarrollo inicial 0.1.0 si el paquete todavía
no está listo para producción.
Desarrollo: el incremento indica la versión estable hacia la que trabaja, y el número es ese objetivo
seguido de -dev.N, donde N aumenta para ese objetivo.
Secuencia de ejemplo
Sección titulada «Secuencia de ejemplo»| Acción | Versión |
|---|---|
| Primera publicación, Estable, Mayor | 1.0.0 |
| Nuevo modelo añadido, Desarrollo, Menor | 1.1.0-dev.1 |
| Script corregido, Desarrollo, Menor | 1.1.0-dev.2 |
| Listo para todos, Estable, Menor | 1.1.0 |
| Errata corregida, Estable, Parche | 1.1.1 |
| Perfiles reorganizados, Desarrollo, Mayor | 2.0.0-dev.1 |
Las versiones se ordenan como en Semantic Versioning: una versión de desarrollo es anterior a la versión
estable a la que conduce, 1.0.0 < 1.1.0-dev.1 < 1.1.0-dev.2 < 1.1.0.
Última versión y versión de desarrollo
Sección titulada «Última versión y versión de desarrollo»- La última versión de un paquete (insignia Última) es su versión estable más alta.
- Su versión de desarrollo es su versión de desarrollo más alta, cuando es superior a la última.
Una vez publicada la
1.1.0, la1.1.0-dev.2ya no se muestra como versión de desarrollo.
El encabezado del editor muestra ambas, y Cambios sin publicar cuando el contenido difiere de ellas.
Cuándo se puede publicar un canal
Sección titulada «Cuándo se puede publicar un canal»- Estable se puede publicar cuando el nombre, el resumen o el contenido han cambiado desde la versión estable más alta (aunque una versión de desarrollo ya tenga el mismo contenido).
- Desarrollo se puede publicar cuando algo ha cambiado desde la última versión de cualquier canal.
Un canal sin nada que publicar no se puede elegir (Nada ha cambiado para este canal desde su última versión.). Cuando no se puede ninguno, la página Versiones indica Nada ha cambiado desde la última versión.
Qué hacen las plataformas con las versiones
Sección titulada «Qué hacen las plataformas con las versiones»- Una plataforma instala un paquete y lo mantiene actualizado con sus versiones estables.
- Las versiones de desarrollo son para plataformas de prueba: instálelas deliberadamente, descargando el archivo de desarrollo o eligiéndolo en una plataforma conectada. Consulte Versiones y canal de desarrollo en la guía de la plataforma.
- Cada elemento del contenido conserva su identidad de una versión a otra, de modo que una actualización modifica los elementos que la plataforma ya tiene en lugar de duplicarlos, y elimina los elementos que usted ha quitado.
- Instalar una versión inferior a la instalada es una vuelta a una versión anterior: la plataforma pide confirmación antes de retroceder.