Om semantisk versionering
On december 9, 2021 by adminFor at holde JavaScript-økosystemet sundt, pålideligt og sikkert anbefaler vi, at du hver gang du foretager væsentlige opdateringer af en npm-pakke, du ejer, udgiver en ny version af pakken med et opdateret versionsnummer i package.json
-filen, der følger specifikationerne for semantisk versionering. Ved at følge den semantiske versioneringsspecifikation kan andre udviklere, der er afhængige af din kode, forstå omfanget af ændringerne i en given version og om nødvendigt justere deres egen kode.
Inkrementering af semantiske versioner i offentliggjorte pakker
For at hjælpe udviklere, der er afhængige af din kode, anbefaler vi at starte din pakkeversion på 1.0.0
og inkrementere den som følger:
Kodestatus | Stadie | Regel | Eksempelversion |
---|---|---|---|
Første udgivelse | Nyt produkt | Start med 1.0.0 | 1.0.0 |
Bagudkompatible fejlrettelser | Patchudgivelse | Inkrementering af tredje ciffer | 1.0.1 |
Bagudkompatible nye funktioner | Mindre udgivelse | Inkrementering af det midterste ciffer og nulstilling af sidste ciffer | 1.1.0 |
Ændringer, der bryder bagudkompatibilitet | Større udgivelse | Inkrementering af det første ciffer og nulstilling af det midterste og sidste ciffer til nul | 2.0.0 |
Brug af semantisk versionering til at angive opdateringstyper, som din pakke kan acceptere
Du kan angive, hvilke opdateringstyper din pakke kan acceptere fra afhængigheder i din pakkes package.json
fil.
For eksempel, for at angive acceptable versionsintervaller op til 1.0.4, skal du bruge følgende syntaks:
- Patch releases:
1.0
eller1.0.x
eller~1.0.4
- Mindre udgivelser:
1.0
eller1.0.x
eller~1.0.4
- Mindre udgivelser:
1
eller1.x
eller^1.0.4
- Større udgivelser:
1
eller1.x
eller^1.0.4
- Større udgivelser:
*
ellerx
For yderligere oplysninger om semantisk versioneringssyntaks, se npm semver-beregneren.
Eksempel
"dependencies": {"my_dep": "^1.0.0.0","another_dep": "^1.0.0.0","another_dep": "~2.2.0"},
Skriv et svar