Articles
About semantic versioning
On 12月 9, 2021 by adminTable of contents
健全で、信頼でき、安全な JavaScript エコシステムを保つために、あなたが所有する npm パッケージに大きな更新をするたびに、semantic versioning 仕様に従った package.json
ファイルで更新したバージョン番号を持つパッケージの新しいバージョンを公開することを推奨しています。
注意: もしパッケージの依存関係を壊すような変更をした場合は、 バージョンのメジャー番号を増やすことを強く推奨します。
公開パッケージにおけるセマンティックバージョンの増加
あなたのコードに依存している開発者を助けるために、 あなたのパッケージのバージョンを 1.0.0
で開始し、以下のように増加させることを推奨しています。
コードステータス | ステージ | ルール | サンプルバージョン | ||
---|---|---|---|---|---|
最初のリリース | 新しい製品 | 1、2から始まる | 最初のリリース | 新しい製品から始まる | 1.0 から始まる |
最初のリリース | 1.0 から始まる | ||||
1.0 から始まる | |||||
1.0.0 | |||||
下位互換性のあるバグフィックス | パッチリリース | 3桁目をインクリメント | 1.0.1 | ||
下位互換性がある新機能 | マイナーリリース | 中桁をインクリメント、下桁をゼロにリセット | 1.0.1 | 1.0.1 | 1.0.1 |
後方互換性を破壊する変更 | メジャーリリース | 最初の桁をインクリメントし、中央と最後の桁をゼロにリセット | 2.0 | メジャーリリース | 後方互換性を破壊する変更 |
Using semantic versioning to specify update types your package can accept
パッケージの package.json
ファイルで、依存関係から受け入れることができる更新タイプを指定できます。
たとえば、1.0.4 までの許容できるバージョン範囲を指定するには、次の構文に従ってください:
- Patch releases.Patch Release.Version 2:
1.0
または1.0.x
または~1.0.4
- Minor releases:
1
または1.x
または^1.0.4
- メジャーリリース。
*
orx
セマンティックバージョニング構文の詳細については、npm semver calculatorを参照してください。
例
"dependencies": {"my_dep": "^1.0.0","another_dep": "~2.2.0"},
コメントを残す