Installation des outils clients NuGetInstalling NuGet client tools

Vous souhaitez installer un package ? Voir Méthodes d'installation des packages NuGet.Looking to install a package? See Ways to install NuGet packages.

Pour utiliser NuGet en tant que consommateur ou créateur de packages, vous pouvez utiliser les outils de l’interface de ligne de commande (CLI) ainsi que les fonctionnalités NuGet dans Visual Studio.To work with NuGet, as a package consumer or creator, you can use command-line interface (CLI) tools as well as NuGet features in Visual Studio. Cet article présente brièvement les fonctionnalités des différents outils et explique comment les installer, avec une comparaison de la disponibilité des fonctionnalités.This article briefly outlines the capabilities of the different tools, how to install them, and their comparative feature availability. Pour commencer à utiliser NuGet pour consommer des packages, consultez Installer et utiliser un package (CLI .NET) et Installer et utiliser un package (Visual Studio).To get started using NuGet to consume packages, see Install and use a package (.NET CLI) and Install and use a package (Visual Studio). Pour commencer à créer des packages NuGet, consultez Créer et publier un package NET Standard (interface CLI dotnet) et Créer et publier un package NET Standard (Visual Studio).To get started creating NuGet packages, see Create and publish a NET Standard package (dotnet CLI) and Create and publish a NET Standard package (Visual Studio).

Outil               Tool                DescriptionDescription Télécharger         Download         
dotnet.exedotnet.exe Inclus avec le kit SDK .NET Core et fournit des fonctionnalités NuGet de base sur toutes les plateformes.Included with the .NET Core SDK and provides core NuGet features on all platforms. SDK .NET Core.NET Core SDK
nuget.exenuget.exe Fournit toutes les fonctionnalités NuGet sous Windows et la plupart des fonctionnalités sous Mac et Linux en cas d’exécution sous Mono.Provides all NuGet capabilities on Windows, provides most features on Mac and Linux when running under Mono. nuget.exenuget.exe
Visual StudioVisual Studio Sous Windows, fournit des fonctionnalités NuGet par le biais de l’interface utilisateur et de la console du Gestionnaire de package ; avec des charges de travail liées à .NET.On Windows, provides NuGet capabilities through the Package Manager UI and Package Manager Console; included with .NET-related workloads. Sous Mac, fournit certaines fonctionnalités par le biais de l’interface utilisateur.On Mac, provides certain features through the UI. Dans Visual Studio Code, les fonctionnalités NuGet sont fournies sous la forme d’extensions.In Visual Studio Code, NuGet features are provided through extensions. Visual Studio 2017Visual Studio 2017

L’interface CLI MSBuild offre également la possibilité de restaurer et de créer des packages, ce qui est surtout utile sur les serveurs de build.The MSBuild CLI also provides the ability to restore and create packages, which is primarily useful on build servers. MSBuild n’est pas un outil à usage général pour NuGet.MSBuild is not a general-purpose tool for working with NuGet.

Outils de l’interface CLICLI tools

Les deux outils de l’interface CLI NuGet sont dotnet.exe et nuget.exe.The two NuGet CLI tools are dotnet.exe and nuget.exe. Consultez la disponibilité des fonctionnalités pour obtenir une comparaison.See feature availability for a comparison.

Interface CLI de dotnet.exedotnet.exe CLI

L’interface CLI de .NET Core 2.0, dotnet.exe, qui fonctionne sur toutes les plateformes (Windows, Mac et Linux), fournit des fonctionnalités NuGet de base comme l’installation, la restauration et la publication de packages.The .NET Core 2.0 CLI, dotnet.exe, works on all platforms (Windows, Mac, and Linux) and provides core NuGet features such as installing, restoring, and publishing packages. dotnet assure une intégration directe avec les fichiers projet .NET Core (par exemple, .csproj), ce qui est utile dans la plupart des cas.dotnet provides direct integration with .NET Core project files (such as .csproj), which is helpful in most scenarios. dotnet est également intégré directement pour chaque plateforme et ne nécessite pas l’installation de Mono.dotnet is also built directly for each platform and does not require you to install Mono.

Installation :Installation:

Pour plus d’informations, consultez Outils de l’interface de ligne de commande .NET Core.For more information, see .NET Core command-line interface tools.

Interface CLI de nuget.exenuget.exe CLI

L’interface CLI NuGet, nuget.exe, est l’utilitaire de ligne de commande pour Windows qui offre toutes les fonctionnalités NuGet ; elle peut également s’exécuter sous Mac OS X et Linux à l’aide de Mono, avec certaines limitations.The NuGet CLI, nuget.exe, is the command-line utility for Windows that provides all NuGet capabilities; it can also be run on Mac OSX and Linux using Mono with some limitations. Contrairement à dotnet, l’interface CLI nuget.exe n’affecte pas les fichiers projet et ne met pas à jour packages.config lors de l’installation de packages.Unlike dotnet, the nuget.exe CLI does not affect project files and does not update packages.config when installing packages.

