Обзор интерфейса командной строки .NET
Эта статья относится к следующему. ✔️ SDK для .NET Core 2.1 и более поздних версий
Интерфейс командной строки (CLI) .NET — это кроссплатформенная цепочка инструментов для разработки, сборки, запуска и публикации приложений .NET.
Интерфейс командной строки .NET входит в пакет SDK для .NET. Сведения об установке пакета SDK для .NET см. в статье Установка .NET Core.
Команды CLI
По умолчанию устанавливаются следующие команды:
Основные команды
Команды для изменения проекта
Расширенные команды
Команды управления средством
tool install
tool list
tool update
tool restore
(доступна, начиная с пакета SDK для .NET Core 3.0)tool run
(доступна, начиная с пакета SDK для .NET Core 3.0)tool uninstall
Средства — это консольные приложения, которые устанавливаются из пакетов 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
.