Installer les outils client NuGet

Vous souhaitez installer un package ? Consultez Les méthodes d’installation d’un package NuGet.

Pour utiliser NuGet en tant que consommateur ou créateur de package, vous pouvez utiliser des outils d’interface de ligne de commande (CLI) et des fonctionnalités NuGet dans Visual Studio. Cet article présente brièvement les fonctionnalités des différents outils. Il explique également comment les installer et comparer la disponibilité des fonctionnalités entre les outils.

Démarrages rapides NuGet

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

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

Vue d’ensemble des outils

Outil Description Télécharger
Kit de développement logiciel (SDK) dotnet L’outil CLI pour les bibliothèques .NET et .NET Standard, ainsi que pour tout projet de style SDK tel qu’un qui cible l’infrastructure .NET. Cet outil CLI est inclus dans le sdk .NET et fournit des fonctionnalités NuGet principales sur toutes les plateformes. Dans Visual Studio 2017 et versions ultérieures, l’interface CLI dotnet est automatiquement installée avec toutes les charges de travail liées aux .NET. Kit de développement logiciel (SDK) .NET
nuget.exe L’outil CLI pour les bibliothèques .NET Framework et pour n’importe quel projet de style non-SDK comme celui qui cible .NET bibliothèques Standard. Cet outil CLI fournit toutes les fonctionnalités NuGet sur Windows et la plupart des fonctionnalités sur macOS et Linux lors de l’exécution sous Mono. nuget.exe
Visual Studio Un environnement de développement intégré à part entière (IDE) intégrant le gestionnaire de packages NuGet. Visual Studio fournit l’interface utilisateur Package Manager et la console Package Manager (PowerShell sur Windows). Vous pouvez utiliser ces outils pour exécuter la plupart des opérations NuGet. Visual Studio
Visual Studio Code Éditeur de code open source léger pour Windows, macOS et Linux qui offre des fonctionnalités NuGet via des extensions de la Place de marché. Vous pouvez également utiliser le Kit de développement logiciel (SDK) dotnet ou les outils CLI nuget.exe à partir de Visual Studio Code. Visual Studio Code

Vous pouvez également utiliser l’interface CLI Microsoft Build Engine (MSBuild) pour restaurer et créer des packages. Mais MSBuild n’est pas un outil à usage général pour l’utilisation de NuGet. Cet outil CLI est principalement utile sur les serveurs de build.

Package Manager commandes console fonctionnent uniquement dans Visual Studio sur Windows et ne fonctionnent pas dans d'autres environnements PowerShell.

Stratégie de support

Pour la politique de support de Visual Studio pour Windows, consultez Cycle de vie et maintenance des produits Visual Studio.

La version nuget.exe la plus récente est entièrement prise en charge et peut être utilisée de manière fiable pour les correctifs de bogues, les mises à jour et les améliorations. Pour plus d’informations sur la stratégie de nuget.exe support, consultez Politique de cycle de vie moderne.

Pour la stratégie de support .NET SDK, consultez la stratégie de support de .NET et .NET Core.

Mises à jour correctives

Les versions corrigées de nuget.exe sont publiées exclusivement lorsque des correctifs de sécurité critiques sont requis pour une version de support à long terme (LTS) de Visual Studio ou du KIT de développement logiciel (SDK) .NET.

Tous les bogues de sécurité doivent être signalés à la Microsoft Security Response Center (MSRC) à la page de rapport MSRC. Pour plus d’informations sur la création de rapports sur les problèmes de sécurité, consultez la stratégie de sécurité dans le référentiel NuGet.Client.

NuGet.exe désinscrit la liste

Les versions obsolètes, déconseillées ou vulnérables nuget.exe sont supprimées du tools.json point de terminaison.

Visual Studio

Dans Visual Studio 2017 et versions ultérieures, le programme d’installation de Visual Studio inclut le Package Manager NuGet avec toute charge de travail qui utilise .NET.

Vous pouvez également installer le Package Manager séparément ou vérifier votre installation. Exécutez le programme d’installation Visual Studio et cochez le paramètre d’option sous les composants individuels>Outils de code>NuGet package manager. Pour plus d’informations, consultez Installer et gérer des packages dans Visual Studio à l’aide du Package Manager< NuGet/c0>.

Outils CLI

