Outils de l’interface de ligne de commande (CLI) de .NET Core.NET Core command-line interface (CLI) tools

L’interface de ligne de commande (CLI) de .NET Core est une nouvelle chaîne d’outils multiplateforme pour le développement d’applications .NET.The .NET Core command-line interface (CLI) is a new cross-platform toolchain for developing .NET applications. CLI est une fondation sur laquelle les autres outils de niveau supérieur, tels que les environnements de développement intégré (IDE), les éditeurs et les orchestrateurs de builds, peuvent se baser.The CLI is a foundation upon which higher-level tools, such as Integrated Development Environments (IDEs), editors, and build orchestrators, can rest.

InstallationInstallation

Utilisez les programmes d’installation natifs ou les scripts shell d’installation :Either use the native installers or use the installation shell scripts:

  • Les programmes d’installation natifs sont principalement utilisés sur les ordinateurs des développeurs et s’appuient sur le mécanisme d’installation natif de chaque plateforme prise en charge, par exemple des packages DEB sur Ubuntu ou des ensembles MSI sur Windows.The native installers are primarily used on developer's machines and use each supported platform's native install mechanism, for instance, DEB packages on Ubuntu or MSI bundles on Windows. Ces programmes d’installation installent et configurent l’environnement pour une utilisation immédiate par le développeur, mais requièrent des privilèges d’administrateur sur l’ordinateur.These installers install and configure the environment for immediate use by the developer but require administrative privileges on the machine. Vous pouvez consulter les instructions d’installation dans le guide d’installation de .NET Core.You can view the installation instructions in the .NET Core installation guide.
  • Les scripts de shell servent principalement à configurer les serveurs de builds et permettent d’installer les outils sans privilèges d’administration.Shell scripts are primarily used for setting up build servers or when you wish to install the tools without administrative privileges. Les scripts d’installation n’installent pas les composants requis sur l’ordinateur, qui doivent être installés manuellement.Install scripts don't install prerequisites on the machine, which must be installed manually. Pour plus d’informations, consultez la rubrique de référence sur les scripts d’installation.For more information, see the install script reference topic. Pour plus d’informations sur la configuration de l’interface CLI sur votre serveur de builds avec intégration continue (CI), consultez Utilisation du SDK et des outils .NET Core avec l’intégration continue.For information on how to set up CLI on your continuous integration (CI) build server, see Using .NET Core SDK and tools in Continuous Integration (CI).

Par défaut, l’interface CLI s’installe en parallèle (SxS) et plusieurs versions des outils CLI peuvent donc coexister sur un même ordinateur.By default, the CLI installs in a side-by-side (SxS) manner, so multiple versions of the CLI tools can coexist on a single machine. La méthode permettant d’identifier la version utilisée sur un ordinateur sur lequel plusieurs versions sont installées est expliquée plus en détail dans la section Pilote.Determining which version is used on a machine where multiple versions are installed is explained in more detail in the Driver section.

Commandes CLICLI commands

Les commandes suivantes sont installées par défaut :The following commands are installed by default:

L’interface CLI adopte un modèle d’extensibilité qui vous permet de spécifier des outils supplémentaires pour vos projets.The CLI adopts an extensibility model that allows you to specify additional tools for your projects. Pour plus d’informations, consultez la rubrique Modèle d’extensibilité des outils CLI .NET Core.For more information, see the .NET Core CLI extensibility model topic.

Structure de commandeCommand structure

La structure de commande CLI se compose du pilote (« dotnet »), de la commande (« verbe ») et éventuellement des arguments et options de la commande.CLI command structure consists of the driver ("dotnet"), the command (or "verb"), and possibly command arguments and options. 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 :You see this pattern in most CLI operations, such as creating a new console app and running it from the command line as the following commands show when executed from a directory named my_app:

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

PiloteDriver

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.The driver is named dotnet and has two responsibilities, either running a framework-dependent app or executing a command. La seule fois où dotnet est utilisé sans commande est lorsqu’il est utilisé pour démarrer une application.The only time dotnet is used without a command is when it's used to start an application.

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.To run a framework-dependent app, specify the app after the driver, for example, 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.When executing the command from the folder where the app's DLL resides, simply execute dotnet my_app.dll.

Lorsque vous fournissez une commande au pilote, dotnet.exe démarre le processus d’exécution de la commande CLI.When you supply a command to the driver, dotnet.exe starts the CLI command execution process. D’abord, le pilote détermine la version du kit SDK à utiliser.First, the driver determines the version of the SDK to use. Si la version n’est pas spécifiée dans les options de la commande, le pilote utilise la dernière version disponible.If the version isn't specified in the command options, the driver uses the latest version available. Pour spécifier une version autre que la dernière version installée, utilisez l’option --fx-version <VERSION> (voir la référence de la commande dotnet).To specify a version other than the latest installed version, use the --fx-version <VERSION> option (see the dotnet command reference). Une fois que la version SDK est déterminée, le pilote exécute la commande.Once the SDK version is determined, the driver executes the command.

Commande (« verbe »)Command ("verb")

La commande (ou « verbe ») est une commande qui exécute une action.The command (or "verb") is simply a command that performs an action. Par exemple, dotnet build génère votre code.For example, dotnet build builds your code. dotnet publish publie le code.dotnet publish publishes your code. Les commandes sont implémentées comme une application console à l’aide d’une convention dotnet {verb}.The commands are implemented as a console application using a dotnet {verb} convention.

ArgumentsArguments

Les arguments que vous passez sur la ligne de commande sont les arguments de la commande appelée.The arguments you pass on the command line are the arguments to the command invoked. Par exemple, lorsque vous exécutez dotnet publish my_app.csproj, l’argument my_app.csproj indique le projet à publier et est transmis à la commande publish.For example when you execute dotnet publish my_app.csproj, the my_app.csproj argument indicates the project to publish and is passed to the publish command.

OptionsOptions

Les options que vous passez sur la ligne de commande sont les options de la commande appelée.The options you pass on the command line are the options to the command invoked. Par exemple, lorsque vous exécutez dotnet publish --output /build_output, l’option --output et sa valeur sont passés à la commande publish.For example when you execute dotnet publish --output /build_output, the --output option and its value are passed to the publish command.

Migration à partir de project.jsonMigration from project.json

Si vous avez utilisé les outils Preview 2 pour produire des projets project.json, consultez la rubrique dotnet migrate pour plus d’informations sur la migration de votre projet vers MSBuild/.csproj.If you used Preview 2 tooling to produce project.json-based projects, consult the dotnet migrate topic for information on migrating your project to MSBuild/.csproj for use with release tooling. Pour les projets .NET Core créés avant la version des outils de Preview 2, mettez à jour manuellement le projet en suivant les instructions dans Migration de DNX vers l’interface CLI .NET Core (project.json), puis utilisez dotnet migrate ou mettez directement à niveau vos projets.For .NET Core projects created prior to the release of Preview 2 tooling, either manually update the project following the guidance in Migrating from DNX to .NET Core CLI (project.json) and then use dotnet migrate or directly upgrade your projects.

Voir aussiSee also

Référentiel GitHub dotnet/CLIdotnet/CLI GitHub Repository
Guide d’installation de .NET Core.NET Core installation guide