Gerenciar modelos de projeto e item .NET

O .NET fornece um sistema de modelos que permite aos usuários instalar ou desinstalar pacotes contendo modelos do NuGet, um arquivo de pacote NuGet ou um diretório do sistema de arquivos. Este artigo descreve como gerenciar modelos .NET por meio da CLI do .NET SDK.

Para obter mais informações sobre como criar modelos, consulte Tutorial: Criar modelos.

Instalar modelo

Os pacotes de modelos são instalados através do dotnet new comando install SDK. Você pode fornecer o identificador de pacote NuGet de um pacote de modelo ou uma pasta que contenha os arquivos de modelo.

Pacote NuGet hospedado

Os pacotes de modelo da CLI do .NET são carregados no NuGet para ampla distribuição. Os pacotes de modelos também podem ser instalados a partir de um feed privado. Em vez de carregar um pacote de modelo para um feed do NuGet, os arquivos de modelo nupkg podem ser distribuídos e instalados manualmente, conforme descrito na seção Pacote NuGet Local.

Para obter mais informações sobre como configurar feeds NuGet, consulte dotnet nuget add source.

Para instalar um pacote de modelo a partir do feed NuGet padrão, use o dotnet new install {package-id} comando:

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

Para instalar um pacote de modelo a partir do feed NuGet padrão com uma versão específica, use o dotnet new install {package-id}@{version} comando:

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

Pacote NuGet local

Quando um pacote de modelo é criado, um arquivo nupkg é gerado. Se você tiver um arquivo nupkg contendo modelos, você pode instalá-lo com o dotnet new install {path-to-package} comando:

dotnet new install c:\code\nuget-packages\Some.Templates.1.0.0.nupkg

dotnet new install ~/code/nuget-packages/Some.Templates.1.0.0.nupkg

Pasta

Como alternativa à instalação de modelos a partir de um arquivo nupkg , você também pode instalar modelos de uma pasta diretamente com o dotnet new install {folder-path} comando. A pasta especificada é tratada como o identificador do pacote de modelo para qualquer modelo encontrado. Qualquer modelo encontrado na hierarquia da pasta especificada é instalado.

dotnet new install c:\code\nuget-packages\some-folder\

dotnet new install ~/code/nuget-packages/some-folder/

O {folder-path} especificado no comando torna-se o identificador do pacote de modelo para todos os modelos encontrados. Conforme especificado na seção Listar pacotes de modelos, você pode obter uma lista de pacotes de modelos instalados com o dotnet new uninstall comando. Neste exemplo, o identificador do pacote de modelo é mostrado como a pasta usada para a instalação:

dotnet new uninstall
Currently installed items:

... cut to save space ...

  c:\code\nuget-packages\some-folder
    Templates:
      A Template Console Class (templateconsole) C#
      Project for some technology (contosoproject) C#
    Uninstall Command:
      dotnet new uninstall c:\code\nuget-packages\some-folder

dotnet new uninstall
Currently installed items:

... cut to save space ...

  /home/username/code/templates
    Templates:
      A Template Console Class (templateconsole) C#
      Project for some technology (contosoproject) C#
    Uninstall Command:
      dotnet new uninstall /home/username/code/templates

Desinstalar pacote de modelo

Os pacotes de modelo são desinstalados através do dotnet new comando uninstall SDK. Você pode fornecer o identificador de pacote NuGet de um pacote de modelo ou uma pasta que contenha os arquivos de modelo.

Pacote NuGet

Depois que um pacote de modelo NuGet é instalado, seja a partir de um feed NuGet ou de um arquivo nupkg , você pode desinstalá-lo fazendo referência ao identificador de pacote NuGet.

Para desinstalar um pacote de modelo, use o dotnet new uninstall {package-id} comando:

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

Pasta

Quando os modelos são instalados através de um caminho de pasta, o caminho da pasta torna-se o identificador do pacote de modelos.

Para desinstalar um pacote de modelo, use o dotnet new uninstall {package-folder-path} comando:

dotnet new uninstall c:\code\nuget-packages\some-folder

dotnet new uninstall /home/username/code/templates

Listar pacotes de modelos

Usando o comando default uninstall sem um identificador de pacote, você pode ver uma lista de pacotes de modelo instalados junto com o comando que desinstala cada pacote de modelo.

dotnet new uninstall
Currently installed items:

... cut to save space ...

  c:\code\nuget-packages\some-folder
    Templates:
      A Template Console Class (templateconsole) C#
      Project for some technology (contosoproject) C#
    Uninstall Command:
      dotnet new uninstall c:\code\nuget-packages\some-folder

Instalar pacotes de modelo de outros SDKs

Se você instalou cada versão do SDK sequencialmente, por exemplo, instalou o SDK 6.0, depois o SDK 7.0 e assim por diante, você terá todos os modelos do SDK instalados. No entanto, se você começar com uma versão posterior do SDK, como a 7.0, somente os modelos para essa versão serão incluídos. Modelos para qualquer outra versão não estão incluídos.

Os modelos .NET estão disponíveis no NuGet, e você pode instalá-los como qualquer outro modelo. Para obter mais informações, consulte Instalar o pacote NuGet hospedado.

Por exemplo, o SDK do .NET 9 inclui modelos para um aplicativo de console direcionado ao .NET 9. Se quisesses direcionar para o .NET Core 3.1, precisarias instalar o pacote de templates 3.1.

1. Tente criar um aplicativo destinado ao .NET Core 3.1.

   dotnet new console --framework netcoreapp3.1
   

   Se você vir uma mensagem de erro, instale os modelos na próxima etapa.

2. Instale os modelos de projeto do .NET Core 3.1.

   dotnet new install Microsoft.DotNet.Common.ProjectTemplates.3.1
   

3. Tente criar o aplicativo uma segunda vez.

   dotnet new console --framework netcoreapp3.1
   

   E você deve ver uma mensagem indicando que o projeto foi criado.

   The template "Console Application" was created successfully.
   
   Processing post-creation actions...
   Running 'dotnet restore' on path-to-project-file.csproj...
     Determining projects to restore...
     Restore completed in 1.05 sec for path-to-project-file.csproj.
   
   Restore succeeded.
   

Consulte também

• Tutorial: Criar um modelo de item
• dotnet new
• dotnet nuget add source