Compartilhar via

modelos de .NET.NET Aspire

  • Artigo

Há vários modelos de projeto .NET.NET Aspire disponíveis para você. Você pode usar esses modelos para criar soluções de .NET Aspire completas ou adicionar projetos individuais a soluções de .NET Aspire existentes.

Os modelos de .NET.NET Aspire estão disponíveis no pacote NuGet 📦Aspire.ProjectTemplates.

Instalar os modelos de .NET.NET Aspire

Para instalar os modelos de .NET Aspire no Visual Studio, você precisará instalá-los manualmente, a menos que esteja usando Visual Studio 17.12 ou posterior. Para Visual Studio 17.9 a 17.11, siga estas etapas:

  1. Abra Visual Studio.
  2. Vá para Tools>NuGet Package Manager>Console do Gerenciador de Pacotes.
  3. Execute o seguinte comando para instalar os modelos:
dotnet new install Aspire.ProjectTemplates

Para Visual Studio 17.12 ou posterior, os modelos de .NET Aspire são instalados automaticamente.

Para instalar esses modelos, utilize o comando dotnet new install, passando o identificador do NuGet Aspire.ProjectTemplates.

dotnet new install Aspire.ProjectTemplates

Para instalar uma versão específica, acrescente o número de versão ao nome do pacote:

dotnet new install Aspire.ProjectTemplates::9.0.0

Dica

Se você já tiver a carga de trabalho .NET.NET Aspire instalada, precisará passar o sinalizador --force para substituir os modelos existentes. Fique à vontade para desinstalar a workload .NET.NET Aspire.

Liste os modelos .NET.NET Aspire

Os modelos de .NET Aspire são instalados automaticamente quando você instala o Visual Studio 17.9 ou posterior. Para ver quais modelos de .NET.NET Aspire estão disponíveis, selecione Arquivo>Novo>Projeto no Visual Studioe pesquise "Aspire" no campo de busca (Alt+S). Você verá uma lista de modelos de projeto de .NET.NET Aspire disponíveis:

Visual Studio: crie um novo projeto e pesquise 'Aspire'.

Para exibir os modelos disponíveis no com o Kit de Desenvolvimento do C# instalado, selecione o botão Criar Projeto quando nenhuma pasta for aberta no modo de exibição do Explorer :

Visual Studio Code: botão Criar Projeto .NET.

Em seguida, pesquise "Aspire" na barra de pesquisa para ver os modelos de projeto de .NET Aspire disponíveis:

Visual Studio Code: crie um novo projeto e pesquise 'Aspire'.

Para verificar se os modelos de .NET.NET Aspire estão instalados, use o comando nova lista dotnet, passando o nome do modelo aspire:

dotnet new list aspire

A saída do console deve ser semelhante à seguinte:

dotnet new list aspire
These templates matched your input: 'aspire'

