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.0nebo1.0.xnebo~1.0.4 - Menší verze:
1.0nebo1.0.xnebo~1.0.4 - Menší verze:
Příklad
"dependencies": {"my_dep": "^1.0.0","another_dep": "~2.2.0"},
Napsat komentář