新しいバージョン番号で更新されたパッケージをリリースするたびに、NuGet では、Visual Studio 内のパッケージ マネージャー UI など、そのパッケージが "最新の安定したリリース" と見なされます。
安定したリリースは、運用環境で使用するのに十分な信頼性があると見なされるリリースです。 最新の安定版リリースは、パッケージの更新またはパッケージの復元中にインストールされるリリースでもあります (パッケージの 再インストールと更新の説明に従って制約が適用されます)。
ソフトウェア リリース ライフサイクルをサポートするために、NuGet 1.6 以降ではプレリリース パッケージを配布できます。バージョン番号には、 -alpha、 -beta、 -rcなどのセマンティック バージョン管理サフィックスが含まれています。 詳細については、「 パッケージのバージョン管理」を参照してください。
このようなバージョンは、次のいずれかの方法で指定できます。
プロジェクトで
PackageReferenceを使用する場合:.csprojファイルのPackageVersion要素にセマンティック バージョン サフィックスを含めます。<PropertyGroup> <PackageVersion>1.0.1-alpha</PackageVersion> </PropertyGroup>プロジェクトに
packages.configファイルがある場合:.nuspecファイルのversion要素にセマンティック バージョン サフィックスを含めます。<version>1.0.1-alpha</version>
安定したバージョンをリリースする準備ができたら、サフィックスを削除するだけで、パッケージはプレリリース バージョンよりも優先されます。 ここでも、「 パッケージのバージョン管理」を参照してください。
プレリリース パッケージのインストールと更新
既定では、NuGet にはパッケージを操作するときにプレリリース バージョンは含まれませんが、この動作は次のように変更できます。
Visual Studio のパッケージ マネージャー UI: [NuGet パッケージの管理 ] UI で、[ プレリリースを含める ] チェック ボックスをオンにします。
このボックスを設定またはクリアすると、パッケージ マネージャー UI と、インストールできる使用可能なバージョンの一覧が更新されます。
パッケージ マネージャー コンソール:
-IncludePrerelease、Find-Package、Get-Package、Install-Package、およびSync-PackageコマンドでUpdate-Packageスイッチを使用します。 PowerShell リファレンスを参照してください。NuGet CLI:
-prerelease、install、update、およびdeleteコマンドでmirrorスイッチを使用します。 NuGet CLI リファレンスを参照してください
セマンティック バージョン管理
セマンティック バージョン管理または SemVer 規則では、バージョン番号の文字列を使用して、基になるコードの意味を伝える方法について説明します。 パッケージのバージョン管理の基本について詳しくは、こちらをご覧ください。