Vue d’ensemble de CLI .NET

Article
02/25/2023

Cet article s’applique à : ✔️ SDK .NET Core 2.1 et versions ultérieures

L’interface de ligne de commande (CLI) de .NET est une nouvelle chaîne d’outils multiplateformes pour développer, générer, exécuter et publier des applications .NET.

L’interface CLI .NET est incluse avec le kit SDK .NET. Pour découvrir comment installer le kit SDK .NET, consultez Installer .NET Core.

Commandes CLI

Les commandes suivantes sont installées par défaut :

Commandes de base

Commandes de modification de projet

Commandes avancées

Commandes de gestion des outils

tool install
tool list
tool update
tool restore Disponible depuis le kit SDK .NET Core 3.0.
tool run Disponible depuis le kit SDK .NET Core 3.0.
tool uninstall

Les outils sont des applications console installées à partir de packages NuGet et appelées à partir de l’invite de commandes. Vous pouvez écrire vous-même des outils ou installer des outils écrits par des tiers. Les outils sont également appelés outils globaux, outils de chemin d’outils et outils locaux. Pour plus d’informations, consultez Vue d’ensemble des outils .NET.

Structure de commande

La structure de commande CLI se compose du pilote (« dotnet »), de la commande et éventuellement des arguments et options de la commande. Ce modèle apparaît dans la plupart des opérations de l’interface CLI, notamment la création d’une application console et son exécution à partir de la ligne de commande, comme le montrent les commandes suivantes, exécutées à partir d’un répertoire nommé my_app :

dotnet new console
dotnet build --output ./build_output
dotnet ./build_output/my_app.dll

Pilote

Le pilote s’intitule dotnet et gère deux tâches : l’exécution d’une application dépendant du framework ou l’exécution d’une commande.

Pour exécuter une application dépendant du framework, spécifiez l’application après le pilote, par exemple dotnet /path/to/my_app.dll. Lors de l’exécution de la commande à partir du dossier où se trouve la DLL de l’application, vous devez simplement exécuter dotnet my_app.dll. Si vous souhaitez utiliser une version spécifique du runtime .NET, utilisez l’option --fx-version <VERSION> (voir la référence commande dotnet).

Lorsque vous fournissez une commande au pilote, dotnet.exe démarre le processus d’exécution de la commande CLI. Par exemple :

dotnet build

D’abord, le pilote détermine la version du kit SDK à utiliser. En l’absence d’un fichier global.json, la dernière version du kit SDK disponible est utilisée. Il s’agit peut-être d’une préversion ou d’une version stable, selon la plus récente qui se trouve sur l’ordinateur. Une fois que la version du SDK est déterminée, elle exécute la commande.

Commande

La commande exécute une action. Par exemple, dotnet build génère le code. dotnet publish publie le code. Les commandes sont implémentées comme une application console à l’aide d’une convention dotnet {command}.

Arguments

Les arguments que vous passez sur la ligne de commande sont les arguments de la commande appelée. Par exemple, quand vous exécutez dotnet publish my_app.csproj, l’argument my_app.csproj indique le projet à publier et est transmis à la commande publish.

Options

Les options que vous passez sur la ligne de commande sont les options de la commande appelée. Par exemple, quand vous exécutez dotnet publish --output /build_output, l’option --output et sa valeur sont passées à la commande publish.

Partage via