Installation :Installation:

WindowsWindows

  1. Visitez nuget.org/downloads et sélectionnez NuGet 3.3 ou une version ultérieure (2.8.6 n’est pas compatible avec Mono).Visit nuget.org/downloads and select NuGet 3.3 or higher (2.8.6 is not compatible with Mono). La version la plus récente est toujours recommandée, et 4.1.0 ou une version ultérieure est requise pour publier des packages sur nuget.org.The latest version is always recommended, and 4.1.0+ is required to publish packages to nuget.org.
  2. Chaque téléchargement est le fichier nuget.exe directement.Each download is the nuget.exe file directly. Demandez à votre navigateur d’enregistrer le fichier dans un dossier de votre choix.Instruct your browser to save the file to a folder of your choice. Le fichier n’est pas un programme d’installation ; vous ne verrez rien si vous l’exécutez directement à partir du navigateur.The file is not an installer; you won't see anything if you run it directly from the browser.
  3. Ajouter le dossier où vous avez placé nuget.exe à votre variable d’environnement PATH pour utiliser l’outil d’interface CLI à partir de n’importe quel endroit.Add the folder where you placed nuget.exe to your PATH environment variable to use the CLI tool from anywhere.

macOS/LinuxmacOS/Linux

Les comportements peuvent varier légèrement en fonction de la distribution du système d’exploitation.Behaviors may vary slightly by OS distribution.

  1. Installez Mono 4.4.2 ou une version ultérieure.Install Mono 4.4.2 or later.

  2. Tapez la commande suivante à l'invite de l’interpréteur de commandes :Execute the following command at a shell prompt:

    # Download the latest stable `nuget.exe` to `/usr/local/bin`
    sudo curl -o /usr/local/bin/nuget.exe https://dist.nuget.org/win-x86-commandline/latest/nuget.exe
    
  3. Créez un alias en ajoutant le script suivant dans le fichier approprié de votre système d’exploitation (généralement ~/.bash_aliases ou ~/.bash_profile) :Create an alias by adding the following script to the appropriate file for your OS (typically ~/.bash_aliases or ~/.bash_profile):

    # Create as alias for nuget
    alias nuget="mono /usr/local/bin/nuget.exe"
    
  4. Rechargez l’interpréteur de commandes.Reload the shell. Testez l’installation en entrant nuget sans paramètres.Test the installation by entering nuget with no parameters. L’aide de l’interface de ligne de commande NuGet CLI doit s’afficher.NuGet CLI help should display.

Conseil

Utilisez nuget update -self sur Windows pour mettre à jour un nuget.exe existant vers la dernière version.Use nuget update -self on Windows to update an existing nuget.exe to the latest version.

Notes

La dernière interface CLI de NuGet est toujours disponible à l’adresse https://dist.nuget.org/win-x86-commandline/latest/nuget.exe.The latest recommended NuGet CLI is always available at https://dist.nuget.org/win-x86-commandline/latest/nuget.exe. Pour des raisons de compatibilité avec d’anciens systèmes d’intégration continue, une URL précédente, https://nuget.org/nuget.exe, fournit actuellement l’outil CLI 2.8.6 déconseillé.For compatibility purposes with older continuous integration systems, a previous URL, https://nuget.org/nuget.exe currently provides the deprecated 2.8.6 CLI tool.

