Sdílet prostřednictvím

Spuštění emulátoru rozhraní příkazového řádku Static Web Apps

  • Článek

Důležité

Kvůli zlepšení zabezpečení nasazení z rozhraní příkazového řádku Static Web Apps jsme zavedli zásadní změnu, která vyžaduje upgrade na nejnovější verzi rozhraní příkazového řádku Static Web Apps (2.0.2) od 15. ledna 2025.

Static Web Apps je cloudová platforma, která hostuje a spouští vaše webové aplikace. Když aplikaci spouštíte místně, potřebujete speciální nástroje, které vám pomůžou odhadnout, jak by aplikace běžela v cloudu.

Rozhraní příkazového řádku Static Web Apps (SWA CLI) zahrnuje emulátor, který napodobuje způsob spouštění vaší aplikace v Azure, ale místo toho běží výhradně na vašem počítači.

Příkaz swa start spustí emulátor s výchozím nastavením. Ve výchozím nastavení emulátor používá port 4280.

Další informace o jednotlivých příkazech najdete v referenčních informacích k rozhraní příkazového řádku.

Obsluha statických souborů ze systému souborů

Rozhraní příkazového řádku SWA umožňuje přímo obsluhovat statický obsah z vašeho systému souborů bez dalších požadovaných nástrojů. Můžete buď obsluhovat statický obsah z aktuálního adresáře, nebo konkrétní složky.

Obsluha od... Příkaz Notes
Aktuální složka swa start Ve výchozím nastavení se rozhraní příkazového řádku spustí a obsluhuje statický obsah (html, obrázek, skript a soubory CSS) z aktuálního pracovního adresáře.
Konkrétní složka swa start ./my-dist Chování můžete přepsat tak, aby se emulátor spustil s jinou složkou statických prostředků.

Použití vývojového serveru

Při vývoji front-endu aplikace můžete chtít použít výchozí vývojový server architektury. Použití serveru architektury umožňuje využívat výhody, jako je výměna živého opětovného načítání a výměny horkého modulu (HMR).

Vývojáři Angular například často používají ng serve nebo npm start spouštějí vývojový server.

Rozhraní příkazového řádku Static Web Apps SWA můžete nastavit na proxy požadavky na vývojový server, což vám dává výhody rozhraní příkazového řádku vaší architektury a současně pracovat se statickým rozhraním příkazového řádku Web Apps.

K použití vývojového serveru architektury spolu s rozhraním PŘÍKAZOVÉho řádku SWA existují dva kroky:

  1. Spusťte místní vývojový server vaší architektury obvyklým způsobem. Nezapomeňte si poznamenat adresu URL (včetně portu) používanou architekturou.

  2. Spusťte rozhraní příkazového řádku SWA v novém terminálu a předáte adresu URL vývojového serveru.

    swa start <DEV_SERVER_URL>

Poznámka:

Nezapomeňte zástupný symbol nahradit <DEV_SERVER_URL> vlastní hodnotou.

Spuštění vývojového serveru

Pracovní postup můžete dále zjednodušit tím, že rozhraní příkazového řádku SWA spustíte vývojový server za vás.

Do příkazu můžete předat vlastní příkaz --run swa start .

swa start <DEV_SERVER_URL> --run <DEV_SERVER_LAUNCH_COMMAND>

Tady je několik příkladů spuštění emulátoru s několika různými architekturami:

Framework Příkaz
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"

Parametr můžete použít --run také v případě, že chcete při spuštění vývojového serveru spustit vlastní skript.

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

Pomocí výše uvedeného příkazu můžete k aplikaci přistupovat pomocí emulovaných služeb z http://localhost:4280

Další kroky

Spuštění serveru rozhraní API