Panoramica delle NuGet.org

NuGet.org è un host pubblico di pacchetti NuGet usati da milioni di sviluppatori .NET e .NET Core ogni giorno.

Ruolo di NuGet.org nell'ecosistema NuGet

Nel ruolo di host pubblico, NuGet.org stesso gestisce il repository centrale di oltre 100.000 pacchetti univoci in nuget.org. NuGet.org non è l'unico host possibile per i pacchetti. La tecnologia NuGet consente anche di ospitare i pacchetti privatamente nel cloud (ad esempio in Azure DevOps), in una rete privata o anche solo nel file system locale. Se sei interessato a un host o a un'opzione di hosting diversa, consulta Hosting di feed NuGet personalizzati.

NuGet.org, come qualsiasi host per i pacchetti NuGet, funge da punto di connessione tra creatori di pacchetti e consumer di pacchetti. I creatori creano utili pacchetti NuGet e li pubblicano. I consumer cercano quindi pacchetti utili e compatibili su host accessibili, scaricando e includendo tali pacchetti nei progetti. Dopo l'installazione in un progetto, le API dei pacchetti sono disponibili per il resto del codice del progetto.

Accounts

Per pubblicare pacchetti in NuGet.org, creare prima di tutto un singolo account (utente). Questa diventa l'identità su NuGet.org.

NuGet.org consente anche di creare un account dell'organizzazione. Un account di un'organizzazione ha uno o più account individuali come membri. I membri possono gestire un set di pacchetti mantenendo al tempo stesso una singola identità per la proprietà. Tramite il singolo account, è possibile essere membri di un numero qualsiasi di organizzazioni.

Un pacchetto può appartenere a un account dell'organizzazione come può appartenere a un singolo account. I consumer di pacchetti non vedono alcuna differenza tra un singolo account o l'account dell'organizzazione: entrambi vengono visualizzati come pacchetto owners.

Chiavi dell'API

Dopo aver creato un pacchetto NuGet (file con estensione nupkg ) da pubblicare, pubblicarlo in NuGet.org usando l'interfaccia della riga di comando di nuget.exe o l'interfaccia della riga di comando di dotnet.exe, insieme a una chiave API acquisita da NuGet.org.

Quando si pubblica un pacchetto, si include il valore della chiave API nel comando dell'interfaccia della riga di comando.

Pubblicazione attendibile

NuGet.org supporta la pubblicazione attendibile, che è un modo sicuro e semplificato per pubblicare pacchetti NuGet.

Prefissi ID

Quando si pubblicano pacchetti, è possibile riservare e proteggere l'identità riservando i prefissi ID. Quando si installa un pacchetto, gli utenti dei pacchetti ricevono informazioni aggiuntive che indicano che il pacchetto che utilizzano non è ingannevole nelle proprietà identificative.

Endpoint API per NuGet.org

Per usare NuGet.org come repository di pacchetti con i client NuGet, è necessario usare l'endpoint API V3 seguente:

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

I client meno recenti possono comunque usare il protocollo V2 per raggiungere NuGet.org. Si noti tuttavia che i client NuGet 3.0 o versioni successive avranno un servizio più lento e meno affidabile usando il protocollo V2:

https://www.nuget.org/api/v2 (Il protocollo V2 è deprecato!)