Поделиться через

команда dotnet

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

Имя

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 <PATH>] [--additional-deps <PATH>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Описание

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

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

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

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

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

Опции

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

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

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

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

  • --info

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

  • --version

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

  • --list-runtimes [--arch <ARCH>]

    Выводит список установленных сред выполнения .NET для архитектуры вызываемой dotnetсреды выполнения. Версия x86 списков dotnet только среды выполнения x86 и версия dotnet x64 списков только среды выполнения x64.

    .NET 10 и более поздних версий поддерживают --arch аргумент. Если задано и не dotnet совпадает с архитектурой, выполняется поиск установки .NET указанной архитектуры и выводится все установленные среды выполнения. Допустимые значения включают arm64, x64 и x86. Репозиторий dotnet/runtime содержит полный список допустимых значений архитектуры.

  • --list-sdks [--arch <ARCH>]

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

    .NET 10 и более поздних версий поддерживают --arch аргумент. Если задано и не dotnet совпадает с архитектурой, выполняется поиск установки .NET указанной архитектуры и выводится все установленные там пакеты SDK. Допустимые значения включают arm64, x64 и x86. Репозиторий dotnet/runtime содержит полный список допустимых значений архитектуры.

  • -?|-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.

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

    За исключением #B0, все параметры будут использовать самую доступную версию исправления.

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

  • --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 содержит параметры времени выполнения и обычно называется именем<> имени приложения.runtimeconfig.json. Дополнительные сведения см. в параметрах конфигурации среды выполнения .NET.

команды dotnet

Общая информация

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

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

Приказ Функция
Добавление ссылки dotnet Добавляет ссылку на проект.
Список ссылок dotnet Выводит ссылки на проекты.
Удаление ссылки dotnet Удаляет ссылку на проект.

Пакеты NuGet

Приказ Функция
Добавление пакета dotnet Добавляет пакет NuGet.
Список пакетов dotnet Перечисляет пакеты NuGet.
Удаление пакета dotnet Удаляет пакет NuGet.
Поиск пакетов dotnet Ищет пакет NuGet.

Команды NuGet

Приказ Функция
dotnet nuget delete Удаляет или отменяет список пакетов с сервера.
Push-отправка dotnet nuget Отправляет пакет на сервер и публикует его.
Локальные параметры dotnet nuget Очищает или перечисляет локальные ресурсы NuGet, такие как кэш http-запросов, временный кэш или папка глобальных пакетов на уровне компьютера.
Dotnet nuget add source Добавляет источник NuGet.
Dotnet nuget disable source Отключает источник NuGet.
dotnet nuget enable source Включает источник NuGet.
Источник списка nuget dotnet Выводит список всех настроенных источников NuGet.
Dotnet nuget remove source Удаляет источник NuGet.
Источник обновления dotnet nuget Обновляет источник NuGet.

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

Приказ Функция
установка рабочей нагрузки dotnet Устанавливает необязательную рабочую нагрузку.
Список рабочих нагрузок dotnet Выводит список всех установленных рабочих нагрузок.
Восстановление рабочей нагрузки dotnet Восстанавливает все установленные рабочие нагрузки.
Поиск рабочей нагрузки dotnet Вывод списка выбранных рабочих нагрузок или всех доступных рабочих нагрузок.
Удаление рабочей нагрузки dotnet Удаляет рабочую нагрузку.
Обновление рабочей нагрузки dotnet Переустановка всех установленных рабочих нагрузок.

Глобальные команды, пути к инструменту и локальные инструменты

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

Приказ Функция
Установка средства dotnet Устанавливает средство на компьютере.
Список инструментов dotnet Выводит список всех глобальных, инструментов и локальных средств, установленных на компьютере.
Поиск средства dotnet Выполняет поиск NuGet.org для инструментов, имеющих указанный термин поиска в имени или метаданных.
Удаление средства dotnet Удаляет средство с компьютера.
Обновление средства dotnet Обновляет средство, установленное на компьютере.

Дополнительные инструменты

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

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

Дополнительные сведения о каждом инструменте введите #B0.

Примеры

Создайте консольное приложение .NET:

dotnet new console

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

dotnet build

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

dotnet exec myapp.dll

dotnet myapp.dll

См. также