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

dotnet new install

  • Статья

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

Имя

dotnet new install — устанавливает пакет шаблона.

Синопсис

dotnet new install <PATH|NUGET_ID>  [--interactive] [--add-source|--nuget-source <SOURCE>] [--force]
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Описание

Команда dotnet new install устанавливает пакет шаблона из предоставленного PATH или NUGET_ID. Если вы хотите установить определенную версию или предварительную версию пакета шаблона, укажите версию в формате <package-name>::<package-version>. По умолчанию dotnet new передает * для версии, представляющей последнюю стабильную версию пакета. Дополнительные сведения см. в разделе Примеры.

Если при выполнении этой команды уже установлена версия пакета шаблона, пакет шаблона будет обновлен до указанной версии. Если версия не указана, пакет обновляется до последней стабильной версии. Начиная с пакета SDK для .NET версии 6.0.100, если аргумент указывает версию, и эта версия пакета NuGet уже установлена, она не будет переустановлена. Если аргумент является PATH и он уже установлен, он не будет переустановлен.

До пакета SDK для .NET 6.0.100 пакеты шаблонов управляются по отдельности для каждой версии пакета SDK для .NET, включая версии исправлений. Например, если установить пакет шаблона с помощью dotnet new --install в пакете SDK для .NET 5.0.100, он будет установлен только для пакета SDK для .NET 5.0.100. Шаблоны из пакета не будут доступны в других версиях пакета SDK для .NET, установленных на компьютере.

Начиная с пакета SDK для .NET версии 6.0.100 установленные пакеты шаблонов доступны в более поздних версиях пакета SDK для .NET, установленных на компьютере. Пакет шаблона, установленный в пакете SDK для .NET 6.0.100, также будет доступен в пакете SDK для .NET 6.0.101, пакет SDK для .NET 6.0.200 и т. д. Однако эти пакеты шаблонов не будут доступны в версиях пакета SDK для .NET до пакета SDK для .NET 6.0.100. Чтобы использовать пакет шаблона, установленный в пакете SDK для .NET версии 6.0.100 или более поздней версии пакета SDK для .NET, необходимо установить его с помощью dotnet new install в этой версии пакета SDK для .NET.

Заметка

Начиная с пакета SDK для .NET 7, синтаксис dotnet new изменился:

  • Варианты --list, --search, --installи --uninstall стали list, search, installи uninstall субкомандам.
  • Вариант --update-apply стал update подкоманда.
  • Чтобы использовать --update-check, используйте подкоманда update с параметром --check-only.

Другие варианты, которые были доступны раньше, по-прежнему доступны для использования с соответствующими подкомандами. Отдельная справка для каждой подкоманда доступна с помощью параметра -h или --help: dotnet new <subcommand> --help перечисляет все поддерживаемые параметры для подкоманда.

Кроме того, для dotnet newтеперь доступно завершение вкладки. Он поддерживает завершение для установленных имен шаблонов и для параметров выбранного шаблона. Чтобы активировать завершение вкладки для пакета SDK для .NET, см. раздел Включение завершения вкладки.

Примеры старого синтаксиса:

  • Установите последнюю версию пакета шаблона проекта веб-заданий Azure:

    dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates

Аргументы

  • <PATH|NUGET_ID>

    Папка файловой системы или идентификатор пакета NuGet для установки пакета шаблона. dotnet new пытается установить пакет NuGet из источников NuGet, доступных для текущего рабочего каталога и источников, указанных с помощью параметра --add-source. Если вы хотите установить определенную версию или предварительную версию пакета шаблона из источника NuGet, укажите версию в формате <package-name>::<package-version>.

Параметры

  • --add-source|--nuget-source <SOURCE>

    По умолчанию dotnet new install использует иерархию файлов конфигурации NuGet из текущего каталога, чтобы определить источник NuGet, из который можно установить пакет. Если указана --nuget-source, источник будет добавлен в список источников для проверки. Чтобы проверить настроенные источники для текущего каталога, используйте dotnet nuget list source. Дополнительные сведения см. в разделе Common NuGet Configurations.

    Заметка

    После инициативы NuGet Https Everywheredotnet new будет постепенно отходить от веб-каналов http. Если передается веб-канал http, он не запрашивается для пакетов и отображается предупреждение. Параметр --force можно использовать для переопределения этого поведения при необходимости.

  • -d|--diagnostics

    Включает выходные данные диагностики. Доступно с версии пакета SDK для .NET 7.0.100.

  • --force

    Позволяет устанавливать пакеты шаблонов из указанных источников, даже если они переопределяют пакет шаблона из другого источника. Доступно с версии пакета SDK для .NET 7.0.100.

  • -h|--help

    Выводит справку по команде установки. Доступно с версии пакета SDK для .NET 7.0.100.

  • --interactive

    Позволяет команде остановить и ждать ввода или действия пользователя. Например, чтобы завершить проверку подлинности. Доступно с пакета SDK для .NET 5.0.

  • -v|--verbosity <LEVEL>

    Задает уровень детализации команды. Допустимые значения: q[uiet], m[inimal], n[ormal]и diag[nostic]. Доступно с версии пакета SDK для .NET 7.0.100.

Примеры

  • Установите последнюю версию шаблонов SPA для ASP.NET Core:

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates

  • Установите версию 2.0 шаблонов SPA для ASP.NET Core:

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0

  • Установите версию 2.0 шаблонов SPA для ASP.NET Core из пользовательского источника NuGet с помощью интерактивного режима:

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0 --add-source "https://api.my-custom-nuget.com/v3/index.json" --interactive

См. также