O sémantickém verzování
On 9 prosince, 2021 by adminAby byl ekosystém JavaScriptu zdravý, spolehlivý a bezpečný, doporučujeme při každé významné aktualizaci balíčku npm, který vlastníte, publikovat novou verzi balíčku s aktualizovaným číslem verze v souboru package.json
, který se řídí specifikací sémantického verzování. Dodržování specifikace sémantického verzování pomůže ostatním vývojářům, kteří jsou závislí na vašem kódu, pochopit rozsah změn v dané verzi a v případě potřeby upravit svůj vlastní kód.
Zvyšování sémantických verzí v publikovaných balíčcích
Chcete-li pomoci vývojářům, kteří se spoléhají na váš kód, doporučujeme začít verzi balíčku na 1.0.0
a zvyšovat ji následujícím způsobem:
Stav kódu | Stupeň | Pravidlo | Vzor verze |
---|---|---|---|
První vydání | Nový produkt | Začněte s 1.0.0 | 1.0.0 |
Zpětně kompatibilní opravy chyb | Patch release | Zvýšení třetí číslice | 1.0.1 |
Zpětně kompatibilní nové funkce | Minor release | Zvýšení prostřední číslice a vynulování poslední číslice | 1.1.0 |
Změny, které porušují zpětnou kompatibilitu | Velká verze | Zvýšení první číslice a vynulování prostřední a poslední číslice | 2.0.0 |
Použití sémantického verzování k určení typů aktualizací, které může váš balíček přijmout
V souboru balíčku package.json
můžete určit, které typy aktualizací může váš balíček přijmout od závislostí.
Pro určení přijatelných rozsahů verzí až do 1.0.4 použijte například následující syntaxi:
- Vydání záplat:
1.0
nebo1.0.x
nebo~1.0.4
- Menší verze:
1.0
nebo1.0.x
nebo~1.0.4
- Menší verze:
Příklad
"dependencies": {"my_dep": "^1.0.0","another_dep": "~2.2.0"},
Napsat komentář