.NET .NET Aspire modelos

Artigo
12/14/2024

Há uma série de 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 .NET Aspire existentes.

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

Instalar os modelos de .NET.NET Aspire

Para instalar os modelos .NET Aspire no Visual Studio, você precisa instalá-los manualmente, a menos que esteja usando o Visual Studio 17.12 ou posterior. Para Visual Studio 17.9 a 17.11, siga estes passos:

Abra Visual Studio.
Vá para Ferramentas >Gestor de Pacotes NuGet>Console do Gestor de Pacotes.
Execute o seguinte comando para instalar os modelos:

dotnet new install Aspire.ProjectTemplates

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

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

dotnet new install Aspire.ProjectTemplates

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

dotnet new install Aspire.ProjectTemplates::9.0.0

Dica

Se já tiver a carga de trabalho .NET.NET Aspire instalada, deverá usar a opção --force para substituir os modelos existentes. Sinta-se à vontade para desinstalar a carga de trabalho .NET.NET Aspire.

Listar os modelos .NET.NET Aspire

Os modelos .NET Aspire são instalados automaticamente quando você instala o Visual Studio 17.9 ou posterior. Para ver quais modelos estão disponíveis, selecione Arquivo Novo Projetono e procure por "" na barra de pesquisa (AltS). Você verá uma lista de modelos de projeto .NET.NET Aspire disponíveis:

Para exibir os modelos disponíveis em com o C# DevKit instalado, selecione o botão Create Project quando nenhuma pasta for aberta na visualização do Explorer:

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

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

dotnet new list aspire

A saída do console deve ter a seguinte aparência:

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 .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 de .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 nomeada AspireSample:

.NET .NET Aspire aplicação vazia: um projeto mínimo de .NET.NET Aspire que inclui o seguinte:
- AspireSample.AppHost: Um projeto orquestrador projetado para conectar e configurar os diferentes projetos e serviços do seu aplicativo.
- AspireSample.ServiceDefaults: um projeto partilhado .NET.NET Aspire para gerir configurações que são reutilizadas nos projetos na sua solução, relacionadas com resiliência, descoberta de serviçoe telemetria.

.NET .NET Aspire Starter App: Além dos projetos .AppHost e .ServiceDefaults, o .NET.NET Aspire Starter App também inclui o seguinte:
- AspireSample.ApiService: Um projeto de de API mínima de é usado para fornecer dados ao frontend. Este projeto depende do projeto compartilhado AspireSample.ServiceDefaults.
- AspireSample.Web: Um projeto de aplicativo com configurações de serviço padrão, este projeto depende do projeto AspireSample.ServiceDefaults.
- AspireSample.Test: um MSTest, NUnitou projeto de teste de xUnit com referências de projeto para o AspireSample.AppHost e um arquivo de WebTests.cs de exemplo demonstrando um teste de integração.

Modelos de projeto

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

.NET .NET Aspire App Host: Uma independente . AppHost projeto que pode ser usado para orquestrar e gerenciar os diferentes projetos e serviços do 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 destinam-se 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 MSTest de um projeto .NET.NET Aspire AppHost.
- NUnit: Um projeto que contém a integração NUnit de um projeto .NET.NET Aspire AppHost.
- xUnit: Um projeto que contém a integração do xUnit.net de um projeto .NET.NET Aspire AppHost.
Para obter mais informações sobre os modelos de teste, consulte Testing in .NET.NET Aspire.

.NET .NET Aspire Service Defaults: Um autônomo . ServiceDefaults projeto que pode ser usado para gerenciar configurações que são reutilizadas em todos os projetos em sua solução relacionados a resiliência, de descoberta de serviço e telemetria.

Importante

O modelo de projeto padrão de serviço assume uma dependência de 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.

Crie 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-a nos modelos disponíveis. Explore templates adicionais de .NET.NET Aspire no repositório de exemplos .NET.NET Aspire.

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

Siga as instruções para configurar seu projeto ou solução a partir do modelo e selecione Criar.

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

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

Para criar uma solução ou projeto .NET Aspire usando a CLI .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 para a versão .NET mais recente:

dotnet new aspire-apphost

Para criar uma aplicação inicial .NET.NET Aspire, que é uma solução completa com uma interface de utilizador de exemplo e API subjacente incluída:

dotnet new aspire-starter

Dica

.NET Aspire modelos por padrão usam a versão .NET mais recente, mesmo ao utilizar 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 para .NET 8:

dotnet new aspire-apphost --framework net8.0

Partilhar via