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}$$
- MAJOR (
1.0.0->2.0.0): Modifiche all'API incompatibili e che rompono la retrocompatibilità. - MINOR (
1.0.0->1.1.0): Nuove funzionalità retrocompatibili. - 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 |