Installer et gérer des packages NuGet à l’aide de l’interface CLI dotnet

Article
12/22/2023

Vous pouvez utiliser l’outil CLI dotnet sur Windows, macOS ou Linux pour installer, désinstaller et mettre à jour facilement des packages NuGet dans des projets et solutions .NET. Cet article décrit les commandes CLI dotnet les plus courantes pour la gestion des packages NuGet.

L’interface CLI dotnet s’exécute sur des projets de style SDK .NET Standard, .NET Core et .NET, ainsi que sur d’autres projets de style SDK, par exemple ceux qui ciblent .NET Framework. Pour plus d’informations, consultez Kits SDK de projet .NET.

Pour la plupart de ces commandes, l’outil CLI recherche un fichier projet dans le répertoire actif, sauf si vous avez spécifié un fichier projet différent en tant que commutateur facultatif dans la commande. Pour obtenir une liste complète des commandes et de leurs arguments, consultez les commandes de l’interface CLI dotnet.

Prérequis

Le kit SDK .NET Core, qui fournit l’outil en ligne de commande dotnet. À partir de Visual Studio 2017, l’interface CLI dotnet est installée automatiquement avec toutes charges de travail associées à .NET et .NET Core.

Installer ou mettre à jour un package

La commande dotnet add package ajoute une référence de package au fichier projet, puis exécute dotnet restore pour installer le package.

Ouvrez une ligne de commande et accédez au répertoire contenant votre fichier projet.
Utilisez la commande suivante pour installer un package NuGet :
```
dotnet add package <PACKAGE_NAME>
```
Par exemple, pour installer le package Newtonsoft.Json, utilisez cette commande :
```
dotnet add package Newtonsoft.Json
```
Une fois la commande terminée, vous pouvez ouvrir le fichier projet pour voir la référence de package ajoutée.

Par exemple, ouvrez le fichier .csproj pour afficher la référence de package Newtonsoft.Json ajoutée :
```
<ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
</ItemGroup>
```

Installer une version particulière d’un package

La commande dotnet add package installe la dernière version du package sauf si vous spécifiez une version différente.

Pour installer une version spécifique d’un package NuGet, utilisez le commutateur facultatif -v ou --version :

dotnet add package <PACKAGE_NAME> -v <VERSION>

Par exemple, pour ajouter la version 12.0.1 du package Newtonsoft.Json, utilisez cette commande :

dotnet add package Newtonsoft.Json --version 12.0.1

Lister les références de package

Vous pouvez lister les références de package pour votre projet en utilisant la commande dotnet list package :

dotnet list package

Supprimer un package

Utilisez la commande dotnet remove package pour supprimer une référence de package dans le fichier projet.

dotnet remove package <PACKAGE_NAME>

Par exemple, pour supprimer le package Newtonsoft.Json, utilisez la commande suivante :

dotnet remove package Newtonsoft.Json

Restaurer des packages

La commande dotnet restore restaure les packages que les fichier projet référencent comme <PackageReference>. Pour plus d’informations, consultez PackageReference dans les fichiers projet.

Dans .NET Core 2.0 et versions ultérieures, les commandes dotnet build et dotnet run restaurent les packages automatiquement. À partir de NuGet 4.0, dotnet restore exécute le même code que nuget restore.

Pour restaurer un package à l’aide de dotnet restore :

Ouvrez une ligne de commande et accédez au répertoire contenant votre fichier projet.
Exécuter dotnet restore.