Sul versioning semantico
Il Dicembre 9, 2021 da adminPer mantenere l’ecosistema JavaScript sano, affidabile e sicuro, ogni volta che fai aggiornamenti significativi a un pacchetto npm di tua proprietà, ti consigliamo di pubblicare una nuova versione del pacchetto con un numero di versione aggiornato nel file package.json
che segue le specifiche del versioning semantico. Seguire le specifiche semantiche di versioning aiuta gli altri sviluppatori che dipendono dal tuo codice a capire la portata dei cambiamenti in una data versione, e ad aggiustare il proprio codice se necessario.
Incrementare le versioni semantiche nei pacchetti pubblicati
Per aiutare gli sviluppatori che si affidano al tuo codice, raccomandiamo di iniziare la versione del tuo pacchetto da 1.0.0
e di incrementarla come segue:
Stato del codice | Fase | Ruolo | Versione d’esempio |
---|---|---|---|
Prima versione | Nuovo prodotto | Inizia con 1.0.0 | 1.0.0 |
Correzione di bug compatibili con le versioni precedenti | Patch release | Incremento della terza cifra | 1.0.1 |
Nuove caratteristiche compatibili con le versioni precedenti | Minor release | Incremento della cifra centrale e ripristino dell’ultima cifra a zero | 1.1.0 |
Cambiamenti che rompono la compatibilità all’indietro | Major release | Incremento della prima cifra e azzeramento delle cifre centrale e finale | 2.0.0 |
Usare il versioning semantico per specificare i tipi di aggiornamento che il tuo pacchetto può accettare
Puoi specificare quali tipi di aggiornamento il tuo pacchetto può accettare dalle dipendenze nel file package.json
del tuo pacchetto.
Ad esempio, per specificare intervalli di versioni accettabili fino alla 1.0.4, usa la seguente sintassi:
- Patch release:
1.0
o1.0.x
o~1.0.4
- Minor releases:
1
o1.x
o^1.0.4
- Major releases:
*
ox
Per maggiori informazioni sulla sintassi del versioning semantico, vedere il calcolatore semver di npm.
Esempio
"dependencies": {"my_dep": "^1.0.0","another_dep": "~2.2.0"},
Lascia un commento