nova instalação do dotnet

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

Nome

dotnet new install – instala um pacote de modelo.

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 do PATH ou NUGET_ID fornecido. Se você quiser 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 de.

Se uma versão do pacote de modelo já estiver 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 SDK do .NET 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 SDK do .NET, incluindo versões de patch. Por exemplo, se você instalar o pacote de modelos usando dotnet new --install no SDK do .NET 5.0.100, ele será instalado apenas para o SDK do .NET 5.0.100. Os modelos do pacote não estarão disponíveis em outras versões do SDK do .NET instaladas em seu computador.

A partir do SDK do .NET 6.0.100, os pacotes de modelo instalados estão disponíveis em versões posteriores do SDK do .NET instaladas em seu computador. Um pacote de modelo instalado no SDK do .NET 6.0.100 também estará disponível no SDK do .NET 6.0.101, no SDK do .NET 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 antes do SDK do .NET 6.0.100. Para usar um pacote de modelo instalado no SDK do .NET 6.0.100 ou posterior em versões anteriores do SDK do .NET, você precisa instalá-lo usando dotnet new install nessa versão do SDK do .NET.

Nota

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

• As opções --list, --search, --installe --uninstall tornaram-se subcomandos list, search, installe uninstall.
• 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 respectivos subcomandos. A ajuda separada para cada subcomando está disponível por meio da opção -h ou --help: dotnet new <subcommand> --help lista todas as opções com suporte para o subcomando.

Além disso, a conclusão da guia agora está disponível para dotnet new. Ele dá suporte à conclusão para nomes de modelo instalados e para as opções que um modelo selecionado fornece. Para ativar a conclusão da guia para o SDK do .NET, consulte Habilitar o preenchimento da 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 no identificador do pacote NuGet do qual instalar 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ê quiser instalar uma versão específica ou uma versão de pré-lançamento de um pacote de modelo da origem 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 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, consulte de Configurações Comuns do NuGet.

  Nota

  Após a iniciativa Https Everywhere do NuGet, dotnet new está eliminando 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

  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 modelo das fontes especificadas, mesmo que eles substituam um pacote de modelo 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 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 verbosidade do comando. Os valores permitidos são q[uiet], m[inimal], n[ormal]e diag[nostic]. Disponível desde o SDK do .NET 7.0.100.

Exemplos

• Instale a versão mais recente dos modelos do SPA para o ASP.NET Core:

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

• Instale a versão 2.0 dos modelos do 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 do 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
  

Consulte também

• comando dotnet new
• comando dotnet new search
• modelos personalizados para dotnet new