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.

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 projeto de host de aplicativo básico .NET.NET Aspire 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 projeto de host de aplicativo básico .NET.NET Aspire direcionado à versão .NET 8.

dotnet new aspire-apphost --framework net8.0

Consulte também