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

  • Article

L’IU du gestionnaire de package NuGet dans Microsoft Visual Studio pour Windows facilite l’installation, la désinstallation et la mise à jour des packages NuGet dans les projets et solutions.

Cet article concerne uniquement les utilisateurs Windows. Si vous utilisez Visual Studio pour Mac, consultez Inclusion de package NuGet dans votre projet.

Prérequis

  • Installez Visual Studio 2022 pour Windows avec une charge de travail associée à .NET.

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

    Visual Studio 2017 et les versions ultérieures intègrent automatiquement le gestionnaire de package NuGet lorsqu’une charge de travail en rapport avec .NET est installée. Pour les installer individuellement dans Visual Studio Installer, sélectionnez l’onglet Composants individuels, puis sélectionnez Gestionnaire de package NuGet sous Outils de code .

    Si vous n’avez pas le gestionnaire de package NuGet dans Visual Studio 2015, consultez Outils> Extensions 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 créer et confirmer le compte avant de pouvoir charger un package NuGet.

Rechercher et installer un package

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

  1. Chargez un projet dans Explorateur de solutions, puis sélectionnez Projet>Gérer les packages NuGet.

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

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

    Screenshot showing the NuGet Package Manager window with the Browse tab selected.

  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 de versions, sélectionnez Inclure les préversions.

  4. Pour installer le package NuGet, sélectionner Installer. Vous serez 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 s’affichent sous l’onglet Installé. Vous pouvez également trouver des packages dans le nœud Dépendances>Packages de votre projet dans Explorateur de solutions. Après avoir installé un package, vous pouvez y faire référence dans le projet avec une instruction using.

  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 Outils>Options, puis développez Gestionnaire de package NuGet et sélectionnez Général, enfin choisissez le Format de gestion de package par défaut. Pour plus d’informations, consultez Choisir le format de gestion de package par défaut.

Désinstaller un package

Pour désinstaller un package NuGet, effectuez les étapes suivantes :

  1. Chargez un projet dans Explorateur de solutions, puis sélectionnez Projet>Gérer les packages NuGet, et enfin 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.

    Screenshot showing the NuGet Package Manager with a package selected and its Uninstall button highlighted.

Mettre à jour un package

Pour mettre à jour un package NuGet, effectuez les étapes suivantes :

  1. Chargez un projet dans Explorateur de solutions, puis sélectionnez Projet>Gérer les packages NuGet. Pour les projets de site web, sélectionnez d’abord le dossier Bin.

  2. Sélectionnez l'onglet Mises à jour pour afficher les packages pour lesquels des mises à jour sont disponibles à partir des sources de package sélectionnées. 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 pour le mettre à jour. Dans le volet droit, sélectionnez la version souhaitée dans la liste déroulante, puis sélectionnez Mettre à jour.

    Screenshot showing the NuGet Package Manager with a package selected and its Update button highlighted.

  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’un framework ou d’un kit SDK plus volumineux et qu’il ne peut pas être mis à jour indépendamment. Ces packages sont marqués par <IsImplicitlyDefined>True</IsImplicitlyDefined> en interne. Par exemple, Microsoft.NETCore.App fait partie du kit SDK .net Core et la version du package est différente de celle du framework du runtime utilisée par l’application. Pour télécharger une nouvelle version du .NET Core, mettez à jour votre installation .NET Core. Pour plus d’informations, consultez Métapaquets et contrôle de version .NET Core. Ce scénario aux packages couramment utilisés suivants :

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

    Screenshot showing a NuGet package with the Update button disabled.

  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 à partir de l’onglet Installé. Dans ce cas, vous pouvez également sélectionner une version et cocher 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 sur plusieurs projets en même temps :

  1. Sélectionnez une solution dans le Gestionnaire de solutions, puis sélectionnez Outils>Gestionnaire de package NuGet>Gérer les packages NuGet pour la solution.

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

    Screenshot showing the Manage Packages for Solution window with multiple projects selected.

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 à tous les packages NuGet. Pour ce faire, utilisez l’onglet Consolider de la fenêtre du Gestionnaire de package NuGet pour découvrir où sont utilisés les packages avec des numéros de version distincts par les projets dans la solution.

Screenshot showing the Manage Packages for Solution window with the Consolidate tab selected.

Dans cet exemple, le projet ClassLibrary1 utilise EntityFramework 6.2.0, tandis que ConsoleApp1 utilise EntityFramework 6.1.0. Pour regrouper les versions de package, suivez les étapes ci-dessous :

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

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

  3. Sélectionnez Installer.

    Le gestionnaire de package NuGet installe la version de package sélectionnée dans tous les projets sélectionnés. Ensuite, le package ne s'affiche plus sous l’onglet Consolider.

Sources de packages

Visual Studio ignore l’ordre des sources de packages et utilise le package provenant de la première source à répondre à une requête. Pour plus d'informations, consultez Restauration du package. 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 packages de métadonnées, sélectionnez une source dans le sélecteur de package source.

    Screenshot showing the Package source selector highlighted.

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

    Screenshot showing the Package source settings icon highlighted.

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

    Screenshot showing the Options window with Package Sources selected.

  4. Pour ajouter une source, sélectionnez +, modifiez-en le Nom, saisissez l’URL ou le chemin d’accès dans Source et enfin 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 avoir été supprimée, c’est qu’elle est peut-être répertoriée dans un fichier NuGet.config au niveau de l’ordinateur ou de l’utilisateur. Pour connaître l’emplacement de ces fichiers, consultez Configurations NuGet courantes. Supprimez la source du package dans les fichiers en les modifiant manuellement ou en utilisant la commande nuget source.

Contrôle des options du gestionnaire de package NuGet

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

Screenshot showing the NuGet Package manager Options control expanded.

Les sections ci-dessous expliquent les options disponibles.

Options d’installation et de mise à jour

Ces options sont uniquement disponibles pour certains types de projets :

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

    • Ignorer les dépendances ignore l’installation des dépendances, ce qui stoppe 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 fichiers : cette option spécifie la manière dont NuGet doit gérer les packages qui existent déjà dans le projet ou sur l’ordinateur local. Il présente 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.

Option de désinstallation

Ces options sont uniquement disponibles pour certains types de projets :

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

  • Forcer la désinstallation même s’il y a des dépendances sur celle-ci : lorsque cette option est sélectionnée, un package est désinstallé même s’il est toujours référencé dans le projet. Cette option est généralement utilisée en liaison avec Supprimer les dépendances 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, voir les articles suivants :