Vous pouvez utiliser l’interface CLI dotnet ou l’interface CLI nuget.exe pour prendre en charge les fonctionnalités NuGet dans le Visual Studio IDE. L’interface CLI dotnet est installée avec certaines charges de travail Visual Studio, telles que .NET. L’interface nuget.exe CLI doit être installée séparément, comme décrit précédemment. Pour obtenir une comparaison des fonctionnalités des outils, consultez la section Disponibilité des fonctionnalités .

  • Pour cibler .NET ou .NET Standard, utilisez l’outil CLI du SDK dotnet. Cette interface CLI est requise pour le format de projet de style SDK, qui utilise l’attributSDK.

  • Pour cibler .NET Framework (projets de style non SDK uniquement), utilisez l’outil CLI nuget.exe. Si le projet est migré du packages.config format vers PackageReference, utilisez l’outil CLI du SDK dotnet à la place.

Kit de développement logiciel (SDK) dotnet

Le Kit de développement logiciel (SDK) dotnet est l’outil CLI .NET. Il fonctionne sur toutes les plateformes (Windows, macOS et Linux) et fournit des fonctionnalités NuGet principales telles que l’installation, la restauration et la publication de packages. L’interface CLI dotnet fournit une intégration directe avec des fichiers projet .NET, tels que .csproj fichiers, ce qui est utile dans la plupart des scénarios. Cette interface CLI est également générée directement pour chaque plateforme et ne nécessite pas d’installation de Mono.

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

Pour savoir comment utiliser des commandes de base avec l’outil CLI du Kit de développement logiciel (SDK) dotnet, consultez Installer et gérer des packages NuGet avec l’interface CLI dotnet.

interface CLI nuget.exe

L’interface CLI NuGet, nuget.exe, est l’utilitaire de ligne de commande pour Windows qui fournit toutes les fonctionnalités NuGet. Cette interface CLI peut également s’exécuter sur macOS et Linux à l’aide de Mono avec certaines limitations.

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

Installer nuget.exe

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

Si l’outil nuget.exe CLI est déjà installé, vous pouvez mettre à jour l’outil vers la dernière version à l’aide de la commande nuget update -self.

  1. Télécharger nuget.exe:

  2. Lorsque vous y êtes invité, enregistrez le fichier dans un dossier de votre choix. Le fichier nuget.exe est téléchargé directement. Le fichier téléchargé n’est pas un programme d’installation. Il n’est donc pas nécessaire d’exécuter le fichier directement à partir du navigateur.

  3. Pour utiliser l’outil CLI à partir de n’importe quel dossier, ajoutez le dossier qui contient le fichier nuget.exe à votre PATH variable d’environnement.

Disponibilité des fonctionnalités

Le tableau suivant compare les fonctionnalités disponibles pour l’interface CLI dotnet, nuget.exe CLI et les outils de Visual Studio pour les plateformes prises en charge.

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

Notes de fonctionnalité :

  • (1) L’utilisation de cette fonctionnalité n’affecte pas les fichiers projet. Utilisez plutôt l’outil CLI dotnet SDK.
  • (2) Cette fonctionnalité fonctionne uniquement avec les fichiers packages.config et non avec les fichiers solution (.sln ou .slnx).
  • (3) Différentes fonctionnalités de package avancées sont disponibles via l'interface CLI uniquement, car elles ne sont pas représentées dans les outils d'interface utilisateur Visual Studio.
  • (4) Cette fonctionnalité fonctionne avec les fichiers .nuspec , mais pas avec les fichiers projet.

Fonctionnalités à venir

Si vous souhaitez afficher un aperçu des fonctionnalités NuGet à venir, installez la version du canal Insiders de Visual Studio, qui fonctionne côte à côte avec les versions stables de Visual Studio. Pour signaler des problèmes ou partager des idées pour les préversions, ouvrez un problème sur le dépôt NuGet GitHub.

Contenu connexe

Les développeurs qui travaillent sur Windows peuvent également explorer l’Explorateur de packages NuGet. Cette application est un outil autonome open source que vous pouvez utiliser pour explorer visuellement, créer et modifier des packages NuGet. Il est utile pour de nombreux scénarios, tels que la modification expérimentale d'une structure de paquet sans reconstruire le paquet.

  • Last updated on