Referință rapidă

Cheat Sheet Versionare Semantică (SemVer)

Ghid de referință rapidă pentru Semantic Versioning: incrementări MAJOR.MINOR.PATCH, etichete pre-release și intervale pentru manageri de pachete.

· Publicat

Versionarea Semantică (SemVer) definește o specificație formală pentru atribuirea și incrementarea numerelor de versiune: MAJOR.MINOR.PATCH.

Cele Trei Componente

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

  1. MAJOR (1.0.0 -> 2.0.0): Modificări incompatibile care rup API-ul.
  2. MINOR (1.0.0 -> 1.1.0): Funcționalități noi compatibile cu versiunile anterioare.
  3. PATCH (1.0.0 -> 1.0.1): Remedieri de erori compatibile cu versiunile anterioare.

Pre-Release și Metadate de Compilare

1.0.0-alpha
1.0.0-alpha.1
1.0.0-beta.2
1.0.0-rc.1
1.0.0+20261108   # Metadate de compilare (+ignorate la calculul priorității versiunii)

Ordinea de precedență: 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.


Specificatori de Intervale pentru Manageri de Pachete

Interval Versiuni Incluse Descriere
1.2.3 1.2.3 Potrivire exactă a versiunii
>1.2.3 1.2.4, 2.0.0, ... Mai mare decât
>=1.2.0 <1.3.0 1.2.0 up to 1.2.9 Interval delimitat
~1.2.3 >=1.2.3 <1.3.0 Rezonabil de apropiat (permite doar remedieri patch)
^1.2.3 >=1.2.3 <2.0.0 Compatibil (permite versiuni minor și patch)
^0.2.3 >=0.2.3 <0.3.0 În 0.x.x, o versiune minor rupe compatibilitatea
* Any version Caracter joker nerestricționat

Referințe

Subiecte conexe