プレリリース パッケージのビルド

更新したパッケージを新しいバージョン番号でリリースすると、NuGet はそれを "最新の安定版リリース" として見なし、たとえば、Visual Studio 内のパッケージ マネージャー UI で下記のように表示されます。

安定版リリースとは、実稼働環境で使用するだけの信頼性があると見なされるリリースです。 最新の安定版リリースは、パッケージ更新またはパッケージ復元でインストールされるリリースでもあります (「Reinstalling and updating packages」 (パッケージの再インストールと更新) の説明にある制約に左右されます)。

ソフトウェア リリース ライフサイクルをサポートするために、NuGet 1.6 以降では、プレリリース パッケージを配信できます。バージョン番号には、-alpha、-beta、-rc のようなセマンティック バージョン管理サフィックスが含まれます。 詳細については、「Package versioning」(パッケージのバージョン管理) を参照してください。

次の方法のいずれかを使って、このようなバージョンを指定できます。

• プロジェクトで PackageReference を使う場合: .csproj ファイルの PackageVersion 要素にセマンティック バージョン サフィックスを含めます。

  <PropertyGroup>
      <PackageVersion>1.0.1-alpha</PackageVersion>
  </PropertyGroup>
  

• プロジェクトに packages.config ファイルがある場合: .nuspec ファイルの version 要素にセマンティック バージョン サフィックスを含めます。

  <version>1.0.1-alpha</version>
  

安定版バージョンをリリースする用意ができたら、サフィックスを削除します。このパッケージはあらゆるプレリリース版に優先します。 繰り返しになりますが、「Package versioning」(パッケージのバージョン管理) を参照してください。

プレリリース パッケージのインストールと更新

既定で、NuGet ではパッケージの使用時にプレリリース版を含めませんが、この動作は次のように変更できます。

• Visual Studio のパッケージ マネージャー UI: [NuGet パッケージの管理] UI で、[プレリリースを含める] ボックスを選択します。

  

  このボックスをオンまたはオフにするとパッケージ マネージャー UI とインストールできるバージョンの一覧が更新されます。

• パッケージ マネージャー コンソール: Find-Package、Get-Package、Install-Package、Sync-Package、Update-Package コマンドで -IncludePrerelease スイッチを使用します。 「PowerShell Reference」 (PowerShell リファレンス) を参照してください。

• NuGet CLI: install、update、delete、mirror コマンドで -prerelease スイッチを使用します。 「NuGet CLI reference」 (NuGet CLI リファレンス) を参照してください。

セマンティック バージョン管理

「Semantic Versioning or SemVer convention」 (セマンティック バージョニングまたは SemVer 規則) では、バージョン番号の文字列を活用し、基礎となっているコードの意味を伝える方法が説明されています。 パッケージのバージョン管理の基本について詳しくは、こちらをご覧ください。