Visual StudioVisual Studio

  • Code Visual Studio : les fonctionnalités NuGet sont disponibles via des extensions Marketplace, ou vous pouvez utiliser les outils CLI dotnet.exe ou nuget.exe.Visual Studio Code: NuGet capabilities are available through marketplace extensions, or use the dotnet.exe or nuget.exe CLI tools.

  • Visual Studio pour Mac : certaines fonctionnalités NuGet sont intégrées directement.Visual Studio for Mac: certain NuGet capabilities are built in directly. Consultez Inclusion d’un package NuGet dans votre projet pour une procédure pas à pas.See Including a NuGet package in your project for a walkthrough. Pour d’autres fonctionnalités, utilisez les outils CLI dotnet.exe ou nuget.exe.For other capabilities, use the dotnet.exe or nuget.exe CLI tools.

  • Visual Studio sous Windows : Le Gestionnaire de package NuGet est inclus avec Visual Studio 2012 et versions ultérieures.Visual Studio on Windows: The NuGet Package Manager is included with Visual Studio 2012 and later. Le Gestionnaire de package fournit l’interface utilisateur du Gestionnaire de package et la console du Gestionnaire de package, via laquelle vous pouvez exécuter la plupart des opérations NuGet.The Package Manager provides the Package Manager UI and the Package Manager Console, through which you can run most NuGet operations.

    • Le programme d’installation de Visual Studio 2017 inclut le Gestionnaire de package NuGet avec toute charge de travail qui utilise .NET.The Visual Studio 2017 installer includes the NuGet Package Manager with any workload that employs .NET. Pour effectuer une installation séparément, ou pour vérifier que le Gestionnaire de package est installé, exécutez le programme d’installation de Visual Studio 2017 et cochez l’option sous Composants individuels > Outils de code > Gestionnaire de package NuGet.To install separately, or to verify that the Package Manager is installed, run the Visual Studio 2017 installer and check the option under Individual Components > Code tools > NuGet package manager.
    • L’interface utilisateur et la console du Gestionnaire de package sont uniques à Visual Studio sous Windows.The Package Manager UI and Console are unique to Visual Studio on Windows. À l’heure actuelle, elles ne sont pas disponibles dans Visual Studio pour Mac.They are not presently available on Visual Studio for Mac.
    • Visual Studio n’inclut pas automatiquement l’interface CLI nuget.exe, qui doit être installée séparément, comme décrit précédemment.Visual Studio does not automatically include the nuget.exe CLI, which must be installed separately as described earlier.
    • Les commandes de la console du Gestionnaire de package fonctionnent uniquement dans Visual Studio sous Windows et non dans d’autres environnements PowerShell.Package Manager Console commands work only within Visual Studio on Windows and do not work within other PowerShell environments.
    • Pour Visual Studio 2010 et versions antérieures, installez l’extension « NuGet Package Manager for Visual Studio ».For Visual Studio 2010 and earlier, install the "NuGet Package Manager for Visual Studio" extension.
    • Des extensions NuGet pour Visual Studio 2013 et 2015 sont également téléchargeables sur le site https://dist.nuget.org/index.html.NuGet Extensions for Visual Studio 2013 and 2015 can also be downloaded from https://dist.nuget.org/index.html.
    • Si vous souhaitez avoir un aperçu des fonctionnalités NuGet à venir, installez Visual Studio 2017 Preview, qui fonctionne côte à côte avec les versions stables de Visual Studio.If you'd like to preview upcoming NuGet features, install the Visual Studio 2017 Preview, which works side-by-side with stable releases of Visual Studio. Pour signaler des problèmes ou partager des idées concernant les préversions, ouvrez un sujet sur le dépôt GitHub NuGet.To report problems or share ideas for previews, open an issue on the NuGet GitHub repository.

Disponibilité des fonctionnalitésFeature availability

FonctionnalitéFeature Interface CLI dotnetdotnet CLI Interface CLI NuGet (Windows)nuget CLI (Windows) Interface CLI NuGet (Mono)nuget CLI (Mono) Visual Studio (Windows)Visual Studio (Windows) Visual Studio pour MacVisual Studio for Mac
Rechercher des packagesSearch packages
Installer/désinstaller des packagesInstall/uninstall packages ✔(1)✔(1)
Mettre à jour des packagesUpdate packages
Restaurer des packagesRestore packages ✔(2)✔(2)
Gérer des flux de packages (sources)Manage package feeds (sources)
Gérer des packages sur un fluxManage packages on a feed
Définir des clés d’API pour des fluxSet API keys for feeds
Créer des packages(3)Create packages(3) ✔(4)✔(4)
Publier des packagesPublish packages
Répliquer des packagesReplicate packages
Gérer les dossiers global-package et cacheManage global-package and cache folders
Gérer la configuration NuGetManage NuGet configuration

(1) N’affecte pas les fichiers projet ; utilisez dotnet.exe à la place.(1) Does not affect project files; use dotnet.exe instead.

(2) Fonctionne uniquement avec un fichier packages.config et non avec des fichiers (.sln) de solution.(2) Works only with packages.config file and not with solution (.sln) files.

(3) Différentes fonctionnalités de package avancées sont disponibles via l’interface CLI uniquement si elles ne sont pas représentées dans les outils de l’interface utilisateur Visual Studio.(3) Various advanced package features are available through the CLI only as they aren't represented in the Visual Studio UI tools.

(4) Fonctionne avec des fichiers .nuspec, mais pas avec des fichiers projet.(4) Works with .nuspec files but not with project files.

Les développeurs qui utilisent Windows peuvent également explorer NuGet Package Explorer, un outil autonome open source permettant d’explorer, de créer et de modifier des packages NuGet visuellement.Developers working on Windows can also explore the NuGet Package Explorer, an open-source, stand-alone tool to visually explore, create, and edit NuGet packages. Il est très utile, par exemple, pour apporter des modifications expérimentales à une structure de package sans avoir à reconstruire le package.It's very helpful, for example, to make experimental changes to a package structure without rebuilding the package.