dotnet nova instalação

Artigo
01/29/2025

Este artigo aplica-se a: ✔️ SDK do .NET Core 3.1 e versões posteriores

Designação

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 modelo a partir do PATH ou NUGET_ID fornecido. Se desejar instalar uma versão específica ou uma versão 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, que representa a versão mais recente do pacote estável. Para obter mais informações, consulte a seção Exemplos.

Se uma versão do pacote de modelo já estava instalada quando você executa 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, ela não será reinstalada. Se o argumento for um PATH e já estiver instalado, ele não será reinstalado.

Antes do .NET SDK 6.0.100, os pacotes de modelo eram gerenciados individualmente para cada versão do SDK do .NET, 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 somente para o .NET SDK 5.0.100. Os modelos do pacote não estarão disponíveis em outras versões do SDK do .NET instaladas em sua máquina.

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 sua máquina. 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 SDK do .NET anteriores ao .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 nessa versão do SDK do .NET.

Observação

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

As opções --list, --search, --installe --uninstall tornaram-se list, search, installe uninstall subcomandos.
A opção --update-apply tornou-se 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 uso com seus respetivos subcomandos. Ajuda separada para cada subcomando está disponível através da opção -h ou --help: dotnet new <subcommand> --help lista todas as opções suportadas para o subcomando.

Além disso, o preenchimento de guias agora está disponível para dotnet new. Ele suporta a conclusão para nomes de modelo instalados e para as opções que um modelo selecionado fornece. Para ativar o preenchimento de guias para o SDK do .NET, consulte Habilitar conclusão de guia.

Exemplos de sintaxe antiga:

Instale 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 o identificador de pacote NuGet a partir do qual instalar o pacote de modelo. dotnet new tenta instalar o pacote NuGet a partir das fontes NuGet disponíveis para o diretório de trabalho atual e as fontes especificadas por meio da opção --add-source. Se você quiser instalar uma versão específica ou uma versão de pré-lançamento de um pacote de modelo da fonte do NuGet, 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 a partir da qual o pacote pode ser instalado. Se --nuget-source for especificado, a fonte 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, consulte Configurações comuns do NuGet.

Observação

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

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

Permite instalar pacotes de modelo a partir das fontes especificadas, mesmo que eles substituam um pacote de modelo de outra fonte. Disponível desde .NET SDK 7.0.100.
-h|--help

Imprime a ajuda para o comando install. Disponível desde .NET SDK 7.0.100.

--interactive

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

-v|--verbosity <LEVEL>

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

Exemplos

Instale a versão mais recente dos modelos de SPA para o 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 SPA para ASP.NET Core a partir de uma fonte NuGet personalizada 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

Partilhar via