Delen via

De CLI-emulator van Static Web Apps starten

  • Artikel

Belangrijk

Om de beveiliging van implementaties van de Static Web Apps CLI te verbeteren, is er een belangrijke wijziging geïntroduceerd waarvoor u moet upgraden naar de nieuwste versie (2.0.2) van de Static Web Apps CLI op 15 januari 2025.

Static Web Apps is een cloudplatform dat uw web-apps host en uitvoert. Wanneer u uw app lokaal uitvoert, hebt u speciale hulpprogramma's nodig om u te helpen bij benadering hoe uw app in de cloud zou worden uitgevoerd.

De Static Web Apps CLI (SWA CLI) bevat een emulator die nabootst hoe uw app wordt uitgevoerd in Azure, maar wordt in plaats daarvan uitsluitend op uw computer uitgevoerd.

Met swa start de opdracht wordt de emulator gestart met standaardinstellingen. De emulator maakt standaard gebruik van poort 4280.

Zie de CLI-verwijzing voor meer informatie over afzonderlijke opdrachten.

Statische bestanden uit uw bestandssysteem leveren

Met de SWA CLI kunt u uw statische inhoud rechtstreeks vanuit uw bestandssysteem leveren zonder andere vereiste hulpprogramma's. U kunt de statische inhoud uit uw huidige map of een specifieke map leveren.

Serveren vanaf... Opdracht Opmerkingen
Huidige map swa start De CLI wordt standaard gestart en verwerkt statische inhoud (HTML-, afbeeldings-, script- en CSS-bestanden) uit de huidige werkmap.
Specifieke map swa start ./my-dist U kunt het gedrag overschrijven om de emulator te starten met een andere map met statische assets.

Ontwikkelserver gebruiken

Wanneer u de front-end van uw app ontwikkelt, kunt u de standaardontwikkelingsserver van het framework gebruiken. Met behulp van de server van een framework kunt u profiteren van voordelen zoals live opnieuw laden en hot module-vervanging (HMR).

Angular-ontwikkelaars gebruiken ng serve bijvoorbeeld vaak of npm start om de ontwikkelserver uit te voeren.

U kunt de STATIC Web Apps SWA CLI instellen voor proxyaanvragen naar de dev-server, wat u de voordelen biedt van de CLI van uw framework terwijl u tegelijkertijd met static Web Apps CLI werkt.

Er zijn twee stappen voor het gebruik van de ontwikkelserver van een framework, samen met de SWA CLI:

  1. Start de lokale ontwikkelserver van uw framework zoals gebruikelijk. Noteer de URL (inclusief de poort) die door het framework wordt gebruikt.

  2. Start de SWA CLI in een nieuwe terminal, waarbij de URL van de dev-server wordt doorgegeven.

    swa start <DEV_SERVER_URL>

Notitie

Zorg ervoor dat u de <DEV_SERVER_URL> tijdelijke aanduiding vervangt door uw eigen waarde.

Dev-server starten

U kunt uw werkstroom verder vereenvoudigen door de SWA CLI de dev-server voor u te laten starten.

U kunt een aangepaste opdracht doorgeven aan de --run parameter aan de swa start opdracht.

swa start <DEV_SERVER_URL> --run <DEV_SERVER_LAUNCH_COMMAND>

Hier volgen enkele voorbeelden van het starten van de emulator met een aantal verschillende frameworks:

Framework Opdracht
React swa start http://localhost:3000 --run "npm start"
Blazor swa start http://localhost:5000 --run "dotnet watch run"
Jekyll swa start http://localhost:4000 --run "jekyll serve"

U kunt de --run parameter ook gebruiken als u een aangepast script wilt uitvoeren wanneer u de dev-server start.

swa start http://localhost:4200 --run "./startup.sh"

Met behulp van de bovenstaande opdracht hebt u toegang tot de toepassing met de geëmuleerde services van http://localhost:4280

Volgende stappen

De API-server starten