Erstellen von Vorabpaketen

Wenn Sie eine aktualisierte Version eines Pakets mit einer neuen Versionsnummer veröffentlichen, betrachtet NuGet diese als die "neueste stabile Version", wie beispielsweise in der Paket-Manager-Benutzeroberfläche von Visual Studio dargestellt.

Eine stabile Version ist eine, die als zuverlässig genug gilt, um in der Produktion eingesetzt zu werden. Die neueste stabile Version ist auch die Version, die als Paketupdate oder während der Paketwiederherstellung installiert wird (vorbehaltlich von Einschränkungen, wie in der Neuinstallation und Aktualisierung von Paketen beschrieben).

Zur Unterstützung des Lebenszyklus von Softwareveröffentlichungen ermöglicht NuGet 1.6 und höher die Verteilung von Vorabversionen, wobei die Versionsnummer ein semantisches Versionssuffix wie -alpha, -beta oder -rc enthält. Weitere Informationen finden Sie unter Paketversionsverwaltung.

Sie können solche Versionen auf eine der folgenden Arten angeben:

• Wenn Ihr Projekt folgendes verwendet PackageReference: Fügen Sie das Suffix der semantischen Version in das Element der .csproj Datei PackageVersion ein:

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

• Wenn Ihr Projekt über eine packages.config Datei verfügt: Fügen Sie das Suffix der semantischen Version in das Element der .nuspec Datei version ein:

  <version>1.0.1-alpha</version>
  

Wenn Sie bereit sind, eine stabile Version freizugeben, entfernen Sie einfach das Suffix, und das Paket hat Vorrang vor allen Vorabversionen. Weitere Informationen finden Sie unter "Paketversionsverwaltung".

Installieren und Aktualisieren von Vorabpaketen

Standardmäßig enthält NuGet keine Vorabversionen, wenn Sie mit Paketen arbeiten, aber Sie können dieses Verhalten wie folgt ändern:

• Benutzeroberfläche des Paket-Managers in Visual Studio: Aktivieren Sie auf der Benutzeroberfläche " NuGet-Pakete verwalten " das Kontrollkästchen "Vorabversion einschließen ":

  

  Wenn Sie dieses Feld festlegen oder deaktivieren, wird die Benutzeroberfläche des Paket-Managers und die Liste der verfügbaren Versionen aktualisiert, die Sie installieren können.

• Paket-Manager-Konsole: Verwenden Sie den -IncludePrerelease Switch mit den Find-Package, Get-Package, Install-Package, Sync-Package und Update-Package Befehlen. Verweisen Sie auf die PowerShell-Referenz.

• NuGet CLI: Verwenden Sie das -prerelease-Schalter mit den install, update, delete und mirror Befehlen. Verweis auf die NuGet CLI-Referenz

Semantische Versionsverwaltung

Die Semantische Versionsverwaltungs- oder SemVer-Konvention beschreibt, wie Zeichenfolgen in Versionsnummern verwendet werden, um die Bedeutung des zugrunde liegenden Codes zu vermitteln. Erfahren Sie mehr über die Grundlagen der Paketversionsverwaltung.