Обзор интерфейса командной строки .NET.NET CLI overview

Эта статья относится к следующему. ✔️ SDK для .NET Core 2.1 и более поздних версийThis article applies to: ✔️ .NET Core 2.1 SDK and later versions

Интерфейс командной строки (CLI) .NET — это кроссплатформенная цепочка инструментов для разработки, сборки, запуска и публикации приложений .NET.The .NET command-line interface (CLI) is a cross-platform toolchain for developing, building, running, and publishing .NET applications.

Интерфейс командной строки .NET входит в пакет SDK для .NET.The .NET CLI is included with the .NET SDK. Сведения об установке пакета SDK для .NET см. в статье Установка .NET Core.To learn how to install the .NET SDK, see Install .NET Core.

Команды CLICLI commands

По умолчанию устанавливаются следующие команды:The following commands are installed by default:

Основные командыBasic commands

Команды для изменения проектаProject modification commands

Расширенные командыAdvanced commands

Команды управления средствомTool management commands

Средства — это консольные приложения, которые устанавливаются из пакетов NuGet и вызываются из командной строки.Tools are console applications that are installed from NuGet packages and are invoked from the command prompt. Вы можете писать средства самостоятельно или устанавливать средства, написанные другими.You can write tools yourself or install tools written by third parties. Средства также называются глобальными средствами, средствами пути к средству и локальными средствами.Tools are also known as global tools, tool-path tools, and local tools. Дополнительные сведения см. в обзоре средств .NET.For more information, see .NET tools overview.

Структура командCommand structure

Структура команд CLI состоит из драйвера ("dotnet"), самой команды и ее возможных аргументов и параметров.CLI command structure consists of the driver ("dotnet"), the command, and possibly command arguments and options. Этот шаблон используется в большинстве операций интерфейса командной строки, таких как создание консольного приложения и его запуск из командной строки, как показывают следующие команды при выполнении из каталога 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

ДрайверDriver

Драйвер называется dotnet и имеет два вида ответственности — выполнение платформозависимого приложения или выполнение команды.The driver is named dotnet and has two responsibilities, either running a framework-dependent app or executing a command.

Для запуска платформозависимого приложения укажите его драйвера, например 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. При выполнении команды из папки, где находится библиотека DLL приложения, просто выполните dotnet my_app.dll.When executing the command from the folder where the app's DLL resides, simply execute dotnet my_app.dll. Если вы хотите использовать конкретную версию среды выполнения .NET, используйте параметр --fx-version <VERSION> (см. справку по команде dotnet).If you want to use a specific version of the .NET Runtime, use the --fx-version <VERSION> option (see the dotnet command reference).

При указании команды для драйвера dotnet.exe запускает процесс выполнения команды CLI.When you supply a command to the driver, dotnet.exe starts the CLI command execution process. Пример:For example:

dotnet build

Сначала драйвер определяет нужную версию пакета SDK.First, the driver determines the version of the SDK to use. Если файл global.json отсутствует, используется последняя доступная версия пакета SDK.If there is no global.json file, the latest version of the SDK available is used. Это может быть предварительная или стабильная версия, в зависимости от того, какая версия является последней на компьютере.This might be either a preview or stable version, depending on what is latest on the machine. После определения версии пакета SDK он выполняет команду.Once the SDK version is determined, it executes the command.

КомандаCommand

Команда выполняет действие.The command performs an action. Например, dotnet build проводит сборку кода.For example, dotnet build builds code. dotnet publish публикует код.dotnet publish publishes code. Команды реализуются как консольное приложение с использованием соглашения dotnet {command}.The commands are implemented as a console application using a dotnet {command} convention.

АргументыArguments

Аргументы, указываемые в командной строке, передаются непосредственно в вызываемую команду.The arguments you pass on the command line are the arguments to the command invoked. Например, если выполнить dotnet publish my_app.csproj, аргумент my_app.csproj указывает публикуемый проект и передается в команду 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.

ПараметрыOptions

Параметры, указываемые в командной строке, передаются непосредственно в вызываемую команду.The options you pass on the command line are the options to the command invoked. Например, при выполнении dotnet publish --output /build_output параметр --output и его значение передаются в команду publish.For example, when you execute dotnet publish --output /build_output, the --output option and its value are passed to the publish command.

См. такжеSee also