建置發行前版本套件

每當您使用新的版本號碼發行更新的套件時,NuGet 會將它視為「最新的穩定版本」(如範例所示),例如在 Visual Studio 的套件管理員 UI 中:

Package Manager UI showing the latest stable release

穩定版本是認為足夠可靠能在生產環境中使用的版本。 最新的穩定版本也是會安裝為套件更新或在套件還原期間安裝的版本 (受重新安裝及更新套件中所述的條件約束)。

為支援軟體發行生命週期,NuGet 1.6 和更新版本允許散發發行前套件,它們的版本號碼包含語意版本尾碼,例如 -alpha-beta-rc。 如需詳細資訊,請參閱套件版本控制

您可以使用下列其中一種方式指定此版本:

  • 若您的專案使用 PackageReference:在 .csproj 檔案的 PackageVersion 元素中包括語意版本尾碼。

    <PropertyGroup>
        <PackageVersion>1.0.1-alpha</PackageVersion>
    </PropertyGroup>
    
  • 若您的專案有 packages.config 檔案:在 .nuspecversion 檔案的 元素中包括語意版本尾碼。

    <version>1.0.1-alpha</version>
    

當您準備好要發行穩定版本時,只要移除尾碼,套件就會優先於任何發行前版本。 請再次參考套件版本控制

安裝和更新發行前版本套件

NuGet 使用套件時預設不包含發行前版本,但是您可以如下所示變更此行為:

  • Visual Studio 中的套件管理員 UI:在 [管理 NuGet 套件] UI 中,核取 [包含發行前版本] 方塊:

    The Include prerelease checkbox in Visual Studio

    設定或清除此方塊會重新整理套件管理員 UI,以及您可以安裝的可用版本清單。

  • 套件管理員主控台:使用 -IncludePrerelease 參數搭配 Find-PackageGet-PackageInstall-PackageSync-PackageUpdate-Package 命令。 請參閱 PowerShell 參考

  • NuGet CLI:使用 -prerelease 參數搭配 installupdatedeletemirror 命令。 請參閱 NuGet CLI 參考

語意化版本控制系統

語意化版本控制系統或 SemVer 慣例描述如何利用版本號碼中的字串傳遞基礎程式碼的意涵。 深入瞭解 套件版本控制基本概念。