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

  • Статья

Эта статья относится к следующему. ✔️ SDK для .NET Core 2.1 и более поздних версий

Интерфейс командной строки (CLI) .NET — это кроссплатформенная цепочка инструментов для разработки, сборки, запуска и публикации приложений .NET.

Интерфейс командной строки .NET входит в пакет SDK для .NET. Сведения об установке пакета SDK для .NET см. в статье Установка .NET Core.

Команды CLI

По умолчанию устанавливаются следующие команды:

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

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

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

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

Средства — это консольные приложения, которые устанавливаются из пакетов NuGet и вызываются из командной строки. Вы можете писать средства самостоятельно или устанавливать средства, написанные другими. Средства также называются глобальными средствами, средствами пути к средству и локальными средствами. Дополнительные сведения см. в обзоре средств .NET.

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

Структура команд CLI состоит из драйвера ("dotnet"), самой команды и ее возможных аргументов и параметров. Этот шаблон используется в большинстве операций интерфейса командной строки, таких как создание консольного приложения и его запуск из командной строки, как показывают следующие команды при выполнении из каталога my_app:

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

Драйвер

Драйвер называется dotnet и имеет два вида ответственности — выполнение платформозависимого приложения или выполнение команды.

Для запуска платформозависимого приложения укажите его драйвера, например dotnet /path/to/my_app.dll. При выполнении команды из папки, где находится библиотека DLL приложения, просто выполните dotnet my_app.dll. Если вы хотите использовать конкретную версию среды выполнения .NET, используйте параметр --fx-version <VERSION> (см. справку по --fx-version <VERSION>).

При указании команды для драйвера dotnet.exe запускает процесс выполнения команды CLI. Пример:

dotnet build

Сначала драйвер определяет нужную версию пакета SDK. Если файл global.json отсутствует, используется последняя доступная версия пакета SDK. Это может быть предварительная или стабильная версия, в зависимости от того, какая версия является последней на компьютере. После определения версии пакета SDK он выполняет команду.

Команда

Команда выполняет действие. Например, dotnet build проводит сборку кода. dotnet publish публикует код. Команды реализуются как консольное приложение с использованием соглашения dotnet {command}.

Аргументы

Аргументы, указываемые в командной строке, передаются непосредственно в вызываемую команду. Например, если выполнить dotnet publish my_app.csproj, аргумент my_app.csproj указывает публикуемый проект и передается в команду publish.

Параметры

Параметры, указываемые в командной строке, передаются непосредственно в вызываемую команду. Например, при выполнении dotnet publish --output /build_output параметр --output и его значение передаются в команду publish.

См. также