Dela via

Starta CLI-emulatorn för Static Web Apps

  • Artikel

Viktigt!

För att förbättra säkerheten för distributioner från Static Web Apps CLI infördes en icke-bakåtkompatibel ändring som kräver att du uppgraderar till den senaste versionen (2.0.2) av Static Web Apps CLI senast den 15 januari 2025.

Static Web Apps är en molnbaserad plattform som är värd för och kör dina webbappar. När du kör appen lokalt behöver du särskilda verktyg som hjälper dig att uppskatta hur din app skulle köras i molnet.

Static Web Apps CLI (SWA CLI) innehåller en emulator som efterliknar hur din app skulle köras på Azure, men som i stället körs uteslutande på datorn.

Kommandot swa start startar emulatorn med standardinställningar. Som standard använder emulatorn port 4280.

Mer information om enskilda kommandon finns i CLI-referensen.

Hantera statiska filer från filsystemet

Med SWA CLI kan du direkt hantera ditt statiska innehåll från filsystemet utan några andra verktyg som krävs. Du kan antingen hantera det statiska innehållet från den aktuella katalogen eller en specifik mapp.

Servera från... Command Kommentar
Aktuell mapp swa start Som standard startar och hanterar CLI statiskt innehåll (HTML, bild, skript och CSS-filer) från den aktuella arbetskatalogen.
Specifik mapp swa start ./my-dist Du kan åsidosätta beteendet för att starta emulatorn med en annan mapp för statiska tillgångar.

Använda utvecklingsserver

När du utvecklar appens klientdel kanske du vill använda ramverkets standardutvecklingsserver. Med hjälp av ett ramverks server kan du dra nytta av fördelar som direktåterläsning och byte av frekventa moduler (HMR).

Till exempel använder ng serve eller npm start kör Angular-utvecklare ofta utvecklingsservern.

Du kan konfigurera Static Web Apps SWA CLI till proxybegäranden till utvecklingsservern, vilket ger dig fördelarna med både ramverkets CLI samtidigt som du arbetar med Static Web Apps CLI.

Det finns två steg för att använda ett ramverks utvecklingsserver tillsammans med SWA CLI:

  1. Starta ramverkets lokala utvecklingsserver som vanligt. Observera den URL (inklusive porten) som används av ramverket.

  2. Starta SWA CLI i en ny terminal och skicka in utvecklingsserverns URL.

    swa start <DEV_SERVER_URL>

Kommentar

Ersätt <DEV_SERVER_URL> platshållaren med ditt eget värde.

Starta utvecklingsservern

Du kan förenkla arbetsflödet ytterligare genom att låta SWA CLI starta utvecklingsservern åt dig.

Du kan skicka ett anpassat kommando till parametern --run till swa start kommandot .

swa start <DEV_SERVER_URL> --run <DEV_SERVER_LAUNCH_COMMAND>

Här är några exempel på hur du startar emulatorn med några olika ramverk:

Ramverk Command
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"

Du kan också använda parametern --run om du vill köra ett anpassat skript när du startar utvecklingsservern.

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

Med hjälp av kommandot ovan kan du komma åt programmet med de emulerade tjänsterna från http://localhost:4280

Nästa steg

Starta API-servern