Kurzreferenz

Semantic Versioning (SemVer) Spickzettel

Kurzreferenz für semantische Versionierung: MAJOR.MINOR.PATCH-Schritte, Pre-Release-Tags, Build-Metadaten und Paketmanager-Bereiche.

· Veröffentlicht

Semantic Versioning (SemVer) definiert eine formale Spezifikation zur Vergabe und Erhöhung von Versionsnummern: MAJOR.MINOR.PATCH.

Die drei Komponenten

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

  1. MAJOR (1.0.0 -> 2.0.0): Inkompatible, brechende API-Änderungen.
  2. MINOR (1.0.0 -> 1.1.0): Abwärtskompatible neue Funktionen.
  3. PATCH (1.0.0 -> 1.0.1): Abwärtskompatible Fehlerbehebungen.

Pre-Release & Build-Metadaten

1.0.0-alpha
1.0.0-alpha.1
1.0.0-beta.2
1.0.0-rc.1
1.0.0+20261108   # Build-Metadaten (+wird bei Versionsrangfolge ignoriert)

Rangfolge: 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.


Paketmanager-Bereichsbezeichner

Bereich Enthaltene Versionen Beschreibung
1.2.3 1.2.3 Exakte Versionsübereinstimmung
>1.2.3 1.2.4, 2.0.0, ... Größer als
>=1.2.0 <1.3.0 1.2.0 up to 1.2.9 Begrenzter Bereich
~1.2.3 >=1.2.3 <1.3.0 Nah genug (erlaubt nur Patch-Releases)
^1.2.3 >=1.2.3 <2.0.0 Kompatibel (erlaubt Minor- und Patch-Releases)
^0.2.3 >=0.2.3 <0.3.0 Bei 0.x.x ist ein Minor-Release bereits brechend
* Any version Uneingeschränkte Wildcard

Referenzen

Verwandte Themen