Γρήγορη αναφορά

Semantic Versioning (SemVer) Cheatsheet

Γρήγορος οδηγός αναφοράς για το Semantic Versioning: αυξήσεις MAJOR.MINOR.PATCH, προ-εκδόσεις, μεταδεδομένα δόμησης και εύρη διαχειριστών πακέτων.

· Δημοσιεύτηκε

Το Semantic Versioning (SemVer) ορίζει μια επίσημη προδιαγραφή για την ανάθεση και αύξηση αριθμών έκδοσης: MAJOR.MINOR.PATCH.

Τα Τρία Συστατικά

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

  1. MAJOR (1.0.0 -> 2.0.0): Μη συμβατές αλλαγές που σπάνε το API.
  2. MINOR (1.0.0 -> 1.1.0): Νέες δυνατότητες συμβατές προς τα πίσω.
  3. PATCH (1.0.0 -> 1.0.1): Διορθώσεις σφαλμάτων συμβατές προς τα πίσω.

Προ-εκδόσεις & Μεταδεδομένα Δόμησης

1.0.0-alpha
1.0.0-alpha.1
1.0.0-beta.2
1.0.0-rc.1
1.0.0+20261108   # Μεταδεδομένα δόμησης (+αγνοούνται στην προτεραιότητα έκδοσης)

Σειρά προτεραιότητας: 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.


Προσδιοριστές Εύρους Διαχειριστών Πακέτων

Εύρος Περιλαμβανόμενες Εκδόσεις Περιγραφή
1.2.3 1.2.3 Ακριβής αντιστοίχιση έκδοσης
>1.2.3 1.2.4, 2.0.0, ... Μεγαλύτερο από
>=1.2.0 <1.3.0 1.2.0 up to 1.2.9 Περιορισμένο εύρος
~1.2.3 >=1.2.3 <1.3.0 Εύλογα κοντά (επιτρέπει μόνο εκδόσεις patch)
^1.2.3 >=1.2.3 <2.0.0 Συμβατό (επιτρέπει εκδόσεις minor και patch)
^0.2.3 >=0.2.3 <0.3.0 Στο 0.x.x, η έκδοση minor είναι breaking
* Any version Απεριόριστο μπαλαντέρ

Αναφορές

Σχετικά θέματα