Installer et gérer des packages dans Visual Studio à l’aide du gestionnaire de package NuGetInstall and manage packages in Visual Studio using the NuGet Package Manager

L’interface utilisateur du gestionnaire de package NuGet dans Visual Studio facilite l’installation, la désinstallation et la mise à jour des packages NuGet dans les projets et solutions.The NuGet Package Manager UI in Visual Studio on Windows allows you to easily install, uninstall, and update NuGet packages in projects and solutions. Pour en faire l’expérience dans Visual Studio pour Mac, consultez Inclusion d’un package NuGet dans votre projet.For the experience in Visual Studio for Mac, see Including a NuGet package in your project. L’interface utilisateur du gestionnaire de package n’est pas incluse dans Visual Studio Code.The Package Manager UI is not included with Visual Studio Code.

Notes

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.If you're missing the NuGet Package Manager in Visual Studio 2015, check Tools > Extensions and Updates... and search for the NuGet Package Manager extension. 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 .If you're unable to use the extensions installer in Visual Studio, download the extension directly from https://dist.nuget.org/index.html.

À compter de Visual Studio 2017, NuGet et le gestionnaire de package NuGet sont automatiquement installés avec toutes les charges de travail liées à .NET.Starting in Visual Studio 2017, NuGet and the NuGet Package Manager are automatically installed with any .NET-related workloads. Installez-les individuellement en sélectionnant l’option Composants individuels > Outils de code > gestionnaire de package NuGet dans le programme d’installation de Visual Studio.Install it individually by selecting the Individual components > Code tools > NuGet package manager option in the Visual Studio installer.

Rechercher et installer un packageFind and install a package

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Références ou sur un projet, puis sélectionnez Gérer les packages NuGet....In Solution Explorer, right-click either References or a project and select Manage NuGet Packages....

    Option de menu Gérer les packages NuGet

  2. L'onglet Parcourir affiche les packages par popularité à partir de la source actuellement sélectionnée (consultez Sources de packages).The Browse tab displays packages by popularity from the currently selected source (see package sources). Recherchez un package spécifique à l’aide de la zone de recherche en haut à gauche.Search for a specific package using the search box on the upper left. Sélectionnez un package dans la liste pour afficher ses informations, ce qui active également le bouton Installer avec une liste déroulante de sélection de version.Select a package from the list to display its information, which also enables the Install button along with a version-selection drop-down.

    Onglet Parcourir la boîte de dialogue Gérer les packages NuGet

  3. Sélectionnez la version souhaitée dans la liste déroulante, puis sélectionnez Installer.Select the desired version from the drop-down and select Install. Visual Studio installe le package et ses dépendances dans le projet.Visual Studio installs the package and its dependencies into the project. Vous pouvez être invité à accepter les termes du contrat de licence.You may be asked to accept license terms. Une fois l’installation terminée, les packages ajoutés s’affichent sous l’onglet installé . Les packages sont également répertoriés dans le nœud références de Explorateur de solutions, ce qui indique que vous pouvez y faire référence dans le projet avec des using instructions.When installation is complete, the added packages appear on the Installed tab. Packages are also listed in the References node of Solution Explorer, indicating that you can refer to them in the project with using statements.

    Références dans l’Explorateur de solutions

Conseil

Pour inclure des versions préliminaires dans la recherche et rendre les versions préliminaires disponibles dans la liste déroulante des versions, sélectionnez l’option Inclure la version préliminaire.To include prerelease versions in the search, and to make prerelease versions available in the version drop-down, select the Include prerelease option.

Notes

NuGet a deux formats dans lesquels un projet peut utiliser des packages : PackageReference et packages.config .NuGet has two formats in which a project may use packages: PackageReference and packages.config. La valeur par défaut peut être définie dans la fenêtre Options de Visual Studio.The default can be set in Visual Studio's options window.

