Kompilowanie pakietów wstępnych

Za każdym razem, gdy wydasz zaktualizowany pakiet z nowym numerem wersji, nuGet uzna ten za "najnowszą stabilną wersję", jak pokazano na przykład w interfejsie użytkownika Menedżer 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 Przechowywanie wersji 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 Przechowywanie wersji pakietów.

Instalowanie i aktualizowanie pakietów wstępnych

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:

• Menedżer pakietów interfejs użytkownika 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żer pakietów oraz listę dostępnych wersji, które można zainstalować.

• Menedżer pakietów Console: użyj przełącznika -IncludePrereleaseFind-Packagez poleceniami , Get-Package, Install-Package, Sync-Packagei Update-Package . Zapoznaj się z dokumentacją programu PowerShell.

• Interfejs wiersza polecenia narzędzia NuGet: użyj przełącznika -prereleaseinstallz poleceniami , update, deletei mirror . Zapoznaj się z dokumentacją interfejsu wiersza polecenia narzędzia NuGet

Semantyczna obsługa wersji

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.