「Open棟梁 wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。
目次 †
概要 †
- Open棟梁のバージョン番号付与ポリシーについてまとめた。
- 基本的には、6ヶ月単位の定期リリースの際にバージョンアップさせる。
詳細 †
AssemblyVersion? †
major.minor.build.revisionの形式で、
- AssemblyInfo?(.NET Framework)
- Projectファイル(.NET Standard、.NET Core)
にバージョン番号を付与する。
※ AssemblyFileVersion?、AssemblyInformationalVersion?はこの値を使用する。
major †
後方互換は維持しているので、
- コンセプト変更や、
- 5年以上のminor更新の継続
などで、インクリメント。
minor †
半年単位のリリースでインクリメントしていく。
build †
NuGet?リリースの度にインクリメントしていく。
revision †
使用しないので、常に0。
PackageVersion? †
major.minor.buildの形式で*.nuspecファイルにバージョン番号を付与する。
(AssemblyVersionの頭3つ(major, minor, build)と同じ)
revisionは使用しない。
プレリリース版のバージョン番号付与方法
実運用 †
定期リリースと不定期・緊急リリース †
定期リリースでは、2つのバージョン番号を一致させる †
- ケース
- 6ヶ月単位の定期リリース時
- 修正範囲が上位パッケージを含め広範囲に渡る場合
- バージョンアップを適用する場合、
- 対象となる、上位パッケージのNuGet?参照をバージョンアップする。
- この場合、アセンブリ・バージョン・リダイレクトの設定が必要になるケースがある。
不定期・緊急リリースでは、2つのバージョン番号を一致させないケースがある。 †
- バージョンアップを適用する場合、
- 最上位のアプリケーションから、新バージョンのNuGet?参照を追加して上書きする。
- この場合、アセンブリ・バージョン・リダイレクトの設定は不要になる。
参考 †
マイクロソフト系技術情報 Wiki †
OSSコンソーシアム †