Désinstaller un packageUninstall a package

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Références ou sur le projet souhaité, puis sélectionnez Gérer les packages NuGet....In Solution Explorer, right-click either References or the desired project, and select Manage NuGet Packages....

  2. Sélectionnez l'onglet Installé.Select the Installed tab.

  3. Sélectionnez le package à désinstaller (à l’aide de la recherche pour filtrer la liste si nécessaire) et sélectionnez Désinstaller.Select the package to uninstall (using search to filter the list if necessary) and select Uninstall.

    Désinstallation d’un package

  4. Notez que les contrôles Inclure la version préliminaire et Code source du package n’ont aucun effet lors de la désinstallation des packages.Note that the Include prerelease and Package source controls have no effect when uninstalling packages.

Mettre à jour un packageUpdate a package

  1. Dans Explorateur de solutions, cliquez avec le bouton droit sur références ou sur le projet souhaité, puis sélectionnez gérer les packages NuGet.... (Dans projets de site Web, cliquez avec le bouton droit sur le dossier bin .)In Solution Explorer, right-click either References or the desired project, and select Manage NuGet Packages.... (In web site projects, right-click the Bin folder.)

  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.Select the Updates tab to see packages that have available updates from the selected package sources. Sélectionnez Inclure la version préliminaire pour inclure les packages en version préliminaire dans la liste des mises à jour.Select Include prerelease to include prerelease packages in the update list.

  3. Sélectionnez le package à mettre à jour, la version souhaitée dans la liste déroulante à droite, puis Mettre à jour.Select the package to update, select the desired version from the drop-down on the right, and select Update.

    Mise à jour d'un package

  4. Pour certains packages, le bouton Mise à jour est désactivé et un message s’affiche, indiquant qu’il est « implicitement référencé par un kit de développement logiciel (SDK) » (ou « AutoReferenced »).For some packages, the Update button is disabled and a message appears saying that it's "Implicitly referenced by an SDK" (or "AutoReferenced"). Ce message indique que le package fait partie d’une infrastructure ou d’un kit de développement logiciel (SDK) plus volumineux et ne doit pas être mis à jour de manière indépendante.This message indicates that the package is part of a larger framework or SDK and should not be updated independently. (Ces packages sont marqués en interne avec <IsImplicitlyDefined>True</IsImplicitlyDefined> .) Par exemple, Microsoft.NETCore.App fait partie du kit SDK .net Core, et la version du package n’est pas la même que la version de l’infrastructure runtime utilisée par l’application.(Such packages are internally marked with <IsImplicitlyDefined>True</IsImplicitlyDefined>.) For example, Microsoft.NETCore.App is part of the .NET Core SDK, and the package version is not the same as the version of the runtime framework used by the application. Vous devez mettre à jour votre installation de .NET Core pour bénéficier de nouvelles versions d’ASP.NET Core et de Runtime .NET Core.You need to update your .NET Core installation to get new versions of the ASP.NET Core and .NET Core runtime. Pour plus d’informations sur les métapaquets et le contrôle de version de .NET Core, consultez ce document.See this document for more details on .NET Core metapackages and versioning. Cela s’applique aux packages couramment utilisés suivants :This applies to the following commonly used packages:

    • Microsoft.AspNetCore.AllMicrosoft.AspNetCore.All
    • Microsoft.AspNetCore.AppMicrosoft.AspNetCore.App
    • Microsoft.NETCore.AppMicrosoft.NETCore.App
    • NETStandard.LibraryNETStandard.Library

    Exemple de package marqué comme Implicitement référencé ou AutoReferenced

  5. Pour mettre à jour plusieurs packages vers leurs versions les plus récentes, sélectionnez-les dans la liste, puis sélectionnez le bouton Mettre à jour au-dessus de la liste.To update multiple packages to their newest versions, select them in the list and select the Update button above the list.

  6. Vous pouvez également mettre à jour un package individuel à partir de l’onglet installé . Dans ce cas, les détails du package incluent un sélecteur de version (sous réserve de l’option inclure la version préliminaire ) et un bouton mettre à jour .You can also update an individual package from the Installed tab. In this case, the details for the package include a version selector (subject to the Include prerelease option) and an Update button.

Gérer des packages pour la solutionManage packages for the solution

