Installer et gérer des packages NuGet avec l’interface CLI dotnet

Vous pouvez utiliser l’outil d’interface de ligne de commande dotnet (CLI) sur Windows, macOS ou Linux pour installer, désinstaller et mettre à jour facilement les packages NuGet dans .NET projets et solutions. 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 .NET, .NET Core, .NET projets de style SDK Standard et tous les autres projets de style SDK, par exemple ceux qui ciblent .NET Framework. Consultez les SDKs de projet .NET pour plus d'informations.

Pour la plupart des commandes, l’outil CLI recherche un fichier projet dans le répertoire actif, sauf si un autre fichier projet est spécifié comme commutateur facultatif dans la commande. Pour obtenir la liste complète des commandes et de leurs arguments, consultez les commandes CLI dotnet.

Prerequisites

Kit de développement logiciel (SDK) .NET, qui fournit l’interface CLI dotnet. Dans Visual Studio, l’interface CLI dotnet s’installe automatiquement avec toutes les charges de travail associées à .NET.

Installer ou mettre à jour un package

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

  1. Ouvrez une fenêtre de ligne de commande et accédez au répertoire qui contient votre fichier projet.

  2. Utilisez la commande suivante pour installer un package NuGet :

    dotnet package add <package-name>

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

    dotnet package add Newtonsoft.Json

    Si vous utilisez .NET 9 ou une version antérieure, utilisez la première forme de verbe de la commande à la place :

    dotnet add package <package-name>

  3. Une fois la commande terminée, ouvrez le fichier projet pour rechercher la référence du package.

    Par exemple, ouvrez le fichier .csproj et recherchez la référence de package ajoutée Newtonsoft.Json :

    <ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.4" />
</ItemGroup>

Installer une version particulière d’un package

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

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

dotnet package add <package-name> -v <version>

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

dotnet package add Newtonsoft.Json --version 13.0.1

Répertorier les références de package

Vous pouvez utiliser la commande dotnet package list pour répertorier les références et versions du package pour votre projet. Dans le répertoire qui contient votre fichier projet, exécutez la commande suivante :

dotnet package list

Si vous utilisez .NET 9 ou une version antérieure, utilisez plutôt la forme avec le verbe en premier :

dotnet list package

Supprimer un package

Vous pouvez utiliser la commande dotnet package remove pour supprimer une référence de package du fichier projet. Dans le répertoire qui contient votre fichier projet, exécutez la commande suivante :

dotnet package remove <package-name>

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

dotnet package remove Newtonsoft.Json

Si vous utilisez .NET 9 ou une version antérieure, utilisez plutôt la forme avec le verbe en premier :

dotnet remove package <package-name>

Restaurer des packages

La dotnet restore commande restaure les packages répertoriés dans <PackageReference> les éléments du fichier projet. Pour plus d’informations, consultez PackageReference les fichiers projet.

À partir de .NET Core 2.0 et en continuant avec .NET, les commandes dotnet build et dotnet run restaurent automatiquement les packages, tout comme de nombreuses autres commandes dotnet CLI. À partir de NuGet 4.0, dotnet restore exécute le même code que la nuget restore commande CLI NuGet.

Pour restaurer des packages à l’aide de dotnet restore:

  1. Ouvrez une fenêtre de ligne de commande et accédez au répertoire qui contient votre fichier projet.
  2. Exécutez dotnet restore.

Contenu connexe

  • Last updated on