Compartilhar via

modelos de .NET.NET Aspire

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 .NET.NET Aspire templates estão disponíveis no 📦Aspire. pacote NuGet 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 .NET.NET Aspire modelos de solução estão disponíveis, suponha que a solução se chama AspireSample:

Modelos de projeto

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

  • .NET .NET Aspire Host do Aplicativo: um projeto autônomo .AppHost 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 .NET.NET Aspire aplicativo e são destinados 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 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, consulte Testando em .NET.NET Aspire.

  • .NET .NET Aspire Padrões de Serviço: um projeto independente .ServiceDefaults que pode ser usado para gerenciar configurações reutilizadas entre os projetos em sua solução relacionadas à resiliência, descoberta de serviço e 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 os padrões 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: .NET Aspire modelos.

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: .NET Aspire modelos.

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

Para criar uma .NET Aspire solução ou projeto usando a .NET CLI, 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 para a versão mais recente.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 .NET versão, use a opção --framework <tfm>, por exemplo, para criar um projeto de host de aplicativo básico .NET.NET Aspire direcionado para .NET 8:

dotnet new aspire-apphost --framework net8.0

Você precisa confiar no certificado ASP.NET Corelocalhost antes de executar o aplicativo. Execute o comando a seguir:

dotnet dev-certs https --trust

Para obter mais informações, consulte Solucionar problemas de certificado não confiável localhost em .NET Aspire. Para obter detalhes detalhados sobre como solucionar localhost problemas de certificados, Linuxconsulte ASP.NET Core: GitHub problema do repositório nº 32842.

Consulte também