Installer et gérer des packages dans Visual Studio à l’aide du gestionnaire de package NuGet

  • Article

L’interface utilisateur du Gestionnaire de package NuGet dans Microsoft Visual Studio pour Windows vous permet d’installer, désinstaller et mettre à jour facilement des packages NuGet dans des projets et des solutions.

L’article concerne uniquement les utilisateurs Windows. Si vous utilisez Visual Studio pour Mac, consultez Inclure un package NuGet dans votre projet.

Prérequis

  • Installez Visual Studio 2022 pour Windows avec n’importe quel . Charge de travail liée au RÉSEAU.

    Vous pouvez installer l’édition Community 2022 gratuitement à partir de visualstudio.microsoft.com, ou utiliser l’édition Professionnel ou Entreprise.

    Visual Studio 2017 et versions ultérieures inclut automatiquement le Gestionnaire de package NuGet quand un . La charge de travail liée à NET est installée. Pour l’installer individuellement dans Visual Studio Installer, sélectionnez l’onglet Composants individuels, puis sélectionnez le gestionnaire de package NuGet sous Outils de code.

    Pour Visual Studio 2015, si vous manquez le Gestionnaire de package NuGet, vérifiez les extensions d’outils>et Mises à jour et recherchez l’extension Gestionnaire de package NuGet. Si vous ne pouvez pas utiliser le programme d’installation des extensions dans Visual Studio, téléchargez l'extension directement à partir de https://dist.nuget.org/index.html.

  • Créez un compte gratuit sur nuget.org si vous n’avez pas encore de compte. Vous devez inscrire et confirmer le compte avant de pouvoir charger un package NuGet.

Rechercher et installer un package

Pour rechercher et installer un package NuGet avec Visual Studio, procédez comme suit :

  1. Chargez un projet dans Explorateur de solutions, puis sélectionnez Project>Manage NuGet Packages.

    La fenêtre du gestionnaire de package NuGet s’ouvre.

  2. Sélectionnez l’onglet Parcourir pour afficher les packages à partir de la source actuellement sélectionnée (voir sources de package). Pour rechercher un package spécifique, utilisez la zone de recherche en haut à gauche. Sélectionnez un package dans la liste pour afficher ses informations dans le volet droit, ce qui vous permet de sélectionner une version à installer.

    Capture d’écran montrant la fenêtre Gestionnaire de package NuGet avec l’onglet Parcourir sélectionné.

  3. Dans le volet droit, sélectionnez une version dans la liste déroulante. Si vous souhaitez inclure des versions préliminaires dans la liste version , sélectionnez Inclure la préversion.

  4. Pour installer le package NuGet, sélectionnez Installer. Vous êtes peut-être invité à accepter les termes du contrat de licence ou à vérifier l’installation.

    Visual Studio installe le package et ses dépendances dans le projet. Une fois l’installation terminée, les packages ajoutés apparaissent sous l’onglet Installé. Vous pouvez également trouver des packages dans le nœud Packages de dépendances> de votre projet dans Explorateur de solutions. Une fois que vous avez installé un package, vous pouvez y faire référence dans le projet avec une using instruction.

  5. (Facultatif) NuGet a deux formats dans lesquels un projet peut utiliser des packages : PackageReference et packages.config. Pour définir le format par défaut, sélectionnez Options d’outils>, développez Le Gestionnaire de package NuGet, sélectionnez Général, puis choisissez le format de gestion des packages par défaut. Pour plus d’informations, consultez Choisir le format de gestion des packages par défaut.

Désinstaller un package

Pour désinstaller un package NuGet, procédez comme suit :

  1. Chargez un projet dans Explorateur de solutions, sélectionnez Project>Manage NuGet Packages, puis sélectionnez l’onglet Installé.

  2. Sélectionnez le package à désinstaller dans le volet gauche (utilisez la zone de recherche pour le trouver, si nécessaire), puis sélectionnez Désinstaller dans le volet droit.

    Capture d’écran montrant le Gestionnaire de package NuGet avec un package sélectionné et son bouton Désinstaller mis en surbrillance.

Mettre à jour un package