La gestion des packages pour une solution est un moyen pratique de travailler simultanément sur plusieurs projets.Managing packages for a solution is a convenient means to work with multiple projects simultaneously.

  1. Sélectionnez la commande de menu Outils > Gérer les packages NuGet pour la solution..., ou cliquez avec le bouton droit sur la solution dans l’Explorateur de solutions et sélectionnez Gérer les packages NuGet...  :Select the Tools > NuGet Package Manager > Manage NuGet Packages for Solution... menu command, or right-click the solution and select Manage NuGet Packages...:

    Gérer les packages NuGet pour la solution

  2. 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 :When managing packages for the solution, the UI lets you select the projects that are affected by the operations:

    Sélecteur de projet lors de la gestion de packages pour la solution

Onglet ConsoliderConsolidate tab

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.Developers typically consider it bad practice to use different versions of the same NuGet package across different projects in the same solution. Lorsque vous choisissez de gérer des packages pour une solution, l’interface utilisateur du gestionnaire de package fournit un onglet Consolider sur lequel vous pouvez facilement voir où des packages avec des numéros de version distincts sont utilisés par différents projets dans la solution :When you choose to manage packages for a solution, the Package Manager UI provides a Consolidate tab on which you can easily see where packages with distinct version numbers are used by different projects in the solution:

Onglet Consolider de l’interface utilisateur du gestionnaire de package

Dans cet exemple, le projet ClassLibrary1 utilise EntityFramework 6.2.0, tandis que ConsoleApp1 utilise EntityFramework 6.1.0.In this example, the ClassLibrary1 project is using EntityFramework 6.2.0, whereas ConsoleApp1 is using EntityFramework 6.1.0. Pour consolider les versions de package, procédez comme suit :To consolidate package versions, do the following:

  • Sélectionnez les projets à mettre à jour dans la liste des projets.Select the projects to update in the project list.
  • Sélectionnez la version à utiliser dans tous ces projets dans la commande Version, par exemple, EntityFramework 6.2.0.Select the version to use in all those projects in the Version control, such as EntityFramework 6.2.0.
  • Sélectionnez le bouton Installer.Select the Install button.

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.The Package Manager installs the selected package version into all selected projects, after which the package no longer appears on the Consolidate tab.

Sources de packagesPackage sources

Pour modifier la source à partir de laquelle Visual Studio obtient les packages, sélectionnez-en un dans le sélecteur de source :To change the source from which Visual Studio obtains packages, select one from the source selector:

Sélecteur de source de package dans l’interface utilisateur du gestionnaire de package

Pour gérer les sources de packages :To manage package sources:

  1. Sélectionnez l’icône Paramètres dans l’interface utilisateur du gestionnaire de package présentée ci-dessous, ou utilisez la commande Outils > Options et faites défiler jusqu’au Gestionnaire de package NuGet :Select the Settings icon in the Package Manager UI outlined below or use the Tools > Options command and scroll to NuGet Package Manager:

    Icône des paramètres de l’interface utilisateur du gestionnaire de package

  2. Sélectionnez le nœud Sources du package :Select the Package Sources node:

    Options des sources de packages

  3. Pour ajouter une source, sélectionnez + , modifiez le nom, entrez l’URL ou le chemin d’accès dans le contrôle de code source , puis sélectionnez mettre à jour.To add a source, select +, edit the name, enter the URL or path in the Source control, and select Update. La source apparaît maintenant dans la liste déroulante du sélecteur.The source now appears in the selector drop-down.

  4. Pour modifier une source de package, sélectionnez-la, apportez des modifications aux zones Nom et Source, puis sélectionnez Mettre à jour.To change a package source, select it, make edits in the Name and Source boxes, and select Update.

  5. Pour désactiver une source de package, décochez la case située à gauche de son nom dans la liste.To disable a package source, clear the box to the left of the name in the list.

  6. Pour supprimer une source de package, sélectionnez-la, puis sélectionnez le bouton X.To remove a package source, select it and then select the X button.

  7. L’utilisation des flèches haut et bas ne change pas l’ordre de priorité des sources de packages.Using the up and down arrow buttons does not change the priority order of the package sources. Visual Studio ignore l’ordre des sources de packages et utilise le package provenant de la première source à répondre aux requêtes.Visual Studio ignores the order of package sources, using the package from whichever source is first to respond to requests. Pour plus d'informations, consultez Restauration du package.For more information, see Package restore.

