Semanttisesta versioinnista
On 9 joulukuun, 2021 by adminPitäksemme JavaScript-ekosysteemin terveenä, luotettavana ja turvallisena suosittelemme, että aina kun teet merkittäviä päivityksiä omistamaasi npm-pakettiin, julkaiset uuden version paketista päivitetyllä versionumerolla package.json
-tiedostossa, joka noudattaa semanttisen versioinnin spesifikaatiota. Semanttisen versioinnin speksin noudattaminen auttaa muita kehittäjiä, jotka ovat riippuvaisia koodistasi, ymmärtämään tietyn version muutosten laajuuden ja tarvittaessa mukauttamaan omaa koodiaan.
Semanttisten versioiden kasvattaminen julkaistuissa paketeissa
Autaaksesi kehittäjiä, jotka luottavat koodiisi, suosittelemme, että aloitat pakettisi versionumerosta 1.0.0
ja kasvatat sitä seuraavasti:
Koodin tila | Vaihe | Sääntö | Esimerkkiversio |
---|---|---|---|
Ensimmäinen julkaisu | Uusi tuote | Aloita arvolla 1.0.0 | 1.0.0 |
Takaisin yhteensopivat virheenkorjaukset | Patch-julkaisu | Kolmannen numeron korottaminen | 1.0.1 |
Takaisin yhteensopivia uusia ominaisuuksia | Minor-julkaisu | Keskimmäisen numeron korottaminen ja viimeisen numeron palauttaminen nollaan | 1.1.0 |
Muutokset, jotka rikkovat taaksepäin yhteensopivuuden | Major-julkaisu | Ensimmäisen numeron korottaminen ja keskimmäisen ja viimeisen numeron nollaaminen | 2.0.0 |
Semanttisen versioinnin käyttäminen määrittääksesi päivitystyypit, jotka pakettisi voi hyväksyä
Voit määrittää, mitä päivitystyyppejä pakettisi voi hyväksyä riippuvuuksistasi pakettisi package.json
-tiedostossa.
Määritäksesi esimerkiksi hyväksyttävät versiovälit aina versioon 1.0.4 asti käytä seuraavaa syntaksia:
- Patch-julkaisut:
1.0
tai1.0.x
tai~1.0.4
- Minor releases:
1
tai1.x
tai^1.0.4
- Major releases:
*
taix
Lisätietoja semanttisesta versiointisyntaksista on npm semver -laskurissa.
Esimerkki
"dependencies": {"my_dep": "^1.0.0","another_dep": "~2.2.0"},
Vastaa