Partager via

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.

Conditions préalables

  • Installez Visual Studio 2022 pour Windows avec n’importe quelle charge de travail liée à .NET.

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

    Visual Studio 2017 et versions ultérieures incluent automatiquement le Gestionnaire de packages NuGet lorsqu'une 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 gestionnaire de package NuGet sous Outils code.

    Pour Visual Studio 2015, si vous manquez le Gestionnaire de package NuGet, vérifiez Tools>extensions et mises à jour et recherchez l’extension Gestionnaire de package NuGet. Si vous ne parvenez 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.

  • Inscrivez-vous pour un compte gratuit sur nuget.org si vous n’en avez pas déjà un. 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 Projet>Gérer les packages NuGet.

    La fenêtre du gestionnaire de packages 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 package).

    • Pour rechercher un package spécifique, utilisez la zone de recherche en haut à gauche.
    • Les informations abrégées peuvent s’afficher à côté de chaque ID de package pour vous aider à identifier le package approprié et varient en fonction de la ou des sources de package sélectionnées. Les exemples incluent le nombre de téléchargements de forfaits, des liens vers le profil de l'auteur ou du propriétaire.

    Note

    Dans Visual Studio 17.11 et versions ultérieures, les package owners sont affichés sous forme de liens hypertexte de profil lorsque supportés par la source de package sélectionnée. La propriété du package est définie par la source du package. Par exemple, voir gérer les propriétaires de packages sur nuget.org.

    Dans Visual Studio 17.10 et versions antérieures, les métadonnées de l'auteur pour le package s'affichent sous forme de texte brut. Pour plus d’informations, consultez les métadonnées du package Authors.

    • Sélectionnez un package pour afficher des informations détaillées sur le package. Le volet d’informations à droite s’affiche et vous permet de sélectionner une version à installer. Capture d’écran montrant la fenêtre Gestionnaire de package NuGet avec l’onglet Parcourir, le volet Détails et l’onglet « Détails du package » sélectionnés. Vous pouvez voir les métadonnées du package, les informations sur les propriétaires, les auteurs, les licences, etc., dans l’onglet Détails du package et le fichier README du package (s’il est fourni par l’auteur du package) sous l’onglet README. Capture d’écran montrant la fenêtre Gestionnaire de package NuGet avec l’onglet README sélectionné.

  3. Dans le volet droit, sélectionnez une Version à partir de 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 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 apparaissent 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, développez du Gestionnaire de package NuGet, sélectionnez Général, puis 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, procédez comme suit :

  1. Chargez un projet dans Explorateur de solutions, sélectionnez Project>Gérer les packages NuGet, puis sélectionnez l’onglet Installé.

  2. Sélectionnez le package à désinstaller dans le volet gauche (utilisez la zone Rechercher pour la 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 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 qui ont des mises à jour disponibles à partir de la source de package sélectionnée. Sélectionnez Inclure la préversion pour inclure des paquets de préversion dans la liste de mises à jour.

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

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

  4. Pour certains packages, le bouton Mettre à jour est désactivé et le message suivant s’affiche : implicitement référencé 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, Microsoft.NETCore.App fait partie du Kit de développement logiciel (SDK) .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 de .NET Core, mettre à jour votre installation .NET Core. Pour plus d’informations, consultez métapackages .NET Core et le contrôle de version. 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 à partir de l’onglet Installé. Dans ce cas, vous pouvez également sélectionner une version et l’option inclure la préversion.

Gérer les packages pour la solution

La gestion des packages pour une solution est un moyen pratique d’utiliser plusieurs projets simultanément :

  1. Sélectionnez une solution dans gestionnaire de solutions, puis sélectionnez Tools>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.

    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 incorrect 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 du Gestionnaire de package NuGet fenêtre 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 de package, procédez comme suit :

  1. Dans 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 de package sélectionnée dans tous les projets sélectionnés, après quoi le package n’apparaît plus sous l’onglet Consolider.

Sources de paquets

Visual Studio ignore l’ordre des sources de package et utilise le package à partir duquel la source est la première à répondre à une demande. 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 paquet, sélectionnez une source à partir du sélecteur de source de package .

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

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

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

  3. Dans la fenêtre options de , développez le nœud gestionnaire de package NuGet, puis 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 source, puis sélectionnez Mettre à jour.

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

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

  6. Pour désactiver une source de package, désactivez la zone à gauche du 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 de NuGet.config au niveau de l’ordinateur ou au niveau 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 sources nuget.

Options de contrôle du Gestionnaire de packages NuGet

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

Capture d’écran montrant le contrôle des Options du gestionnaire de paquets NuGet déroulé.

Les sections suivantes expliquent les options disponibles.

Options d’installation et de mise à jour

Ces options sont disponibles uniquement pour certains types de projets :

  • 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.
    • plus bas [Valeur 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 majeure et mineure, mais le plus haut numéro de correctif. Par exemple, si la version 1.2.2 est spécifiée, la version la plus élevée commençant par la version 1.2 sera installée.
    • mineure la plus élevée installe la version avec le même numéro de version principal, mais le numéro secondaire et le numéro de correctif le plus élevé. Si la version 1.2.2 est spécifiée, la version la plus élevée commençant par 1 est installée
    • plus haut installe la version la plus haute disponible du package.

  • action de conflit de fichiers: 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 s'il faut conserver ou remplacer les paquets existants.
    • Ignorer toutes les indique à NuGet d’ignorer l’écriture des packages existants.
    • Écraser tous indique à NuGet de remplacer les packages existants.

Options de désinstallation

Ces options sont disponibles uniquement pour certains types de projets :

  • Supprimer les dépendances: lorsqu’ils sont sélectionnés, supprime les packages dépendants s’ils ne sont pas référencés ailleurs dans le projet.

  • Forcer la désinstallation, même s’il existe des dépendances sur celle-ci: 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 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 brisées 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 :