Übersicht über NuGet.org

NuGet.org ist ein öffentlicher Host für NuGet-Pakete, der täglich von Millionen von .NET- und .NET Core-Entwicklern genutzt wird.

Rolle von NuGet.org im NuGet-Ökosystem

In seiner Rolle als öffentlicher Host verwaltet NuGet.org selbst das zentrale Repository mit über 100.000 eindeutigen Paketen auf nuget.org. NuGet.org ist nicht der einzige mögliche Host für Pakete. Mit der NuGet-Technologie können Sie auch Pakete privat in der Cloud (z.B. in Azure DevOps), in einem privaten Netzwerk oder sogar nur auf Ihrem lokalen Dateisystem hosten. Wenn Sie an einem anderen Host oder einer anderen Hostingoption interessiert sind, finden Sie weitere Informationen unter Hosten eigener NuGet-Feeds.

NuGet.org dient, wie jeder andere Host für NuGet-Pakete, als Verbindungspunkt zwischen Paketerstellern und Paketconsumern. Paketersteller erstellen nützliche NuGet-Pakete und veröffentlichen sie. Benutzer suchen dann nach nützlichen und kompatiblen Paketen auf zugänglichen Hosts, laden diese Pakete herunter und schließen sie in Ihre Projekte ein. Nach der Installation in einem Projekt sind die Paket-APIs für den restlichen Projektcode verfügbar.

Relationship between package creators, package hosts, and package consumers

Konten

Um Pakete auf NuGet.org zu veröffentlichen, erstellen Sie zunächst ein individuelles Benutzerkonto. Dieses Konto ist Ihre Identität auf NuGet.org.

NuGet.org ermöglicht außerdem das Erstellen von Organisationskonten. Ein Organisationskonto umfasst mehrere Einzelkonten als Mitglieder. Diese Mitglieder können einen Paketsatz verwalten und hierbei eine einzige Identität für den Besitz nutzen. Durch Ihr individuelles Konto können Sie Mitglied in einer beliebigen Anzahl von Organisationen sein.

Ein Paket kann einem Organisationskonto ebenso angehören wie einem individuellen Konto. Paketconsumer erkennen keinen Unterschied zwischen einem individuellen Konto oder dem Organisationskonto: beide werden als Paket owners angezeigt.

API-Schlüssel

Sobald Sie über ein NuGet-Paket (.nupkg-Datei) für die Veröffentlichung verfügen, können Sie es zusammen mit einem von NuGet.org abgerufenen API-Schlüssel entweder über die nuget.exe-CLI oder die dotnet.exe-CLI veröffentlichen.

Wenn Sie ein Paket veröffentlichen, schließen Sie den API-Schlüsselwert in den CLI-Befehl ein.

ID-Präfixe

Wenn Sie Pakete veröffentlichen, können Sie Ihre Identität durch das Reservieren von ID-Präfixen schützen. Paketconsumer erhalten beim Installieren eines Pakets zusätzliche Informationen und werden darauf hingewiesen, dass das genutzte Paket hinsichtlich identifizierender Eigenschaften eindeutig ist.

API-Endpunkt für NuGet.org

Um NuGet.org als Paketrepository mit NuGet-Clients verwenden zu können, müssen Sie den folgenden V3-API-Endpunkt verwenden:

https://api.nuget.org/v3/index.json

Ältere Clients können weiterhin das V2-Protokoll verwenden, um NuGet.org zu erreichen. Beachten Sie jedoch, dass NuGet-Clients ab Version 3.0 oder höher bei Verwendung des V2-Protokolls über langsamere und weniger zuverlässige Dienste verfügen werden:

https://www.nuget.org/api/v2 (Das V2-Protokoll ist veraltet. )