Compartilhar via

.NET Aspire Azure integração do emulador de Aplicativos Web Estáticos

  • Artigo

Inclui:integração de hospedagem não Client

Nota

Essa integração é parte do .NET.NET Aspire Community Toolkit e não é oficialmente suportada pela equipe do .NET.NET Aspire.

Neste artigo, você aprenderá a usar o emulador .NET.NET AspireAzure Aplicativos Web Estáticos integração de hospedagem para executar Azure Aplicativos Web Estáticos localmente usando o emulador. O emulador fornece suporte para intermediar tanto o front-end estático quanto o back-end da API utilizando recursos definidos na hospedagem do aplicativo.

Essa integração requer que a CLI Azure Aplicativos Web Estáticos seja executada e só dá suporte à hospedagem do emulador para desenvolvimento local, não à implantação em aplicativos Web estáticos Azure.

Integração de hospedagem

Para começar a integração de hospedagem do emulador de Aplicativos Web Estáticos .NET AspireAzure, instale o pacote NuGet 📦 CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps no projeto AppHost.

dotnet add package CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps

Para obter mais informações, consulte dotnet add package ou Gerenciar dependências de pacotes em aplicativos .NET.

Exemplo de uso

No arquivo Program.cs do projeto de host do aplicativo, defina os recursos de back-end e front-end. Em seguida, chame o método AddSwaEmulator para criar o emulador e passar os recursos usando os métodos WithAppResource e WithApiResource.

var builder = DistributedApplication.CreateBuilder(args);

// Define the API resource
var api = builder.AddProject<Projects.Aspire_CommunityToolkit_StaticWebApps_ApiApp>("api");

// Define the frontend resource
var web = builder
    .AddNpmApp("web", Path.Combine("..", "CommunityToolkit.Aspire.StaticWebApps.WebApp"), "dev")
    .WithHttpEndpoint(env: "PORT")
    .WithExternalHttpEndpoints();

// Create a SWA emulator with the frontend and API resources
_ = builder
    .AddSwaEmulator("swa")
    .WithAppResource(web)
    .WithApiResource(api);

builder.Build().Run();

O código anterior define a API e os recursos de front-end e cria um emulador com os recursos. Em seguida, o emulador é iniciado usando o método Run.

Consulte também