Template Name                      Short Name              Language  Tags
---------------------------------  ----------------------  --------  -------------------------------------------------------
.NET Aspire App Host               aspire-apphost          [C#]      Common/.NET Aspire/Cloud
.NET Aspire Empty App              aspire                  [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service
.NET Aspire Service Defaults       aspire-servicedefaults  [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service
.NET Aspire Starter App            aspire-starter          [C#]      Common/.NET Aspire/Blazor/Web/Web API/API/Service/Cloud
.NET Aspire Test Project (MSTest)  aspire-mstest           [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
.NET Aspire Test Project (NUnit)   aspire-nunit            [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
.NET Aspire Test Project (xUnit)   aspire-xunit            [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test

Modelos disponíveis

Os modelos de .NET Aspire permitem criar novos aplicativos pré-configurados com a estrutura de soluções .NET Aspire e as configurações padrão. Esses projetos também fornecem uma experiência de depuração unificada entre os diferentes recursos do seu aplicativo.

.NET .NET Aspire modelos estão disponíveis em duas categorias: modelos de solução e modelos de projeto. Os modelos de solução criam uma nova solução .NET Aspire com vários projetos, enquanto os modelos de projeto criam projetos individuais que podem ser adicionados a uma solução de .NET Aspire existente.

Modelos de solução

Os seguintes modelos de solução .NET.NET Aspire estão disponíveis, suponha que a solução seja denominada AspireSample:

  • .NET .NET Aspire Aplicativo Vazio: um projeto .NET.NET Aspire mínimo que inclui o seguinte:

    • AspireSample.AppHost: um projeto de orquestrador projetado para conectar e configurar os diferentes projetos e serviços do seu aplicativo.
    • AspireSample.ServiceDefaults: um projeto compartilhado .NET.NET Aspire para gerenciar configurações reutilizadas em projetos em sua solução, relacionadas à resiliência , à descoberta de serviço , e à telemetria .

Modelos de projeto

Os seguintes modelos de projeto .NET.NET Aspire estão disponíveis:

  • .NET .NET Aspire Host do Aplicativo: um projeto .AppHost autônomo que pode ser usado para orquestrar e gerenciar diferentes projetos e serviços de seu aplicativo.

  • .NET .NET Aspire Projetos de teste: esses modelos de projeto são usados para criar projetos de teste para seu aplicativo .NET.NET Aspire e eles se destinam a representar testes funcionais e de integração. Os projetos de teste incluem os seguintes modelos:

    • MSTest: um projeto que contém a integração do MSTest de um projeto AppHost .NET.NET Aspire.
    • NUnit: um projeto que contém a integração do NUnit para um projeto .NET.NET Aspire AppHost.
    • xUnit: um projeto que contém a integração do xUnit.net de um projeto AppHost .NET.NET Aspire.

    Para obter mais informações sobre os modelos de teste, veja Testing em .NET.NET Aspire.

  • .NET .NET Aspire Service Defaults: um projeto autônomo .ServiceDefaults que pode ser usado para gerenciar configurações reutilizadas relacionadas aos projetos em sua solução, referentes à de resiliência, de descoberta de serviço e de telemetria.

    Importante

    O modelo de projeto padrão do serviço usa uma dependência FrameworkReference em Microsoft.AspNetCore.App. Isso pode não ser ideal para alguns tipos de projeto. Para obter mais informações, consulte .NET.NET Aspire configurações padrão de serviço.

Criar soluções e projetos usando modelos

Para criar uma solução ou projeto .NET Aspire, use Visual Studio, Visual Studio Codeou a CLI .NET e baseie-o nos modelos disponíveis. Explore modelos adicionais de no repositório de exemplos .

Para criar um projeto .NET Aspire usando Visual Studio, pesquise Aspire na janela Visual Studio novo projeto e selecione o modelo desejado.

Visual Studio: modelos de .NET Aspire.

Siga os prompts para configurar seu projeto ou solução a partir do modelo e selecione Criar.

Para criar um projeto .NET Aspire usando Visual Studio Code, pesquise Aspire na janela Visual Studio Code novo projeto e selecione o modelo desejado.

Visual Studio Code: modelos de .NET Aspire.

Selecione o local desejado, insira um nome e selecione Criar.

Para criar uma solução ou projeto .NET Aspire usando a CLI do .NET, use o comando dotnet new e especifique qual modelo você gostaria de criar. Considere os seguintes exemplos:

Para criar um host de aplicativo .NET.NET Aspire básico projeto direcionado à versão mais recente do .NET:

dotnet new aspire-apphost

Para criar um aplicativo inicial .NET.NET Aspire, que é uma solução completa com uma interface do usuário de exemplo e uma API de suporte incluída:

dotnet new aspire-starter

Dica

Os modelos .NET Aspire geralmente usam a versão mais recente do .NET, mesmo quando se utiliza uma versão anterior do CLI .NET. Para especificar manualmente a versão .NET, use a opção --framework <tfm>, por exemplo, para criar um host de aplicativo .NET.NET Aspire básico projeto direcionado .NET 8:

dotnet new aspire-apphost --framework net8.0

Consulte também