Panoramica di NuGet.org

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

Ruolo di NuGet.org nell'ecosistema NuGet

Nel suo ruolo come host pubblico, NuGet.org 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 in modo privato nel cloud (ad esempio in Azure DevOps), in una rete privata o anche direttamente nel file system locale. Se è interessati a un host diverso o a un'opzione di hosting diversa, vedere Hosting dei feed NuGet.

Come qualsiasi host di pacchetti NuGet, NuGet.org fa da punto di connessione tra gli autori e i consumer dei pacchetti. Gli autori compilano utili pacchetti NuGet e li pubblicano. I consumer cercano quindi i pacchetti utili e compatibili negli host accessibili, scaricandoli e includendoli nei loro progetti. Una volta installate in un progetto, le API dei pacchetti sono disponibili per il resto del codice del progetto.

Account

Per pubblicare pacchetti in NuGet.org, iniziare creando un account individuale (account utente). Questo account diventa l'identità dell'utente in NuGet.org.

NuGet.org consente anche di creare un account aziendale. Un account aziendale ha uno o più account personali come membri. I membri possono gestire un set di pacchetti mantenendo un'unica identità per la proprietà. L'account personale consente a un utente di essere membro di un numero qualsiasi di organizzazioni.

Un pacchetto può appartenere a un account aziendale come a un account individuale. I consumer di pacchetti non notano differenze tra un account personale e l'account aziendale: entrambi vengono visualizzati come owners del pacchetto.

Chiavi API

Dopo aver creato un pacchetto NuGet (un file con estensione nupkg) da pubblicare, pubblicarlo in NuGet.org usando l'interfaccia della riga di comando nuget.exe o 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.

Prefissi ID

Quando si esegue la pubblicazione dei pacchetti, è possibile riservare e proteggere la propria identità riservando prefissi ID. Quando si installa un pacchetto, ai consumer di pacchetti vengono fornite informazioni aggiuntive indicanti che le proprietà di identificazione del pacchetto in uso non sono fuorvianti.

Endpoint API per NuGet.org

Per usare NuGet.org come repository di pacchetti con i client NuGet, è consigliabile 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. Tuttavia, si noti che NuGet client 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!)