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:
Интерфейс командной строки.NETdotnet 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:
Интерфейс командной строки.NETdotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates
Установите версию 2.0 шаблонов SPA для ASP.NET Core:
Интерфейс командной строки.NETdotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0
Установите версию 2.0 шаблонов SPA для ASP.NET Core из настраиваемого источника NuGet в интерактивном режиме:
Интерфейс командной строки.NETdotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0 --add-source "https://api.my-custom-nuget.com/v3/index.json" --interactive
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: