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

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. Дополнительные сведения см. в статье Распространенные конфигурации NuGet

    Примечание

    В соответствии с инициативой NuGet Https Everywhere мы dotnet 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

См. также