Installer les outils client NuGet

  • Article

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

Pour travailler avec NuGet en tant que créateur ou consommateur de package, vous pouvez utiliser les outils de l'interface de ligne de commande (CLI) et les caractéristiques de 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 les articles suivants :

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

Outil Description Télécharger
dotnet SDK L'outil CLI pour les bibliothèques .NET Core et .NET Standard, et pour tout projet de type SDK tel que celui qui cible le .NET Framework. Cet outil CLI est inclus dans le kit SDK .NET Core et fournit les caractéristiques de base de NuGet sur toutes les plateformes. Dans Visual Studio 2017 et les versions ultérieures, la CLI dotnet est automatiquement installée avec toutes les charges de travail liées à .NET Core. Kit de développement logiciel (SDK) .NET Core
nuget.exe L'outil CLI pour les bibliothèques .NET Framework et pour tout projet non-SDK tel que celui qui cible les bibliothèques .NET Standard. Cet outil CLI offre toutes les fonctionnalités de NuGet sous Windows et la plupart des caractéristiques sous Mac et Linux lorsqu'il est exécuté sous Mono. nuget.exe
Visual Studio Sur Windows, le Gestionnaire de package NuGet est inclus avec Visual Studio 2012 et versions ultérieures. Visual Studio sur Windows prend en charge l’IU du Gestionnaire de package et la console du Gestionnaire de package (PowerShell sur Windows). Vous pouvez utiliser ces outils pour exécuter la plupart des opérations NuGet. Visual Studio
Visual Studio pour Mac Sour Mac, certaines fonctionnalités NuGet sont intégrées directement. Gestionnaire de package console n’est pas disponible actuellement. Pour d’autres fonctionnalités, utilisez le SDK dotnet ou les outils CLI nuget.exe. Visual Studio pour Mac
Visual Studio Code Sous Windows, Mac et Linux, les fonctionnalités de NuGet sont disponibles via les extensions de la place de marché, ou en utilisant les outils kit de développement logiciel (SDK) dotnet ou nuget.exe CLI. Visual Studio Code

Remarque

La mise hors service de Visual Studio pour Mac est prévue pour le 31 août 2024, conformément à la stratégie de cycle de vie moderne de Microsoft. Pour plus d’informations, consultez Que devient Visual Studio pour Mac ?.

L’interface CLI MSBuild restaure et crée également des packages. MSBuild n’est pas un outil à usage général pour travailler avec NuGet. Cet outil CLI est principalement utile sur les serveurs de construction.

Les commandes de la console Gestionnaire de package ne fonctionnent que dans Visual Studio sous Windows et ne fonctionnent pas dans les autres environnements PowerShell.

Visual Studio

Dans Visual Studio 2017 et les versions ultérieures, Visual Studio Installer inclut le gestionnaire de package NuGet avec toute charge de travail qui utilise .NET.

Vous pouvez également installer le Gestionnaire de package séparément ou vérifier votre installation. Exécutez le programme Visual Studio Installer et vérifiez l'option sous Composants individuels > Outils de code > Gestionnaire de package NuGet. Pour plus d’informations, consultez Installer et gérer des packages dans Visual Studio à l’aide du gestionnaire de package NuGet.

Remarque

Pour les versions antérieures de Visual Studio, vous pouvez télécharger des extensions NuGet à https://dist.nuget.org/index.html.

Outils CLI

Vous pouvez utiliser le dotnet CLI ou le CLI nuget.exe pour prendre en charge les caractéristiques NuGet dans l’IDE Visual Studio. Le dotnet CLI est installé 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. Pour obtenir une comparaison des caractéristiques des outils, consultez la section disponibilité des caractéristiques.

  • Pour cibler .NET Core ou .NET Standard, utilisez l'outil CLI du kit de développement logiciel (SDK) dotnet. Cette CLI est nécessaire pour le format de projet de type SDK, qui utilise l'attribut SDK.

  • Pour cibler .NET Framework (projet non-SDK-style uniquement), utilisez l’outil CLI nuget.exe. Si le projet est migré de packages.config vers PackageReference, utilisez plutôt l'outil CLI du kit de développement logiciel (SDK) dotnet.

dotnet SDK

Le dotnet SDK est l'outil CLI .NET Core 2.0, qui fonctionne sur toutes les plateformes (Windows, Mac et Linux) et fournit les caractéristiques principales de NuGet telles que l'installation, la restauration et la publication de packages. Le dotnet CLI fournit une intégration directe avec les fichiers projet .NET Core (par exemple .csproj), ce qui est utile dans la plupart des scénarios. Cette CLI est également générée directement pour chaque plateforme et ne nécessite pas l'installation de Mono.

Installer le kit de développement logiciel (SDK) dotnet

Pour apprendre à utiliser les commandes de base de l'outil CLI du kit de développement logiciel (SDK) dotnet, consultez Installer et gérer les paquets NuGet avec l'outil CLI dotnet.

CLI nuget.exe

La CLI NuGet, nuget.exe, est l'utilitaire de ligne de commande pour Windows qui offre toutes les caractéristiques de NuGet. Cette CLI peut également fonctionner sur Mac OSX et Linux en utilisant Mono avec certaines limitations.

Pour savoir comment utiliser les commandes de base avec l’outil CLI nuget.exe, consultez Gérer les packages NuGet avec le CLI nuget.exe.

Installer nuget.exe

Installez toujours la dernière version de l’outil qui prend en charge votre configuration.

  • Vous pouvez télécharger la dernière version recommandée à l’adresse https://dist.nuget.org/win-x86-commandline/latest/nuget.exe.
  • Si l'outil CLI nuget.exe est déjà installé, vous pouvez le mettre à jour avec la dernière version à l'aide de la commande nuget update -self.
  • Pour des raisons de compatibilité avec les anciens systèmes d'intégration continue, une URL antérieure, https://nuget.org/nuget.exe fournit actuellement la version déconseillé 2.8.6 de l'outil CLI.

  1. Visitez nuget.org/téléchargements et téléchargez NuGet version 3.3 ou ultérieure.

    • La version 5.0 et ultérieure nécessite .NET Framework version 4.7.2 ou ultérieure.
    • La version 4.1.0 et ultérieure est requise pour publier des packages sur nuget.org.
    • La version 2.8.6 n’est pas compatible avec Mono.

  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 de téléchargement n'est pas un programme d'installation, vous ne verrez donc rien si vous exécutez le fichier directement à partir du navigateur.

  3. Pour utiliser l'outil CLI de n'importe où, ajoutez l'emplacement du dossier du fichier nuget.exe à votre variable d'environnement PATH.

Disponibilité des fonctionnalités

Le tableau suivant compare les caractéristiques disponibles pour les outils dotnet et nuget.exe CLI pour les plates-formes prises en charge.

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

Notes de caractéristique

  • (1) N’affecte pas les fichiers projet. Utilisez plutôt l'outil CLI du kit de développement logiciel (SDK) dotnet.
  • (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 obtenir une préversion des prochaines caractéristiques de NuGet, installez 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 travaillant sur Windows peuvent également explorer l’Explorateur de packages NuGet. Cette application est un outil autonome open source qui vous permet d’explorer visuellement, de créer et de modifier des packages NuGet. Il est utile dans de nombreux cas, par exemple pour apporter des modifications expérimentales à la structure d'un package sans le regénérer.