Despre versionarea semantică
On decembrie 9, 2021 by adminPentru a menține ecosistemul JavaScript sănătos, fiabil și sigur, de fiecare dată când faceți actualizări semnificative la un pachet npm pe care îl dețineți, vă recomandăm să publicați o nouă versiune a pachetului cu un număr de versiune actualizat în fișierul package.json
care urmează specificația de versionare semantică. Respectarea specificației de versionare semantică îi ajută pe ceilalți dezvoltatori care depind de codul dvs. să înțeleagă amploarea modificărilor într-o anumită versiune și să își ajusteze propriul cod, dacă este necesar.
Incrementul versiunilor semantice în pachetele publicate
Pentru a ajuta dezvoltatorii care se bazează pe codul dumneavoastră, vă recomandăm să începeți versiunea pachetului dumneavoastră la 1.0.0
și să o incrementați după cum urmează:
Starea codului | Etapa | Regula | Versiunea de exemplu |
---|---|---|---|
Prima versiune | Produs nou | Începeți cu 1.0.0 | 1.0.0 |
Rezolvări de erori compatibile cu versiunile anterioare | Lansare patch | Creșterea celei de-a treia cifre | 1.0.1 |
Noi caracteristici compatibile cu versiunile anterioare | Lansare minoră | Creșterea cifrei din mijloc și resetarea ultimei cifre la zero | 1.1.0 |
Modificări care întrerup compatibilitatea retroactivă | Lansare majoră | Creșterea primei cifre și resetarea cifrei din mijloc și a ultimei cifre la zero | 2.0.0 |
Utilizarea versiunii semantice pentru a specifica tipurile de actualizare pe care le poate accepta pachetul dumneavoastră
Puteți specifica tipurile de actualizare pe care le poate accepta pachetul dumneavoastră de la dependențele din fișierul package.json
al pachetului dumneavoastră.
De exemplu, pentru a specifica intervalele de versiuni acceptabile până la 1.0.4, utilizați următoarea sintaxă:
- Lansări de versiuni:
1.0
sau1.0.x
sau~1.0.4
- Lansări minore:
1
sau1.x
sau^1.0.4
- Lansări majore:
*
saux
Pentru mai multe informații despre sintaxa versiunii semantice, consultați npm semver calculator.
Exemplu
"dependencies": {"my_dep": "^1.0.0.0","another_dep": "~2.2.0"},
Lasă un răspuns