Versioni e canali

Pubblicare un pacchetto crea una versione: un’istantanea del suo nome, riepilogo e contenuto in quel momento, con la sua data, le piattaforme su cui funziona e delle note di rilascio facoltative. Una versione pubblicata non cambia mai; modificare il pacchetto prepara la successiva.

Due canali

Canale	Numero	Esempio	Per
Stabile	MAJOR.MINOR.PATCH	1.2.0	Tutte le piattaforme: l’aggiornamento che viene loro proposto.
Sviluppo	MAJOR.MINOR.PATCH-dev.N	1.3.0-dev.2	I test: una versione preliminare della prossima versione stabile.

Le versioni di sviluppo sono sempre contrassegnate a parte: un badge arancione, la propria scheda In sviluppo e il pulsante Scarica la versione di sviluppo nella pagina del pacchetto.

Scegliere il numero

Non digita mai un numero di versione: sceglie un livello, e la finestra mostra il numero risultante (Pubblica la versione 1.1.0.).

Stabile: il livello si applica alla versione stabile più alta.

Livello	Quando	Da 1.2.3
Patch	Correzioni: un refuso in una descrizione, una riga di script corretta	1.2.4
Minore	Aggiunte: nuovi modelli, un nuovo profilo	1.3.0
Maggiore	Modifiche incompatibili: elementi rimossi o riorganizzati	2.0.0

La primissima versione stabile è Maggiore 1.0.0, oppure Sviluppo iniziale 0.1.0 se il pacchetto non è ancora pronto per la produzione.

Sviluppo: il livello indica la versione stabile verso cui si sta lavorando, e il numero è quell’obiettivo seguito da -dev.N, dove N aumenta per quell’obiettivo.

Esempio di sequenza

Azione	Versione
Prima pubblicazione, Stabile, Maggiore	1.0.0
Nuovo modello aggiunto, Sviluppo, Minore	1.1.0-dev.1
Script corretto, Sviluppo, Minore	1.1.0-dev.2
Pronto per tutti, Stabile, Minore	1.1.0
Refuso corretto, Stabile, Patch	1.1.1
Profili riorganizzati, Sviluppo, Maggiore	2.0.0-dev.1

Le versioni sono ordinate come nel Semantic Versioning: una versione di sviluppo precede la versione stabile a cui conduce, 1.0.0 < 1.1.0-dev.1 < 1.1.0-dev.2 < 1.1.0.

Ultima versione e versione di sviluppo

• L’ultima versione di un pacchetto (badge Ultima) è la sua versione stabile più alta.
• La sua versione di sviluppo è la sua versione di sviluppo più alta, quando è superiore all’ultima. Una volta pubblicata la 1.1.0, la 1.1.0-dev.2 non viene più mostrata come versione di sviluppo.

L’intestazione dell’editor le mostra entrambe, e Modifiche non pubblicate quando il contenuto differisce da esse.

Quando si può pubblicare su un canale

• Stabile può essere pubblicato quando il nome, il riepilogo o il contenuto sono cambiati rispetto alla versione stabile più alta (anche se una versione di sviluppo contiene già lo stesso contenuto).
• Sviluppo può essere pubblicato quando qualcosa è cambiato rispetto all’ultima versione di qualsiasi canale.

Un canale senza nulla da pubblicare non può essere scelto (Nulla è cambiato per questo canale dalla sua ultima versione.). Quando nessuno dei due può esserlo, la pagina Versioni indica Nulla è cambiato dall’ultima versione.

Che cosa fanno le piattaforme con le versioni

• Una piattaforma installa un pacchetto e lo mantiene aggiornato con le sue versioni stabili.
• Le versioni di sviluppo sono destinate alle piattaforme di test: si installano intenzionalmente, scaricando il file di sviluppo o scegliendolo su una piattaforma connessa. Vedere Versioni e canale dev nella guida della piattaforma.
• Ogni elemento del contenuto conserva la propria identità da una versione all’altra, quindi un aggiornamento modifica gli elementi che la piattaforma ha già invece di duplicarli, e rimuove gli elementi che Lei ha rimosso.
• Installare una versione inferiore a quella installata è un ritorno a una versione precedente: la piattaforma chiede conferma prima di tornare indietro.