Share via

nova instalação dotnet

  • Artigo

Este artigo aplica-se a: ✔️ SDK .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 dotnet new install comando instala um pacote de modelo a PATH partir do ou NUGET_ID fornecido. Se 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 predefinição, dotnet new passa * para a versão, que representa a versão mais recente do pacote estável. Para obter mais informações, veja a secção Exemplos .

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

Antes do SDK .NET 6.0.100, os pacotes de modelos eram geridos individualmente para cada versão do SDK .NET, incluindo versões de patch. Por exemplo, se instalar o pacote de modelos com dotnet new --install o SDK .NET 5.0.100, este será instalado apenas para o SDK .NET 5.0.100. Os modelos do pacote não estarão disponíveis noutras versões do SDK .NET instaladas no seu computador.

A partir do SDK .NET 6.0.100, os pacotes de modelos instalados estão disponíveis em versões posteriores do SDK .NET instaladas no seu computador. Um pacote de modelo instalado no SDK .NET 6.0.100 também estará disponível no SDK .NET 6.0.101, .NET SDK 6.0.200, etc. No entanto, estes pacotes de modelos não estarão disponíveis em versões do SDK .NET antes do SDK .NET 6.0.100. Para utilizar um pacote de modelo instalado no SDK .NET 6.0.100 ou posterior em versões anteriores do SDK .NET, tem de instalá-lo com dotnet new install essa versão do SDK .NET.

Nota

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

  • As --listopções , --search, --installe --uninstall tornaram-se list, search, installe uninstall subcomandos.
  • A --update-apply opção tornou-se o update subcomando.
  • Para utilizar --update-checko , utilize o update subcomando com a opção --check-only .

Outras opções que estavam disponíveis anteriormente ainda estão disponíveis para utilização com os respetivos subcomandos. A 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, a conclusão do separador está agora disponível para dotnet new. Suporta a conclusão de nomes de modelos instalados e para as opções que um modelo selecionado fornece. Para ativar a conclusão do separador para o SDK .NET, veja Ativar a conclusão do separador.

Exemplos de sintaxe antiga:

  • Instale a versão mais recente do pacote de modelo de projeto de tarefas Web do Azure:

    dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates

Argumentos

  • <PATH|NUGET_ID>

    A pasta no sistema de ficheiros ou no identificador do pacote NuGet a partir do qual instalar o pacote de modelos. dotnet new tenta instalar o pacote NuGet a partir das origens NuGet disponíveis para o diretório de trabalho atual e as origens especificadas através da opção --add-source . Se quiser instalar uma versão específica ou uma versão de pré-lançamento de um pacote de modelo a partir da origem NuGet, especifique a versão no formato <package-name>::<package-version>.

Opções

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

    Por predefinição, dotnet new install utiliza a hierarquia de ficheiros de configuração NuGet do diretório atual para determinar a origem NuGet a partir da qual o pacote pode ser instalado. Se --nuget-source for especificado, a origem será adicionada à lista de origens a verificar.
    Para verificar as origens configuradas para a utilização dotnet nuget list sourceatual do diretório . Para obter mais informações, veja Common NuGet Configurations (Configurações Do NuGet Comuns)

    Nota

    Após a iniciativa Https Everywhere do NuGet, dotnet new está a eliminar http gradualmente os feeds. Se for transmitido um http feed, não é consultado para pacotes e é apresentado um aviso. A --force opção pode ser utilizada para substituir este comportamento, se necessário.

  • -d|--diagnostics

    Ativa a saída de diagnóstico. Disponível desde o SDK .NET 7.0.100.

  • --force

    Permite instalar pacotes de modelos a partir das origens especificadas, mesmo que substituam um pacote de modelo de outra origem. Disponível desde o SDK .NET 7.0.100.

  • -h|--help

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

  • --interactive

    Permite que o comando pare e aguarde pela entrada ou ação do utilizador. Por exemplo, para concluir a autenticação. Disponível desde o SDK .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 .NET 7.0.100.

Exemplos

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

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

  • Instale a versão 2.0 dos modelos 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 origem NuGet personalizada com 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

Ver também