次の方法で共有


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

新しいバージョン番号で更新されたパッケージをリリースするたびに、NuGet では、Visual Studio 内のパッケージ マネージャー UI など、そのパッケージが "最新の安定したリリース" と見なされます。

最新の安定版リリースを示すパッケージ マネージャー 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 で、[ プレリリースを含める ] チェック ボックスをオンにします。

    Visual Studio の [プレリリースを含める] チェック ボックス

    このボックスを設定またはクリアすると、パッケージ マネージャー UI と、インストールできる使用可能なバージョンの一覧が更新されます。

  • パッケージ マネージャー コンソール: -IncludePrereleaseFind-PackageGet-PackageInstall-Package、およびSync-PackageコマンドでUpdate-Package スイッチを使用します。 PowerShell リファレンスを参照してください。

  • NuGet CLI: -prereleaseinstallupdate、およびdeleteコマンドでmirror スイッチを使用します。 NuGet CLI リファレンスを参照してください

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

セマンティック バージョン管理または SemVer 規則では、バージョン番号の文字列を使用して、基になるコードの意味を伝える方法について説明します。 パッケージのバージョン管理の基本について詳しくは、こちらをご覧ください