O semantycznym wersjonowaniu

Aby utrzymać ekosystem JavaScript w zdrowiu, niezawodności i bezpieczeństwie, za każdym razem, gdy dokonujesz znaczących aktualizacji pakietu npm, którego jesteś właścicielem, zalecamy opublikowanie nowej wersji pakietu ze zaktualizowanym numerem wersji w pliku package.json, który podąża za specyfikacją semantycznego wersjonowania. Podążanie za semantyczną specyfiką wersjonowania pomaga innym programistom, którzy polegają na twoim kodzie, zrozumieć zakres zmian w danej wersji i dostosować swój własny kod, jeśli to konieczne.

Zwiększanie wersji semantycznych w opublikowanych pakietach

Aby pomóc programistom, którzy polegają na twoim kodzie, zalecamy rozpoczęcie wersji pakietu od 1.0.0 i zwiększanie jej w następujący sposób:

Używanie semantycznego wersjonowania do określania typów aktualizacji, które twój pakiet może zaakceptować

Możesz określić, które typy aktualizacji twój pakiet może zaakceptować z zależności w pliku package.json twojego pakietu.

Na przykład, aby określić dopuszczalne zakresy wersji do 1.0.4, użyj następującej składni:

• Wydania łatek: 1.0 lub 1.0.x lub ~1.0.4
• Minor releases: 1 lub 1.x lub ^1.0.4
• Major releases: * lub x

Więcej informacji na temat składni semantycznego wersjonowania można znaleźć w kalkulatorze npm semver.

Przykład

 "dependencies": { 
 "my_dep": "^1.0.0", 
 "another_dep": "~2.2.0" 
 },