Freigeben über

.NET Aspire Azure Integration des Emulators für statische Web-Apps

Beinhaltet:Hosting-Integration enthalten Nur Hosting-Integration — Client Integration nicht enthaltenClient Integration nicht enthalten

Anmerkung

Diese Integration ist Teil des .NET.NET Aspire Community Toolkit und .NET Aspire unterstützt.

In diesem Artikel erfahren Sie, wie Sie die .NET.NET AspireAzure Hosting-Integration des Emulators für Static Web Apps verwenden, um Azure Static Web Apps lokal mithilfe des Emulators auszuführen. Der Emulator unterstützt das Proxying sowohl des statischen Frontends als auch des API-Backends mit Ressourcen, die im App-Host definiert sind.

Für diese Integration ist die Azure Static Web Apps CLI erforderlich. Sie unterstützt nur das Hosten des Emulators für die lokale Entwicklung und nicht die Bereitstellung in Azure Static Web Apps.

Hosting-Integration

Um mit der Integration des .NET AspireAzure Static Web Apps-Emulators zu beginnen, installieren Sie das 📦 CommunityToolkit.Aspire.Hosting.Azure.StaticWebApps NuGet-Paket im AppHost-Projekt.

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

Weitere Informationen finden Sie unter dotnet add package oder Verwalten von Paketabhängigkeiten in .NET-Anwendungen.

Anwendungsbeispiel

Definieren Sie in der Program.cs Datei Ihres App-Hostprojekts die Back-End- und Frontend-Ressourcen. Rufen Sie dann die AddSwaEmulator-Methode auf, um den Emulator zu erstellen, und übergeben Sie die Ressourcen mithilfe der methoden WithAppResource und 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();

Der vorangehende Code definiert die API- und Frontend-Ressourcen und erstellt einen Emulator mit den Ressourcen. Der Emulator wird dann mit der Run-Methode gestartet.

Siehe auch