Omówienie NuGet.org

NuGet.org jest publicznym hostem pakietów NuGet, które są wykorzystywane przez miliony deweloperów platformy .NET i .NET Core każdego dnia.

Rola NuGet.org w ekosystemie NuGet

Jako host publiczny NuGet.org sam utrzymuje centralne repozytorium ponad 100 000 unikatowych pakietów w nuget.org. NuGet.org nie jest jedynym hostem dla pakietów. Technologia NuGet umożliwia również hostowanie pakietów prywatnie w chmurze (na przykład w usłudze Azure DevOps), w sieci prywatnej, a nawet w tylko lokalnym systemie plików. Jeśli interesuje Cię inna opcja hosta lub hostingu, zobacz Hosting własnych kanałów informacyjnych NuGet.

NuGet.org, podobnie jak każdy host pakietów NuGet, służy jako punkt połączenia między twórcami pakietów a odbiorcami pakietów. Twórcy tworzą przydatne pakiety NuGet i publikują je. Następnie użytkownicy wyszukują przydatne i zgodne pakiety na hostach z ułatwieniami dostępu, pobierając i włączając te pakiety w swoich projektach. Po zainstalowaniu w projekcie interfejsy API pakietów są dostępne dla pozostałej części kodu projektu.

Accounts

Aby opublikować pakiety na NuGet.org, należy najpierw utworzyć pojedyncze konto (użytkownika). Staje się to Twoją tożsamością w NuGet.org.

NuGet.org umożliwia również utworzenie konta organizacji. Konto organizacji ma co najmniej jedno konto indywidualne jako swoich 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, jak również do konta indywidualnego. 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 NuGet.org przy użyciu interfejsu wiersza polecenia nuget.exe lub interfejsu wiersza polecenia dotnet.exe wraz z kluczem interfejsu API uzyskanym z NuGet.org.

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

Zaufane publikowanie

NuGet.org obsługuje zaufane publikowanie, czyli bezpieczny i usprawniony sposób publikowania pakietów NuGet.

Prefiksy identyfikatorów

Podczas publikowania pakietów można zarezerwować i chronić swoją tożsamość, rezerwując prefiksy identyfikatorów. Podczas instalowania pakietu użytkownicy pakietów otrzymują dodatkowe informacje wskazujące, że pakiet, z którego korzystają, nie jest zwodniczy w swoich właściwościach identyfikujących.

Punkt dostępowy 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 NuGet.org. Należy jednak pamiętać, że klienci NuGet 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!)