Vue d’ensemble de NuGet.org

NuGet.org est un hôte public qui héberge les packages NuGet utilisés par des millions de développeurs .NET et .NET Core chaque jour.

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

Dans son rôle d’hôte public, NuGet.org gère lui-même 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 à titre privé dans le cloud (par exemple sur Azure DevOps), sur un réseau privé ou tout simplement sur votre système de fichiers local. Si vous êtes intéressé par un autre hôte ou une autre option d’hébergement, consultez Hébergement de vos propres flux NuGet.

NuGet.org, comme tous les autres hôtes de packages NuGet, sert de point de connexion entre les créateurs et les consommateurs de packages. Les créateurs génèrent des packages NuGet utiles et les publient. Les consommateurs recherchent des packages pratiques et compatibles sur les hôtes accessibles, les téléchargent et incluent ces packages dans leurs projets. Une fois installés dans un projet, les API des packages sont disponibles pour le reste du code du projet.

Comptes

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

NuGet.org vous permet également de créer un compte d’organisation. Un compte d’organisation comprend un ou plusieurs comptes individuels comme membres. Ces derniers peuvent gérer un ensemble de packages tout en conservant une identité unique pour appropriation. Votre compte individuel vous permet d’être membre de plusieurs organisations.

Un package peut appartenir à un compte d’organisation ou à un compte individuel. Pour les consommateurs de packages, il n’y a aucune différence entre un compte individuel et le compte d’organisation : tous deux sont présentés comme les propriétaires (owners) des packages.

Clés API

Maintenant que vous disposez d’un package NuGet (fichier .nupkg) à publier, publiez-le sur NuGet.org à l’aide de l’interface CLI nuget.exe ou dotnet.exe, avec une clé API acquise sur NuGet.org.

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

Préfixes d’ID

Quand vous publiez des packages, vous pouvez réserver et protéger votre identité en réservant des préfixes d’ID. Durant l’installation d’un package, les consommateurs reçoivent des informations supplémentaires indiquant que les propriétés d’identification du package qu’ils consomment ne sont pas trompeuses.

Point de terminaison d’API pour NuGet.org

Pour utiliser NuGet.org comme dépôt 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, veuillez noter que NuGet clients 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é!)