Vue d’ensemble de NuGet.org

NuGet.org est un hôte public de packages NuGet utilisés par des millions de développeurs .NET et .NET Core tous les jours.

Rôle de NuGet.org dans l’écosystème NuGet

Dans son rôle d’hôte public, NuGet.org lui-même gère le référentiel central de plus de 100 000 packages uniques à nuget.org. NuGet.org n’est pas le seul hôte possible pour les packages. La technologie NuGet vous permet également d’héberger des packages en privé dans le cloud (par exemple, sur Azure DevOps), sur un réseau privé ou même sur votre système de fichiers local. Si vous êtes intéressé par une autre option d’hôte ou d’hébergement, consultez Hébergement de vos propres flux NuGet.

NuGet.org, comme n’importe quel hôte pour les packages NuGet, sert de point de connexion entre les créateurs de packages et les consommateurs de packages. Les créateurs créent des packages NuGet utiles et les publient. Les consommateurs recherchent ensuite des packages utiles et compatibles sur des hôtes accessibles, en téléchargeant et en incluant ces packages dans leurs projets. Une fois installées dans un projet, les API des packages sont disponibles pour le reste du code du projet.

Accounts

Pour publier des packages sur NuGet.org, vous créez d’abord un compte individuel (utilisateur). Cela devient votre identité sur NuGet.org.

NuGet.org vous permet également de créer un compte d’organisation. Un compte d’organisation possède un ou plusieurs comptes individuels en tant que membres. Les membres peuvent gérer un ensemble de packages tout en conservant une identité unique pour la propriété. Par le biais de votre compte individuel, vous pouvez être membre de n’importe quel nombre d’organisations.

Un package peut appartenir à un compte d’organisation comme il peut appartenir à un compte individuel. Les consommateurs de packages ne voient aucune différence entre un compte individuel ou le compte d’organisation : les deux apparaissent en tant que package owners.

Clés API

Une fois que vous avez un package NuGet (fichier .nupkg ) à publier, vous le publiez sur NuGet.org à l’aide de l’interface CLI nuget.exe ou de l’interface CLI dotnet.exe, ainsi qu’une clé API acquise à partir de NuGet.org.

Lorsque vous publiez un package, vous incluez la valeur de clé API dans la commande CLI.

Publication de confiance

NuGet.org prend en charge la publication approuvée, qui est un moyen sécurisé et simplifié de publier des packages NuGet.

Préfixes d’ID

Lorsque vous publiez des packages, vous pouvez réserver et protéger votre identité en réservant des préfixes d’ID. Lors de l’installation d’un package, les consommateurs de packages sont fournis avec des informations supplémentaires indiquant que le package qu’ils consomment n’est pas trompeur dans ses propriétés d’identification.

Point de terminaison d’API pour NuGet.org

Pour utiliser NuGet.org en tant que référentiel de packages avec les clients NuGet, vous devez utiliser le point de terminaison d’API V3 suivant :

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

Les clients plus anciens peuvent toujours utiliser le protocole V2 pour atteindre NuGet.org. Toutefois, notez que les clients NuGet 3.0 ou ultérieur auront un service plus lent et moins fiable à l’aide du protocole V2 :

https://www.nuget.org/api/v2 (Le protocole V2 est déconseillé !)