A szemantikus verziókezelésről
On december 9, 2021 by adminA JavaScript ökoszisztéma egészségének, megbízhatóságának és biztonságának megőrzése érdekében minden alkalommal, amikor jelentős frissítéseket végez egy saját npm csomagján, javasoljuk, hogy a csomag új verzióját frissített verziószámmal tegye közzé a package.json
fájlban, amely követi a szemantikus verziókezelési specifikációt. A szemantikus verziószámozási specifikáció követése segít a többi, az Ön kódjától függő fejlesztőnek megérteni az adott verzióban bekövetkezett változások mértékét, és szükség esetén módosítani a saját kódjukat.
A szemantikus verziók növelése a közzétett csomagokban
A kódjára támaszkodó fejlesztők segítése érdekében javasoljuk, hogy a csomag verziószámát 1.0.0
-nél kezdje, és az alábbiak szerint növelje:
Kódállapot | Fázis | Szabály | Példa verzió |
---|---|---|---|
Első kiadás | Új termék | Kezd az 1-gyel.0.0 | 1.0.0 |
Hátulról kompatibilis hibajavítások | Patch kiadás | Növeli a harmadik számjegyet | 1.0.1 |
Hátulról kompatibilis új funkciók | Kisebb kiadás | Növeli a középső számjegyet és nullára állítja az utolsó számjegyet | 1.1.0 |
A visszafelé kompatibilitást megtörő változások | Nagy kiadás | Az első számjegy növelése és a középső és az utolsó számjegy nullára állítása | 2.0.0 |
A szemantikus verziókezelés használata a csomag által elfogadható frissítési típusok megadásához
A csomag package.json
fájljában megadhatja, hogy a csomagja milyen frissítési típusokat fogadhat el a függőségektől.
Az 1.0.4-ig elfogadható verziószámtartományok megadásához például a következő szintaxist használja:
- Patch releases:
1.0
vagy1.0.x
vagy~1.0.4
- Kisebb kiadások:
1
vagy1.x
vagy^1.0.4
- Nagyobb kiadások:
*
vagyx
A szemantikus verziókezelési szintaxissal kapcsolatos további információkért lásd az npm semver kalkulátorát.
Példa
"dependencies":"my_dep": {"my_dep": "^1.0.0","another_dep": "~2.2.0"},
Vélemény, hozzászólás?