Pour mettre à jour un package NuGet, procédez comme suit :

  1. Chargez un projet dans Explorateur de solutions, puis sélectionnez Project>Manage NuGet Packages. Pour les projets de site web, sélectionnez d’abord le dossier Bin .

  2. Sélectionnez l’onglet Mises à jour pour afficher les packages qui ont des mises à jour disponibles à partir de la source de package sélectionnée. Sélectionnez Inclure la version préliminaire pour inclure les packages en version préliminaire dans la liste des mises à jour.

  3. Sélectionnez le package à mettre à jour. Dans le volet droit, sélectionnez la version souhaitée dans la liste déroulante, puis sélectionnez Mettre à jour.

    Capture d’écran montrant le Gestionnaire de package NuGet avec un package sélectionné et son bouton Mise à jour mis en surbrillance.

  4. Pour certains packages, le bouton Mettre à jour est désactivé et le message suivant s’affiche : référencé implicitement par un KIT DE développement logiciel (SDK). Pour mettre à jour le package, mettez à jour le Kit de développement logiciel (SDK) auquel il appartient. Ce message indique que le package fait partie d’une infrastructure ou d’un Kit de développement logiciel (SDK) plus volumineux et ne peut pas être mis à jour indépendamment. Ces packages sont marqués en interne avec <IsImplicitlyDefined>True</IsImplicitlyDefined>. Par exemple, fait partie du Kit de développement logiciel (SDK) Microsoft.NETCore.App .NET Core, et la version du package est différente de la version du framework d’exécution utilisé par l’application. Pour télécharger une nouvelle version du .NET Core, mettez à jour votre installation .NET Core. Pour plus d’informations, consultez les métapackages et le contrôle de version .NET Core. Ce scénario s’applique aux packages couramment utilisés suivants :

    • Microsoft.AspNetCore.All
    • Microsoft.AspNetCore.App
    • Microsoft.NETCore.App
    • NETStandard.Library

    Capture d’écran montrant un package NuGet avec le bouton Mettre à jour désactivé.

  5. Pour mettre à jour plusieurs packages vers leurs dernières versions, choisissez-les dans la liste des packages NuGet, puis sélectionnez Mettre à jour.

  6. Vous pouvez également mettre à jour un package individuel sous l’onglet Installé . Pour ce cas, vous pouvez également sélectionner une version et l’option Inclure une préversion .

Gérer des packages pour la solution

La gestion des packages pour une solution est un moyen pratique de travailler avec plusieurs projets simultanément :

  1. Sélectionnez une solution dans le Gestionnaire de solutions, puis sélectionnez Tools>NuGet Package Manager>Manage NuGet Packages for Solution.

  2. Dans la fenêtre Gérer les packages NuGet pour la solution , sélectionnez les projets affectés par les opérations.

    Capture d’écran montrant la fenêtre Gérer les packages pour la solution avec plusieurs projets sélectionnés.

Onglet Consolider

Les développeurs considèrent généralement qu’il est déconseillé d’utiliser différentes versions du même package NuGet dans différents projets de la même solution. Visual Studio vous permet d’utiliser une version commune pour vos packages NuGet. Pour ce faire, utilisez l’onglet Consolider de la fenêtre Gestionnaire de package NuGet pour découvrir où les packages avec des numéros de version distincts sont utilisés par différents projets dans la solution.

Capture d’écran montrant la fenêtre Gérer les packages pour la solution avec l’onglet Consolider sélectionné.

Dans cet exemple, le projet ClassLibrary1 utilise EntityFramework 6.2.0, tandis que ConsoleApp1 utilise EntityFramework 6.1.0. Pour consolider les versions du package, procédez comme suit :

  1. Sous l’onglet Consolider , sélectionnez les projets à mettre à jour dans la liste des projets.

  2. Sélectionnez la version à utiliser pour tous ces projets dans la liste Version .

  3. Sélectionnez Installer.

    Le Gestionnaire de package NuGet installe la version du package sélectionnée dans tous les projets sélectionnés, après lequel le package n’apparaît plus sous l’onglet Consolider .

Sources de packages

Visual Studio ignore l’ordre des sources de package et utilise le package à partir duquel la source est la première à répondre à une requête. Pour plus d’informations, consultez Restaurer des packages. Pour plus d’informations sur la façon de charger un package à partir d’une source spécifique, consultez Mappage de source de package.

