Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
NuGet.org est le référentiel de package public pour .NET qui permet aux développeurs de partager du code réutilisable. Un package NuGet est un fichier compressé avec une .nupkg extension qui contient du code compilé et des métadonnées associées que vous pouvez réutiliser dans d’autres projets. Lorsque vous publiez votre package sur NuGet.org, vous le rendez disponible pour les développeurs dans le monde entier.
Conditions préalables
| Produit | Exigences |
|---|---|
|
-
Visual Studio avec une charge de travail .NET. - Le plus récent SDK .NET. |
|
| NuGet.org | - Un compte de NuGet.org gratuit |
Création d’un projet
Vous pouvez utiliser un projet .NET existant pour compiler et générer un package NuGet, ou créer un projet de bibliothèque de classes pour ce didacticiel :
Dans Visual Studio, sélectionnez Fichier>Nouveau>Projet.
Sélectionnez le modèle bibliothèque de classes , puis sélectionnez Suivant.
Entrez un nom pour votre projet et votre solution, choisissez un dossier local, puis sélectionnez Suivant.
Sélectionnez votre infrastructure, puis créez une fois que vous êtes prêt.
Le modèle de bibliothèque de classes par défaut est suffisant pour créer un package NuGet. Ce didacticiel utilise donc le projet généré sans apporter de modifications de code.
Configurer et générer un package
Dans Explorateur de solutions, cliquez avec le bouton droit sur votre projet, puis sélectionnez Properties>Package.
Entrez les détails de votre package et vérifiez que votre ID de package est unique afin qu’il ne soit pas en conflit avec les packages existants sur NuGet.org. Un modèle de nommage courant est
Company.Product.Feature. Pour générer le package chaque fois que vous générez le projet, sélectionnez Générer le package NuGet à la build.Dans Explorateur de solutions, cliquez avec le bouton droit sur votre projet, puis sélectionnez Pack pour générer le fichier
.nupkg.Vérifiez l’état de la commande pack dans la fenêtre de sortie.
Générer une clé d’API
Maintenant que vous avez créé votre .nupkg package, générez une clé API pour pouvoir la publier sur NuGet.org.
Connectez-vous à votre compte NuGet.org ou créez-en un si ce n’est pas le cas.
Sélectionnez l’icône de votre utilisateur, puis sélectionnez Clés API.
Sélectionnez Créer, entrez un nom pour la clé, définissez l’étendue pour envoyer de nouveaux packages et versions de package, puis entrez
*dans le modèle glob pour autoriser tous les packages. Lorsque vous avez terminé, sélectionnez Créer.
Sélectionnez Copier et stockez la clé API dans un emplacement sécurisé. Vous utilisez cette clé lorsque vous publiez le package.
Publier un package sur NuGet.org
Vous pouvez publier votre package à l’aide de l’interface utilisateur web NuGet.org, de l’interface cli dotnet ou de nuget.exe. Ce tutoriel utilise l’interface CLI dotnet. Pour publier, vous avez besoin du nom du fichier de package, de votre clé API et de l’URL source NuGet.org.
Dans une fenêtre d’invite de commandes, accédez au dossier qui contient votre
.nupkgfichier.Exécutez la commande suivante pour publier le package sur NuGet.org. Remplacez les espaces réservés par le nom de fichier de package et la clé API.
dotnet nuget push <packageName> --api-key <APIKey> --source https://api.nuget.org/v3/index.jsonVérifiez que la sortie de la commande indique que le package a été envoyé avec succès.
