Команда dotnet

  • Статья

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

name

dotnet — универсальный драйвер для интерфейса командной строки .NET (CLI).

Краткий обзор

Чтобы получить сведения о среде и доступных командах, выполните следующие действия:

dotnet [--version] [--info] [--list-runtimes] [--list-sdks]

dotnet -h|--help

Выполнение команды (требуется установка пакета SDK):

dotnet <COMMAND> [-d|--diagnostics] [-h|--help] [--verbosity <LEVEL>]
    [command-options] [arguments]

Запуск приложения:

dotnet [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    <PATH_TO_APPLICATION> [arguments]

dotnet exec [--additionalprobingpath] [--additional-deps <PATH>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Описание

Команда dotnet выполняет две функции:

  • Она предоставляет команды для работы с проектами .NET.

    Например, команда dotnet build выполняет построение проекта. Каждая команда определяет свои параметры и аргументы. Все команды поддерживают параметр --help, позволяющий вывести краткую справку по их использованию.

  • Она запускает приложения .NET.

    Для запуска приложения необходимо указать путь к его файлу .dll. Чтобы запустить приложение, необходимо найти и выполнить точку входа, которая в случае использования консольных приложений является методом Main. Например, команда dotnet myapp.dll запускает приложение myapp. Дополнительные сведения о параметрах развертывания см. в статье Развертывание приложений .NET.

Параметры

Доступны различные варианты для:

  • Отображение сведений о среде.
  • Выполнение команды.
  • Запуск приложения.

Параметры отображения сведений о среде и доступных команд

Следующие параметры доступны, если dotnet используется сам по себе, без указания команды или приложения для запуска. Например, dotnet --info или dotnet --version. Выводит сведения о среде.

  • --info

    Выводит подробные сведения об установке .NET и среде компьютера, например текущую операционную систему и фиксацию SHA версии .NET.

  • --version

Выводит версию пакета SDK для .NET, используемого командами dotnet , на которую может повлиять файл global.json . Доступно только при установке пакета SDK.

  • --list-runtimes

    Выводит список установленных сред выполнения .NET. Версия x86 пакета SDK содержит только среды выполнения x86, а в версии x64 пакета SDK содержатся только среды выполнения x64.

  • --list-sdks

    Выводит список установленных пакетов SDK для .NET.

  • -?|-h|--help

    Выводит список доступных команд.

Параметры выполнения команды

Для dotnet с командой доступны следующие параметры. Например, dotnet build --help или dotnet build --verbosity diagnostic.

  • -d|--diagnostics

    Включает вывод диагностических данных.

  • -v|--verbosity <LEVEL>

    Задает уровень детализации команды. Допустимые значения: q[uiet], m[inimal], n[ormal], d[etailed] и diag[nostic]. Поддерживается не во всех командах. Дополнительные сведения см. на странице соответствующей команды.

  • -?|-h|--help

    Выводит документацию по заданной команде. Например, dotnet build --help отображает справку по команде build .

  • command options

    Для каждой команды определяются относящиеся к ней параметры. Список доступных для команды параметров можно просмотреть на соответствующей ей странице.

Параметры запуска приложения

При запуске приложения в dotnet доступны следующие параметры. Например, dotnet --roll-forward Major myapp.dll.

  • --additionalprobingpath <PATH>

    Путь, содержащий политику проверки и проверяемые сборки. Повторите этот параметр, чтобы указать несколько путей.

  • --additional-deps <PATH>

    Путь к дополнительному файлу .deps.json. Файл deps.json содержит список зависимостей, зависимости компиляции и сведения о версии, используемые для устранения конфликтов сборок. Дополнительные сведения см. в разделе Файлы конфигурации среды выполнения на GitHub.

  • --roll-forward <SETTING>

    Управляет применением наката к приложению. SETTING может иметь одно из следующих значений. Если тип не указан, по умолчанию используется вариант Minor.

    • LatestPatch — накат до версии с наибольшим номером исправления. Отключает накат дополнительных версий.
    • Minor — накат до дополнительной версии со следующим по порядку возрастания номером, если запрошенная дополнительная версия отсутствует. Если запрошенная дополнительная версия присутствует, используется политика LatestPatch.
    • Major — накат до основной версии со следующим по порядку возрастания или дополнительной версии с наименьшим номером, если запрошенная дополнительная версия отсутствует. Если запрошенная основная версия присутствует, используется политика Minor.
    • LatestMinor — накат до дополнительной версии с наибольшим номером, даже если запрошенная дополнительная версия присутствует. Предназначен для сценариев размещения компонентов.
    • LatestMajor — накат до основной версии с наибольшим номером и дополнительной версии с наибольшим номером, даже если запрошенная основная версия присутствует. Предназначен для сценариев размещения компонентов.
    • Disable — накат не выполняется. Привязка только к указанной версии. Эта политика не рекомендуется для общего использования, поскольку отключает возможность наката до последних исправлений. Это значение рекомендуется использовать только для тестирования.

    Все параметры, кроме параметра Disable, будут использовать версию с последним доступным исправлением.

    Поведение наката также можно настроить в свойствах файла проекта, файла конфигурации среды выполнения и переменной среды. Дополнительные сведения см. в разделе Накат основной версии среды выполнения.

  • --fx-version <VERSION>

    Версия среды выполнения .NET, используемой для запуска приложения.

    Этот параметр переопределяет версию первой ссылки на платформу в файле .runtimeconfig.json приложения. Таким образом, он работает правильно только с одной ссылкой на платформу. Если приложение содержит более одной ссылки на платформы, использование этого параметра может приводить к ошибкам.

Параметры запуска приложения с exec помощью команды

Следующие параметры доступны только при dotnet запуске приложения с помощью exec команды . Например, dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll.

  • --depsfile <PATH>

    Путь к файлу deps.json. Файл конфигурации deps.json содержит информацию о зависимостях, необходимых для выполнения приложения. Этот файл создается пакетом SDK для .NET.

  • --runtimeconfig <PATH>

    Путь к файлу runtimeconfig.json. Файл runtimeconfig.json содержит параметры времени выполнения и обычно называется <applicationname.runtimeconfig.json>. Дополнительные сведения см. в статье Параметры конфигурации среды выполнения .NET.

Команды dotnet

Общее

Команда Функция
dotnet build Выполняет сборку приложения .NET.
dotnet build-server Взаимодействует с серверами, запущенными сборкой.
dotnet clean Очищает выходные данные сборки.
dotnet exec Запускает приложение .NET.
dotnet help Выводит более подробную документацию из Интернета для команды.
dotnet migrate Переносит допустимый проект предварительной версии 2 в проект пакета SDK .NET Core 1.0.
dotnet msbuild Обеспечивает доступ к командной строке MSBuild.
dotnet new Инициализирует проект C# или F# для заданного шаблона.
dotnet pack Создает пакет NuGet с кодом.
dotnet publish Публикует платформозависимое или автономное приложение .NET.
dotnet restore Восстанавливает зависимости для данного приложения.
dotnet run Запускает приложение из источника.
dotnet sdk check Отображает актуальное состояние установленного пакета SDK и версий среды выполнения.
dotnet sln Параметры для добавления, удаления и перечисления проектов в файле решения.
dotnet store Сохраняет сборки в хранилище пакетов среды выполнения.
dotnet test Выполняет тесты с помощью средства запуска тестов.

Ссылки на проекты

Команда Функция
dotnet add reference Добавляет ссылку на проект.
dotnet list reference Перечисляет ссылки на проекты.
dotnet remove reference Удаляет ссылку на проект.

Пакеты NuGet

Команда Функция
dotnet add package Добавляет пакет NuGet.
dotnet remove package Удаляет пакет NuGet.

Команды NuGet

Команда Функция
dotnet nuget delete Удаляет пакет с сервера или из списка.
dotnet nuget push Отправляет пакет на сервер и публикует его.
dotnet nuget locals Очищает или перечисляет локальные ресурсы NuGet в кэше HTTP-запросов, временном кэше или папке пакетов, используемой на уровне компьютера.
dotnet nuget add source Добавляет источник NuGet.
dotnet nuget disable source Отключает источник NuGet.
dotnet nuget enable source Включает источник NuGet.
dotnet nuget list source Перечисляет все настроенные источники NuGet.
dotnet nuget remove source Удаляет источник NuGet.
dotnet nuget update source Обновляет источник NuGet.

Команды рабочей нагрузки

Команда Функция
dotnet workload install Устанавливает дополнительную рабочую нагрузку.
dotnet workload list Выводит список установленных рабочих нагрузок.
dotnet workload repair Восстанавливает все установленные рабочие нагрузки.
dotnet workload search Вывод списка выбранных рабочих нагрузок или всех доступных рабочих нагрузок.
dotnet workload uninstall Удаляет рабочую нагрузку.
dotnet workload update Переустанавливает все установленные рабочие нагрузки.

Команды глобального, установочного и локального средства

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

Команда Функция
dotnet tool install Устанавливает средство на компьютере.
dotnet tool list Выводит все глобальные, установочные и локальные средства, установленные на компьютере.
dotnet tool search Ищет в NuGet.org средства, в названии или метаданных которых есть указанный поисковый запрос.
dotnet tool uninstall Удаляет средство с компьютера.
dotnet tool update Обновляет средство, установленное на компьютере.

Дополнительные средства

В составе пакета SDK для .NET доступны следующие дополнительные средства:

Средство Функция
dev-certs Создает сертификаты разработки и управляет ими.
ef Средства командной строки для Entity Framework Core.
user-secrets Управляет секретами пользователей для разработки.
watch Наблюдатель за файлами, который перезапускает или перезагружает приложение при обнаружении изменений в исходном коде.

Дополнительные сведения о каждом средстве можно получить с помощью команды dotnet <tool-name> --help.

Примеры

Создание нового консольного приложения .NET:

dotnet new console

Сборка проекта и его зависимостей в указанном каталоге:

dotnet build

Запуск приложения:

dotnet exec myapp.dll

dotnet myapp.dll

См. также