Installer les outils clients NuGet

  • Article
  • 7 minutes de lecture

Vous souhaitez installer un package ? Consultez Méthodes d’installation des packages NuGet.

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. 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.

Pour commencer à utiliser NuGet pour consommer des packages, consultez :

Pour commencer à créer des packages NuGet, consultez :

Outil Description Téléchargement
dotnet.exe Outil CLI pour les bibliothèques .NET Core et .NET Standard et tout projet de style SDK comme celui ciblant le .NET Framework. Inclus avec le kit SDK .NET Core et fournit des fonctionnalités NuGet de base sur toutes les plateformes. (À compter de Visual Studio 2017, la CLI dotnet est installée automatiquement avec les charges de travail associées à NET Core.) Kit de développement logiciel (SDK) .NET Core
nuget.exe Outil CLI pour les bibliothèques .NET Framework et tous les projets non-SDK-style comme celui ciblant les bibliothèques .NET Standard. 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. nuget.exe
Visual Studio Sur Windows, le Gestionnaire de package NuGet est inclus dans Visual Studio 2012 et versions ultérieures. Visual Studio fournit l’interface utilisateur du Gestionnaire de package et la console du Gestionnaire de package pour vous permettre d’exécuter la plupart des opérations NuGet. Visual Studio
Visual Studio pour Mac Sur Mac, certaines fonctionnalités NuGet sont intégrées directement. La console du Gestionnaire de package n’est actuellement pas disponible. Pour d’autres fonctionnalités, utilisez les outils CLI dotnet.exe ou nuget.exe. Visual Studio pour Mac
Visual Studio Code Sur Windows, Mac ou Linux, les fonctionnalités NuGet sont disponibles via les extensions de la Place de marché ou utilisent les dotnet.exe outils CLI ou nuget.exe . Visual Studio Code

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. MSBuild n’est pas un outil à usage général pour NuGet.

Les commandes de la console du Gestionnaire de package fonctionnent uniquement dans Visual Studio sous Windows et non dans d’autres environnements PowerShell.

Visual Studio

Installer sur Visual Studio 2017 et versions ultérieures

À compter de Visual Studio 2017, le programme d’installation inclut le Gestionnaire de package NuGet avec toute charge de travail utilisant .NET. Pour installer séparément ou pour vérifier que le Gestionnaire de package est installé, exécutez le programme d’installation de Visual Studio et cochez l’option sous Gestionnaire de package NuGet des outils > de code des composants > individuels.

Installer sur Visual Studio 2015 et versions antérieures

Les extensions NuGet pour Visual Studio 2013 et 2015 peuvent être téléchargées à partir de https://dist.nuget.org/index.html.

Pour Visual Studio 2010 et versions antérieures, installez l’extension « NuGet Package Manager for Visual Studio ». Notez que si vous ne voyez pas l’extension dans la première page des résultats de la recherche, essayez de modifier la liste déroulante Trier par en « Plupart des téléchargements » ou un tri alphabétique.

Outils CLI

Vous pouvez utiliser l’interface dotnet CLI ou l’interface CLI pour prendre en charge les nuget.exe fonctionnalités NuGet dans l’IDE. L’interface CLI dotnet est installée avec certaines charges de travail Visual Studio, comme .NET Core. L’interface CLI nuget.exe doit être installée séparément, comme décrit précédemment.

Les deux outils de l’interface CLI NuGet sont dotnet.exe et nuget.exe. Consultez la disponibilité des fonctionnalités pour obtenir une comparaison.

  • Pour cibler .NET Core ou .NET Standard, utilisez l’interface CLI dotnet. L’interface CLI dotnet est requise pour le format de projet SDK-style, qui utilise l’attribut SDK.
  • Pour cibler .NET Framework (projet non-SDK-style uniquement), utilisez l’interface CLI nuget.exe. Si le projet est migré de packages.config vers PackageReference, utilisez la CLI dotnet.

Interface CLI de dotnet.exe

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. 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 est également intégré directement pour chaque plateforme et ne nécessite pas l’installation de Mono.

Installation :

Pour savoir comment utiliser les commandes de base avec l’interface CLI dotnet, consultez Installer et utiliser des packages à l’aide de l’interface CLI dotnet.

Interface CLI de nuget.exe

L’interface CLI nuget.exe, 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.

Pour savoir comment utiliser les commandes de base avec l’interface CLI nuget.exe, consultez Installer et utiliser des packages à l’aide de l’interface CLI nuget.exe.

Installation :

Windows

Notes

NuGet.exe 5.0 et les versions ultérieures exigent .NET Framework 4.7.2 ou une version ultérieure pour s’exécuter.

  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). 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.
  2. Chaque téléchargement est le fichier nuget.exe directement. Demandez à votre navigateur d’enregistrer le fichier dans un dossier de votre choix. Le fichier n’est pas un programme d’installation ; vous ne verrez rien si vous l’exécutez directement à partir du navigateur.
  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.

macOS/Linux

Les comportements peuvent varier légèrement en fonction de la distribution du système d’exploitation.

  1. Installez Mono 4.4.2 ou une version ultérieure.

  2. Tapez la commande suivante à l'invite de l’interpréteur de commandes :

    # 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 as alias for nuget
alias nuget="mono /usr/local/bin/nuget.exe"

  4. Rechargez l’interpréteur de commandes. Testez l’installation en entrant nuget sans paramètres. L’aide de l’interface de ligne de commande NuGet CLI doit s’afficher.

Conseil

Utilisez nuget update -self sur Windows pour mettre à jour un nuget.exe existant vers la dernière version.

Remarque

La dernière interface CLI de NuGet est toujours disponible à l’adresse https://dist.nuget.org/win-x86-commandline/latest/nuget.exe. À des fins de compatibilité avec les anciens systèmes d’intégration continue, une URL https://nuget.org/nuget.exe précédente fournit actuellement l’outil CLI 2.8.6 déprécié.

Disponibilité des fonctionnalités

Fonctionnalité Interface CLI dotnet Interface CLI NuGet (Windows) Interface CLI NuGet (Mono) Visual Studio (Windows) Visual Studio pour Mac
Rechercher des packages ✔ ✔ ✔ ✔
Installer/désinstaller des packages ✔ ✔ (1) ✔ ✔ ✔
Mettre à jour des packages ✔ ✔ ✔ ✔
Restaurer des packages ✔ ✔ ✔ (2) ✔ ✔
Gérer des flux de packages (sources) ✔ ✔ ✔ ✔
Gérer des packages sur un flux ✔ ✔ ✔
Définir des clés d’API pour des flux ✔ ✔
Créer des packages(3) ✔ ✔ ✔ (4) ✔
Publier des packages ✔ ✔ ✔ ✔
Répliquer des packages ✔ ✔
Gérer les dossiers global-package et cache ✔ ✔ ✔
Gérer la configuration NuGet ✔ ✔

(1) N’affecte pas les fichiers projet ; utilisez dotnet.exe à la place.

(2) Fonctionne uniquement avec un fichier packages.config et non avec des fichiers (.sln) de solution.

(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.

(4) Fonctionne avec des fichiers .nuspec, mais pas avec des fichiers projet.

Fonctionnalités à venir

Si vous souhaitez afficher un aperçu des fonctionnalités NuGet à venir, installez un Visual Studio Preview, qui fonctionne côte à côte avec les versions stables de 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.

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. Il est très utile, par exemple, pour apporter des modifications expérimentales à une structure de package sans avoir à reconstruire le package.