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"},
コメントを残す