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.0vagy1.0.xvagy~1.0.4 - Kisebb kiadások:
1vagy1.xvagy^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?