Om semantisk versionshantering
On december 9, 2021 by adminFör att hålla JavaScript-ekosystemet friskt, pålitligt och säkert rekommenderar vi att du varje gång du gör viktiga uppdateringar av ett npm-paket som du äger publicerar en ny version av paketet med ett uppdaterat versionsnummer i package.json-filen som följer den semantiska specifikationen för versionshantering. Att följa den semantiska versionsspecifikationen hjälper andra utvecklare som är beroende av din kod att förstå omfattningen av ändringarna i en viss version och att justera sin egen kod vid behov.
Inkrementering av semantiska versioner i publicerade paket
För att hjälpa utvecklare som är beroende av din kod rekommenderar vi att du startar din paketversion vid 1.0.0 och ökar den enligt följande:
| Kodstatus | Steg | Regel | Exempelversion |
|---|---|---|---|
| Första utgåvan | Ny produkt | Start med 1.0.0 | 1.0.0 |
| Bakåtkompatibla felrättningar | Patchutgåva | Inkrementera den tredje siffran | 1.0.1 |
| Nya funktioner som är bakåtkompatibla | Mindre utgåva | Inkrementera den mellersta siffran och nollställa den sista siffran | 1.1.0 |
| Förändringar som bryter mot bakåtkompatibilitet | Major release | Inkrementera den första siffran och återställ den mellersta och sista siffran till noll | 2.0.0 |
Användning av semantisk versionering för att specificera uppdateringstyper som ditt paket kan acceptera
Du kan specificera vilka uppdateringstyper som ditt paket kan acceptera från beroenden i paketets package.json-fil.
För att specificera acceptabla versionsintervall upp till 1.0.4 använder du till exempel följande syntax:
- Patch releases:
1.0eller1.0.xeller~1.0.4 - Mindre versioner:
1eller1.xeller^1.0.4 - Större utgåvor:
*ellerx
För mer information om syntaxen för semantisk versionering, se npm semver calculator.
Exempel
"dependencies": {"my_dep": {"beroende": {"my_dep": "^1.0.0.0","another_dep": "^1.0.0.0","another_dep": "^1.0.0.0": "~2.2.0"},
Lämna ett svar