Conseil

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 des fichiers NuGet.Config au niveau de l’ordinateur ou de l’utilisateur.If a package source reappears after deleting it, it may be listed in a computer-level or user-level NuGet.Config files. Consultez Configurations NuGet courantes pour localiser ces fichiers, puis supprimez la source en modifiant les fichiers, manuellement ou à l’aide de la commande Sources nuget.See Common NuGet configurations for the location of these files, then remove the source by editing the files manually or using the nuget sources command.

Contrôle des options du gestionnaire de packagePackage manager Options control

Lorsqu’un package est sélectionné, l’interface utilisateur du gestionnaire de package affiche un contrôle Options de petite taille extensible sous le sélecteur de version (réduit et développé sur l’illustration).When a package is selected, the Package Manager UI displays a small, expandable Options control below the version selector (shown here both collapsed and expanded). Notez que, pour certains types de projets, seule l’option Afficher la fenêtre d’aperçu est disponible.Note that for some project types, only the Show preview window option is provided.

Options du gestionnaire de package

Les sections ci-dessous expliquent ces options.The following sections explain these options.

Afficher la fenêtre d'aperçuShow preview window

Lorsque cette option est sélectionnée, une fenêtre modale affiche les dépendances d’un package choisi avant de l’installer :When selected, a modal window displays which the dependencies of a chosen package before the package is installed:

Exemple de boîte de dialogue d’aperçu

Installer et mettre à jour les optionsInstall and Update Options

(Pas disponible pour tous les types de projets.)(Not available for all project types.)

Comportement de dépendance configure la façon dont NuGet choisit les versions des packages dépendants à installer :Dependency behavior configures how NuGet decides which versions of dependent packages to install:

  • Ignorer les dépendances ignore l’installation de toutes les dépendances, ce qui stoppe généralement l’installation du package.Ignore dependencies skips installing any dependencies, which typically breaks the package being installed.
  • 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.Lowest [Default] installs the dependency with the minimal version number that meets the requirements of the primary chosen package.
  • 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é.Highest Patch installs the version with the same major and minor version numbers, but the highest patch number. 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.For example, if version 1.2.2 is specified then the highest version that starts with 1.2 will be installed
  • 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.Highest Minor installs the version with the same major version number but the highest minor number and patch number. Si la version 1.2.2 est spécifiée, la version la plus élevée commençant par 1 est installée.If version 1.2.2 is specified, then the highest version that starts with 1 will be installed
  • Le plus élevé installe la version disponible la plus élevée du package.Highest installs the highest available version of the package.

Action de conflit de fichiers spécifie comment NuGet doit gérer les packages qui existent déjà dans le projet ou l’ordinateur local :File conflict action specifies how NuGet should handle packages that already exist in the project or local machine:

  • L' invite demande à NuGet de demander s’il faut conserver ou remplacer les packages existants.Prompt instructs NuGet to ask whether to keep or overwrite existing packages.
  • Ignorer tout indique à NuGet de ne pas remplacer les packages existants.Ignore All instructs NuGet to skip overwriting any existing packages.
  • Remplacer tout indique à NuGet de remplacer les packages existants.Overwrite All instructs NuGet to overwrite any existing packages.

Désinstaller les optionsUninstall Options

(Pas disponible pour tous les types de projets.)(Not available for all project types.)

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.Remove dependencies: when selected, removes any dependent packages if they're not referenced elsewhere in the project.

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.Force uninstall even if there are dependencies on it: when selected, uninstalls a package even if it's still being referenced in the project. 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.This is typically used in combination with Remove dependencies to remove a package and whatever dependencies it installed. Toutefois, l’utilisation de cette option peut entraîner des références rompues dans le projet.Using this option may, however, lead to broken references in the project. Dans ce cas, vous devrez peut-être réinstaller ces autres packages.In such cases, you may need to reinstall those other packages.