Pour gérer les sources de package NuGet, procédez comme suit :

  1. Pour modifier la source à partir de laquelle Visual Studio charge les métadonnées du package, sélectionnez une source dans le sélecteur source de package .

    Capture d’écran montrant le sélecteur source de package mis en surbrillance.

  2. Pour gérer vos sources de package, sélectionnez l’icône Paramètres ou sélectionnez Options d’outils>.

    Capture d’écran montrant l’icône paramètres source du package mise en surbrillance.

  3. Dans la fenêtre Options , développez le nœud Gestionnaire de package NuGet et sélectionnez Sources de package.

    Capture d’écran montrant la fenêtre Options avec les sources de package sélectionnées.

  4. Pour ajouter une source, sélectionnez +, modifiez le nom, entrez l’URL ou le chemin d’accès dans la source, puis sélectionnez Mettre à jour.

    La source apparaît maintenant dans la liste déroulante source du package .

  5. Pour modifier une source de package, sélectionnez-la, apportez des modifications aux zones Nom et Source, puis sélectionnez Mettre à jour.

  6. Pour désactiver une source de package, décochez la case située à gauche de son nom dans la liste.

  7. Pour supprimer une source de package, sélectionnez-la, puis sélectionnez le bouton X .

    Si une source de package réapparaît après sa suppression, elle peut être répertoriée dans un fichier deNuGet.config au niveau de l’ordinateur ou au niveau de l’utilisateur. Pour obtenir l’emplacement de ces fichiers, consultez configurations NuGet courantes. Supprimez la source du package dans les fichiers en les modifiant manuellement ou à l’aide de la commande sources nuget.

Contrôle Options du Gestionnaire de package NuGet

Lorsque vous sélectionnez un package, le Gestionnaire de package NuGet affiche un contrôle Options extensible sous le sélecteur de version . Pour la plupart des types de projet, seule l’option Afficher la fenêtre d’aperçu est fournie.

Capture d’écran montrant le contrôle Options du gestionnaire de package NuGet développé.

Les sections suivantes expliquent les options disponibles.

Options d’installation et de mise à jour

Ces options sont disponibles uniquement pour certains types de projet :

  • Comportement de dépendance : cette option configure la façon dont NuGet détermine les versions des packages dépendants à installer. Il a les paramètres suivants :

    • Ignorer les dépendances ignore l’installation des dépendances, ce qui interrompt généralement l’installation du package.
    • Le plus bas [par défaut] installe la dépendance avec le numéro de version minimal qui répond aux exigences du package principal choisi.
    • Correctif le plus élevé installe la version avec les mêmes numéros de version majeur et mineur, mais le numéro de correctif le plus élevé. Par exemple, si la version 1.2.2 est spécifiée, la version la plus élevée commençant par 1.2 est installée.
    • Mineur le plus élevé installe la version avec le même numéro de version majeur, mais les numéros mineur et de correctif les plus élevés. Si la version 1.2.2 est spécifiée, la version la plus élevée commençant par 1 est installée.
    • Le plus élevé installe la version disponible la plus élevée du package.

  • Action de conflit de fichier : cette option spécifie comment NuGet doit gérer les packages qui existent déjà dans le projet ou l’ordinateur local. Il a les paramètres suivants :

    • L' invite demande à NuGet de demander s’il faut conserver ou remplacer les packages existants.
    • Ignorer tout indique à NuGet de ne pas remplacer les packages existants.
    • Remplacer tout indique à NuGet de remplacer les packages existants.

Options de désinstallation

Ces options sont disponibles uniquement pour certains types de projet :

  • Supprimer les dépendances : lorsque cette option est sélectionnée, supprime tous les packages dépendants s’ils ne sont pas référencés ailleurs dans le projet.

  • Forcez la désinstallation même s’il existe des dépendances : lorsqu’il est sélectionné, désinstalle un package même s’il est toujours référencé dans le projet. Cette option est généralement utilisée en combinaison avec les dépendances Supprimer pour supprimer un package et les dépendances qu’il a installées. Toutefois, l’utilisation de cette option peut entraîner des références rompues dans le projet. Dans ce cas, vous devrez peut-être réinstaller ces autres packages.

Voir aussi

Pour plus d’informations sur NuGet, consultez les articles suivants :