dotnet new install

Artigo
06/28/2023

Este artigo se aplica ao: ✔️ .NET Core 3.1 SDK e às versões posteriores

Nome

dotnet new install - Instala um pacote de modelos.

Sinopse

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

Descrição

O comando dotnet new install instala um pacote de modelos no PATH ou NUGET_ID fornecido. Se você deseja instalar uma versão específica ou de pré-lançamento de um pacote de modelo, especifique a versão no formato <package-name>::<package-version>. Por padrão, dotnet new passa * para a versão, o que representa a última versão estável do pacote. Para obter mais informações, consulte a seção Exemplos.

Se uma versão do pacote de modelo já tiver sido instalada quando você executar esse comando, o pacote de modelo será atualizado para a versão especificada. Se nenhuma versão for especificada, o pacote será atualizado para a versão estável mais recente. A partir do .NET SDK 6.0.100, se o argumento especificar a versão e essa versão do pacote NuGet já estiver instalada, ele não será reinstalado. Se o argumento for um PATH e já estiver instalado, ele não será reinstalado.

Antes do SDK do .NET 6.0.100, os pacotes de modelo eram gerenciados individualmente para cada versão do .NET SDK, incluindo versões de patch. Por exemplo, se você instalar o pacote de modelo usando dotnet new --install no .NET SDK 5.0.100, ele será instalado apenas para o .NET SDK 5.0.100. Os modelos do pacote não estarão disponíveis em outras versões do .NET SDK instaladas em seu computador.

A partir do .NET SDK 6.0.100, os pacotes de modelos instalados estão disponíveis em versões posteriores do SDK do .NET instaladas em seu computador. Um pacote de modelo instalado no .NET SDK 6.0.100 também estará disponível no .NET SDK 6.0.101, .NET SDK 6.0.200 e assim por diante. No entanto, esses pacotes de modelo não estarão disponíveis nas versões do .NET SDK antes do .NET SDK 6.0.100. Para usar um pacote de modelo instalado no .NET SDK 6.0.100 ou posterior em versões anteriores do .NET SDK, você precisa instalá-lo usando dotnet new install essa versão do .NET SDK.

Observação

A partir do SDK do .NET 7, a sintaxe dotnet new foi alterada:

As opções --list, --search, --install e --uninstall se tornaram os subcomandos list, search, install e uninstall.
A opção --update-apply se tornou o subcomando update.
Para usar --update-check, use o subcomando update com a opção --check-only.

Outras opções que estavam disponíveis antes ainda estão disponíveis para serem usadas com os respectivos subcomandos. A ajuda separada para cada subcomando está disponível por meio da ou opção -h ou --help: dotnet new <subcommand> --help lista todas as opções com suporte para o subcomando.

Além disso, o preenchimento com Tab agora está disponível para dotnet new. Ele oferece suporte ao preenchimento de nomes de modelo instalados e às opções fornecidas por um modelo selecionado. Para ativar o preenchimento com Tab no SDK do .NET, confira Habilitar o preenchimento com Tab.

Exemplos de sintaxe antiga:

Instalar a versão mais recente do pacote de modelo de projeto de trabalhos Web do Azure:
```
dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates
```

Argumentos

<PATH|NUGET_ID>

A pasta no sistema de arquivos ou no identificador de pacote NuGet do qual instala o pacote de modelo. dotnet new tenta instalar o pacote NuGet das fontes do NuGet disponíveis para o diretório de trabalho atual e as fontes especificadas por meio da opção --add-source. Se você deseja instalar uma versão específica ou de pré-lançamento de um pacote de modelo, especifique a versão no formato <package-name>::<package-version>.

Opções

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

Por padrão, dotnet new install usa a hierarquia de arquivos de configuração do NuGet do diretório atual para determinar a origem do NuGet da qual o pacote pode ser instalado. Se --nuget-source for especificado, a origem será adicionada à lista de fontes a serem verificadas.
Para verificar as fontes configuradas para o diretório atual, use dotnet nuget list source. Para obter mais informações, confira Configurações comuns do NuGet.

Observação

Seguindo a iniciativa Https Everywhere do NuGet, dotnet new está eliminando feeds de http. Se um feed http for passado, não será consultado em pacotes e um aviso será exibido. A opção --force pode ser usada para substituir esse comportamento, se necessário.
-d|--diagnostics

Habilita a saída de diagnóstico. Disponível desde o SDK do .NET 7.0.100.
--force

Permite a instalação de pacotes de modelos a partir das fontes especificadas, mesmo que substituam um pacote de modelos a partir de outra fonte. Disponível desde o SDK do .NET 7.0.100.
-h|--help

Imprime a ajuda para o comando de instalação. Disponível desde o SDK do .NET 7.0.100.

--interactive

Permite que o comando pare e aguarde entrada ou ação do usuário. Por exemplo, para concluir a autenticação. Disponível desde o .NET 5.0 SDK.

-v|--verbosity <LEVEL>

Define o nível de detalhes do comando. Os valores permitidos são q[uiet], m[inimal], n[ormal] e diag[nostic]. Disponível desde o SDK .NET 7.0.100.

Exemplos

Instale a versão mais recente dos modelos de SPA para ASP.NET Core:
```
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates
```

Instale a versão 2.0 dos modelos de SPA para ASP.NET Core:

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

Instale a versão 2.0 dos modelos de SPA para ASP.NET Core de uma fonte personalizada do NuGet usando o modo interativo:

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

Compartilhar via