Szybka pomoc

Ściągawka z wersjonowania semantycznego (SemVer)

Krótki przewodnik po Semantic Versioning: reguły MAJOR.MINOR.PATCH, etykiety wersji wstępnych, metadane kompilacji i zakresy menedżerów pakietów.

· Opublikowano

Wersjonowanie semantyczne (SemVer) definiuje formalną specyfikację przydzielania i zwiększania numerów wersji oprogramowania: MAJOR.MINOR.PATCH.

Trzy Składowe Wersji

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

  1. MAJOR (1.0.0 -> 2.0.0): Niezgodne wstecznie zmiany psujące API.
  2. MINOR (1.0.0 -> 1.1.0): Nowe funkcjonalności zgodne wstecznie.
  3. PATCH (1.0.0 -> 1.0.1): Poprawki błędów zgodne wstecznie.

Wersje Wstępne i Metadane Kompilacji

1.0.0-alpha
1.0.0-alpha.1
1.0.0-beta.2
1.0.0-rc.1
1.0.0+20261108   # Metadane kompilacji (+są ignorowane przy określaniu pierwszeństwa)

Kolejność pierwszeństwa: 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.


Specyfikatory Zakresów w Menedżerach Pakietów

Zakres Uwzględnione Wersje Opis
1.2.3 1.2.3 Dokładne dopasowanie wersji
>1.2.3 1.2.4, 2.0.0, ... Większe niż
>=1.2.0 <1.3.0 1.2.0 up to 1.2.9 Zakres ograniczony
~1.2.3 >=1.2.3 <1.3.0 Wystarczająco bliskie (tylko aktualizacje typu patch)
^1.2.3 >=1.2.3 <2.0.0 Zgodne (pozwala na aktualizacje minor oraz patch)
^0.2.3 >=0.2.3 <0.3.0 W wersjach 0.x.x wydanie minor jest traktowane jako psujące zgodność
* Any version Nieograniczone dopasowanie (wildcard)

Materiały Źródłowe

Powiązane tematy