次の方法で共有

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

  • [アーティクル]

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

Package Manager UI showing the latest stable release

安定版リリースとは、実稼働環境で使用するだけの信頼性があると見なされるリリースです。 最新の安定版リリースは、パッケージ更新またはパッケージ復元でインストールされるリリースでもあります (「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 で、[プレリリースを含める] ボックスを選択します。

    The Include prerelease checkbox in Visual Studio

    このボックスをオンまたはオフにするとパッケージ マネージャー 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 規則) では、バージョン番号の文字列を活用し、基礎となっているコードの意味を伝える方法が説明されています。 パッケージのバージョン管理の基本について詳しくは、こちらをご覧ください。