Riferimento rapido

Cheat Sheet Semantic Versioning (SemVer)

Guida rapida per Semantic Versioning: incrementi MAJOR.MINOR.PATCH, tag di pre-release, metadati di build e intervalli dei gestori di pacchetti.

· Pubblicato

Semantic Versioning (SemVer) definisce una specifica formale per assegnare e incrementare i numeri di versione del software: MAJOR.MINOR.PATCH.

I Tre Componenti

$$\text{Version} = \text{MAJOR}.\text{MINOR}.\text{PATCH}$$

  1. MAJOR (1.0.0 -> 2.0.0): Modifiche all'API incompatibili e che rompono la retrocompatibilità.
  2. MINOR (1.0.0 -> 1.1.0): Nuove funzionalità retrocompatibili.
  3. PATCH (1.0.0 -> 1.0.1): Correzioni di bug retrocompatibili.

Pre-release e Metadati di Build

1.0.0-alpha
1.0.0-alpha.1
1.0.0-beta.2
1.0.0-rc.1
1.0.0+20261108   # Metadati di build (+ignorati nella precedenza delle versioni)

Ordine di precedenza: 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.


Specificatori di Intervallo dei Package Manager

Intervallo Versioni Incluse Descrizione
1.2.3 1.2.3 Corrispondenza esatta di versione
>1.2.3 1.2.4, 2.0.0, ... Maggiore di
>=1.2.0 <1.3.0 1.2.0 up to 1.2.9 Intervallo delimitato
~1.2.3 >=1.2.3 <1.3.0 Ragionevolmente vicino (consente solo release patch)
^1.2.3 >=1.2.3 <2.0.0 Compatibile (consente release minor e patch)
^0.2.3 >=0.2.3 <0.3.0 In 0.x.x, una release minor è considerata breaking
* Any version Carattere jolly illimitato

Riferimenti

Argomenti correlati