Installer et gérer des packages NuGet dans Visual Studio pour Mac
S’applique à :
Visual Studio pour Mac 
Visual Studio
L’interface utilisateur du Gestionnaire de package NuGet dans Visual Studio pour Mac vous permet d’installer, désinstaller et mettre à jour facilement des packages NuGet dans des projets et des solutions. Vous pouvez rechercher et ajouter des packages à vos projets .NET Core, ASP.NET Core et Xamarin.
Cet article explique comment inclure un package NuGet dans un projet. De plus, il présente la chaîne d’outils qui permet d’exécuter le processus sans interruption.
Pour obtenir une introduction à l’utilisation de NuGet dans Visual Studio pour Mac, consultez Démarrage rapide : Installer et utiliser un package dans Visual Studio pour Mac
Rechercher et installer un package
Avec un projet ouvert dans Visual Studio pour Mac, cliquez avec le bouton droit sur le dossier Dépendances (dossier Packages si vous utilisez un projet Xamarin) dans la fenêtre solution et sélectionnez Gérer les packages NuGet....
La boîte de dialogue Gérer les packages NuGet s’affiche. Vérifiez que la liste déroulante source du package dans le coin inférieur gauche de la boîte de dialogue est définie
nuget.orgsur , de sorte que vous recherchez le référentiel de package NuGet central.
Utilisez la zone de recherche dans le coin supérieur droit pour rechercher un package spécifique, par exemple
EntityFramework. Lorsque vous avez trouvé un package que vous souhaitez utiliser, sélectionnez-le et sélectionnez le bouton Ajouter un package pour commencer l’installation.
Une fois le package téléchargé, il sera ajouté à votre projet. La solution change en fonction du type de projet que vous modifiez :
Projets Xamarin
- Le nœud Références contient une liste de tous les assemblys qui font partie d’un package NuGet.
- Le nœud Packages affiche chaque package NuGet que vous avez téléchargé. Vous pouvez mettre à jour ou supprimer un package dans cette liste.
Projets .NET Core
- Le nœud NuGet dépendances > affiche chaque package NuGet que vous avez téléchargé. Vous pouvez mettre à jour ou supprimer un package dans cette liste.
Utilisation de packages NuGet
Une fois le package NuGet ajouté et les références du projet mises à jour, vous pouvez programmer en utilisant les API comme vous le feriez avec n’importe quelle référence de projet.
Veillez à ajouter les directives using nécessaires en haut de votre fichier :
using Newtonsoft.Json;
Mise à jour des packages
Les mises à jour de package peuvent être effectuées à la fois, en cliquant avec le bouton droit sur le nœud Dépendances (nœud Packages pour les projets Xamarin), ou individuellement sur chaque package. Lorsqu’une nouvelle version d’un package NuGet est disponible, une icône de mise à jour s’affiche 
.
Cliquez avec le bouton droit sur Dépendances pour accéder au menu contextuel et choisissez Mettre à jour pour mettre à jour tous les packages :
- Gérer les packages NuGet : ouvre la fenêtre pour ajouter d’autres packages au projet.
- Mettre à jour : recherche les versions les plus récentes des packages sur le serveur source et les télécharge.
- Restaurer : télécharge les packages manquants (sans mettre à jour les packages existants vers leur version la plus récente).
Les options de mise à jour et de restauration sont également disponibles au niveau de la solution et affectent tous les projets de la solution.
Mise à jour vers les versions préliminaires des packages
Pour effectuer une mise à jour vers une version préliminaire plus récente d’un package, vous pouvez cliquer avec le bouton droit sur Dépendances pour ouvrir le menu contextuel et choisir le menu Gérer les packages NuGet...
Cochez la case Inclure les préréleases en bas de la boîte de dialogue.
Enfin, sous l’onglet Mises à jour de la boîte de dialogue, sélectionnez le package que vous souhaitez mettre à jour et choisissez la nouvelle version de préversion dans la liste déroulante Nouvelle version , puis sélectionnez Mettre à jour le package.
Localisation des packages obsolètes
À partir de la fenêtre solution , vous pouvez afficher la version d’un package actuellement installée. Cliquez avec le bouton droit sur le package à mettre à jour.
Vous verrez également une notification en regard du nom du package lorsqu’une nouvelle version d’un package est disponible. Vous pouvez décider si vous souhaiterez peut-être le mettre à jour.
Dans le menu affiché, vous avez deux options :
- Mettre à jour : recherche une version plus récente sur le serveur source et si elle existe, la télécharge.
- Supprimer : supprime le package de ce projet et supprime les assemblys concernés des références du projet.
Gérer des packages pour la solution
La gestion des packages pour une solution est un moyen pratique de travailler simultanément sur plusieurs projets.
Cliquez avec le bouton droit sur la solution et sélectionnez Gérer les packages NuGet...:
Lorsque vous gérez des packages pour la solution, l’interface utilisateur vous permet de sélectionner les projets affectés par les opérations :
Onglet Consolider
Lorsque vous travaillez dans une solution avec plusieurs projets, assurez-vous que n’importe où vous utilisez le même package NuGet dans chaque projet, vous utilisez également le même numéro de version de ce package. Visual Studio pour Mac facilite la gestion des packages pour une solution en fournissant un onglet Consolider dans l’interface utilisateur du Gestionnaire de packages. À l’aide de l’onglet Consolider , vous pouvez facilement voir où les packages avec des numéros de version distincts sont utilisés par différents projets dans la solution :
Dans cet exemple, le projet NuGetDemo utilise Microsoft.EntityFrameworkCore 3.1.23, tandis que NuGetDemo.Shared utilise Microsoft.EntityFrameworkCore 5.0.2. Pour consolider les versions du package, procédez comme suit :
- Sélectionnez les projets à mettre à jour dans la liste des projets.
- Sélectionnez la version à utiliser dans tous ces projets dans la liste Nouvelle version , par exemple Microsoft.EntityFrameworkCore 6.0.3.
- Sélectionnez le bouton Consolider le package .
Le gestionnaire de package installe la version de package sélectionnée dans tous les projets sélectionnés, après quoi le package ne s'affiche plus sous l’onglet Consolider.
Ajout de sources de packages
Les packages disponibles pour l’installation sont initialement récupérés à partir de nuget.org. Toutefois, vous pouvez ajouter d’autres emplacements de package à Visual Studio pour Mac. Il est utile de tester vos propres packages NuGet en cours de développement ou d’utiliser un serveur NuGet privé à l’intérieur de votre entreprise ou organisation.
Dans Visual Studio pour Mac, accédez aux sources NuGet > des préférences > Visual Studio > pour afficher et modifier la liste des sources de package. Les sources peuvent être un serveur distant (spécifié par une URL) ou un répertoire local.
Sélectionnez Ajouter pour configurer une nouvelle source. Entrez un nom convivial et un emplacement (l’URL ou le chemin d’accès du fichier) à la source du package. Si la source est un serveur web sécurisé, entrez également le nom d’utilisateur et le mot de passe , sinon laissez ces entrées vides :
Vous pouvez sélectionner différentes sources lors de la recherche de packages :
Gestion de version
La documentation de NuGet traite de l’utilisation de NuGet sans validation des packages auprès de contrôle de code source. Si vous préférez ne pas stocker les fichiers binaires et les informations non utilisées dans le contrôle de code source, vous pouvez configurer Visual Studio pour Mac pour restaurer automatiquement les packages à partir du serveur. Lorsqu’un développeur récupère le projet à partir du contrôle de code source pour la première fois, Visual Studio pour Mac télécharge et installe automatiquement les packages requis.
Pour plus d’informations sur la façon d’exclure le répertoire packages du suivi, consultez la documentation spécifique à votre contrôle de code source.