Over semantisch versiebeheer
On december 9, 2021 by adminOm het JavaScript-ecosysteem gezond, betrouwbaar en veilig te houden, raden we aan om elke keer dat u belangrijke updates aanbrengt in een npm-pakket waarvan u de eigenaar bent, een nieuwe versie van het pakket te publiceren met een bijgewerkt versienummer in het package.json
-bestand dat de semantische versiebeheerspec volgt. Het volgen van de semantische versiebeheerspec helpt andere ontwikkelaars die afhankelijk zijn van uw code de omvang van de wijzigingen in een bepaalde versie te begrijpen, en hun eigen code indien nodig aan te passen.
Verhogen van semantische versies in gepubliceerde pakketten
Om ontwikkelaars te helpen die op uw code vertrouwen, raden we u aan uw pakketversie te beginnen bij 1.0.0
en als volgt op te hogen:
Code status | Stage | Regel | Exemplaarversie |
---|---|---|---|
Eerste release | Nieuw product | Start met 1.0.0 | 1.0.0 |
Backward compatible bug fixes | Patch release | Het derde cijfer verhogen | 1.0.1 |
Backward compatible nieuwe features | Minor release | Het middelste cijfer verhogen en het laatste cijfer op nul zetten | 1.1.0 |
Veranderingen die achterwaartse compatibiliteit verbreken | Major release | Het eerste cijfer wordt verhoogd en het middelste en laatste cijfer worden op nul gezet | 2.0.0 |
Semantische versiebeheer gebruiken om updatetypen op te geven die uw pakket kan accepteren
U kunt opgeven welke updatetypen uw pakket kan accepteren van afhankelijkheden in het package.json
-bestand van uw pakket.
Om bijvoorbeeld acceptabele versiebereiken op te geven tot 1.0.4, gebruikt u de volgende syntaxis:
- Patchreleases:
1.0
of1.0.x
of~1.0.4
- Minor-releases:
1
of1.x
of^1.0.4
- Major releases:
*
ofx
Voor meer informatie over de syntaxis van semantische versiebeheer, zie de npm semver calculator.
Voorbeeld
"dependencies": {\a6}"my_dep": "^1.0.0","another_dep": "~2.2.0"},
Geef een antwoord