Budowanie pakietów wersji przedpremierowych

Za każdym razem, gdy wydasz zaktualizowany pakiet z nowym numerem wersji, NuGet uznaje go za "najnowszą stabilną wersję", jak pokazano na przykład w interfejsie użytkownika Menedżera pakietów w programie Visual Studio:

Stabilna wersja jest taka, która jest uważana za wystarczająco niezawodną, aby być używana w środowisku produkcyjnym. Najnowsza stabilna wersja to również ta, która zostanie zainstalowana jako aktualizacja pakietu lub podczas przywracania pakietu (z zastrzeżeniem ograniczeń opisanych w temacie Ponowne instalowanie i aktualizowanie pakietów).

W celu obsługi cyklu życia wydania oprogramowania pakiet NuGet 1.6 lub nowszy umożliwia dystrybucję pakietów wersji wstępnej, gdzie numer wersji zawiera sufiks semantycznego przechowywania wersji, taki jak -alpha, -betalub -rc. Aby uzyskać więcej informacji, zobacz Wersjonowanie pakietów.

Możesz określić takie wersje przy użyciu jednego z następujących sposobów:

• Jeśli w projekcie jest używany PackageReference: dołącz sufiks wersji semantycznej w elemencie .csproj pliku PackageVersion :

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

• Jeśli projekt zawiera packages.config plik: uwzględnij sufiks wersji semantycznej w elemencie .nuspec pliku version :

  <version>1.0.1-alpha</version>
  

Gdy wszystko będzie gotowe do wydania stabilnej wersji, po prostu usuń sufiks, a pakiet ma pierwszeństwo przed wszystkimi wersjami wstępnymi. Ponownie zobacz Wersjonowanie pakietu.

Instalowanie i aktualizowanie pakietów przedpremierowych

Domyślnie pakiet NuGet nie zawiera wersji wstępnych podczas pracy z pakietami, ale można zmienić to zachowanie w następujący sposób:

• Interfejs użytkownika menedżera pakietów w programie Visual Studio: w interfejsie użytkownika Zarządzanie pakietami NuGet zaznacz pole Uwzględnij wersję wstępną :

  

  Ustawienie lub wyczyszczenie tego pola spowoduje odświeżenie interfejsu użytkownika Menedżera pakietów i listy dostępnych wersji, które można zainstalować.

• Konsola Menedżera pakietów: użyj przełącznika -IncludePrerelease z poleceniami Find-Package, Get-Package, Install-Package, Sync-Package i Update-Package. Zapoznaj się z dokumentacją programu PowerShell.

• Interfejs wiersza polecenia narzędzia NuGet: użyj przełącznika -prerelease wraz z poleceniami install, update, delete i mirror. Zapoznaj się z dokumentacją interfejsu wiersza polecenia narzędzia NuGet

Semantyczne wersjonowanie

W konwencji Semantic Versioning lub SemVer opisano sposób użycia ciągów w numerach wersji w celu przekazania znaczenia kodu bazowego. Dowiedz się więcej na temat podstaw przechowywania wersji pakietów.