Omówienie witryny NuGet.org

NuGet.org to publiczny host pakietów NuGet, które są codziennie wykorzystywane przez miliony deweloperów .NET i .NET Core.

Rola NuGet.org w ekosystemie NuGet

W roli hosta publicznego sam NuGet.org utrzymuje centralne repozytorium ponad 100 000 unikatowych pakietów w nuget.org. NuGet.org nie jest jedynym możliwym hostem pakietów. Technologia NuGet umożliwia również hostowanie pakietów prywatnie w chmurze (na przykład w Azure DevOps), w sieci prywatnej, a nawet tylko w lokalnym systemie plików. Jeśli interesuje Cię inna opcja hosta lub hostingu, zobacz Hosting własnych źródeł danych NuGet.

NuGet.org, podobnie jak każdy host pakietów NuGet, służy jako punkt połączenia między twórcami pakietów i użytkownikami pakietów. Twórcy tworzą przydatne pakiety NuGet i publikują je. Następnie użytkownicy szukają przydatnych i zgodnych pakietów na hostach z ułatwieniami dostępu, pobieraniu i dołączaniu tych pakietów w swoich projektach. Po zainstalowaniu w projekcie interfejsy API pakietów są dostępne dla reszty kodu projektu.

Konta

Aby opublikować pakiety w witrynie NuGet.org, należy najpierw utworzyć indywidualne (użytkownika) konto. Stanie się to twoją tożsamością w witrynie NuGet.org.

NuGet.org umożliwia również utworzenie konta organizacji. Konto organizacji ma co najmniej jedno indywidualne konto jako jego członków. Członkowie mogą zarządzać zestawem pakietów przy zachowaniu jednej tożsamości dla własności. Za pośrednictwem indywidualnego konta możesz być członkiem dowolnej liczby organizacji.

Pakiet może należeć do konta organizacji, takiego jak może należeć do pojedynczego konta. Użytkownicy pakietów nie widzą żadnej różnicy między pojedynczym kontem lub kontem organizacji: oba są wyświetlane jako pakiet owners.

Klucze interfejsu API

Po opublikowaniu pakietu NuGet (pliku nupkg) opublikujesz go w witrynie NuGet.org przy użyciu interfejsu wiersza polecenia nuget.exe lub interfejsu wiersza polecenia dotnet.exe wraz z kluczem interfejsu API uzyskanym z witryny NuGet.org.

Podczas publikowania pakietu należy uwzględnić wartość klucza interfejsu API w poleceniu interfejsu wiersza polecenia.

Prefiksy identyfikatorów

Podczas publikowania pakietów można zarezerwować i chronić swoją tożsamość, rezerwując prefiksy identyfikatorów. Podczas instalowania pakietu odbiorcy pakietów otrzymują dodatkowe informacje wskazujące, że pakiet, który zużywa, nie jest zwodniczy w jego właściwościach identyfikujących.

Punkt końcowy interfejsu API dla NuGet.org

Aby użyć NuGet.org jako repozytorium pakietów z klientami NuGet, należy użyć następującego punktu końcowego interfejsu API w wersji 3:

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

Starsi klienci nadal mogą korzystać z protokołu V2, aby uzyskać dostęp do witryny NuGet.org. Należy jednak pamiętać, NuGet że klienci w wersji 3.0 lub nowszej będą mieli wolniejsze i mniej niezawodne usługi przy użyciu protokołu V2:

https://www.nuget.org/api/v2 (Protokół V2 jest przestarzały!)