Semantic Versioning (SemVer) définit une spécification formelle pour l'attribution des numéros de version de logiciels : MAJOR.MINOR.PATCH.
Les Trois Composants
$$\text{Version} = \text{MAJOR}.\text{MINOR}.\text{PATCH}$$
- MAJOR (
1.0.0->2.0.0) : Changements incompatibles cassant l'API. - MINOR (
1.0.0->1.1.0) : Nouvelles fonctionnalités rétrocompatibles. - PATCH (
1.0.0->1.0.1) : Corrections de bugs rétrocompatibles.
Pré-versions et Métadonnées de Build
1.0.0-alpha
1.0.0-alpha.1
1.0.0-beta.2
1.0.0-rc.1
1.0.0+20261108 # Métadonnées de build (+ignorées dans la priorité de version)
Ordre de préséance : 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.
Spécificateurs de Plages des Gestionnaires de Paquets
| Plage | Versions Incluses | Description |
|---|---|---|
1.2.3 |
1.2.3 |
Correspondance exacte de version |
>1.2.3 |
1.2.4, 2.0.0, ... |
Supérieur à |
>=1.2.0 <1.3.0 |
1.2.0 up to 1.2.9 |
Plage délimitée |
~1.2.3 |
>=1.2.3 <1.3.0 |
Raisonnablement proche (correctifs uniquement) |
^1.2.3 |
>=1.2.3 <2.0.0 |
Compatible (mineures et correctifs autorisés) |
^0.2.3 |
>=0.2.3 <0.3.0 |
En 0.x.x, une version mineure casse la compatibilité |
* |
Any version | Joker universel sans restriction |