Avviare l'emulatore dell'interfaccia della riga di comando di App Web statiche
Importante
Per migliorare la sicurezza delle distribuzioni dall'interfaccia della riga di comando di App Web statiche, è stata introdotta una modifica di rilievo che richiede l'aggiornamento alla versione più recente (2.0.2) dell'interfaccia della riga di comando di App Web statiche entro il 15 gennaio 2025.
App Web statiche è una piattaforma basata sul cloud che ospita ed esegue le app Web. Quando si esegue l'app in locale, sono necessari strumenti speciali che consentono di approssimare la modalità di esecuzione dell'app nel cloud.
L'interfaccia della riga di comando di App Web statiche include un emulatore che simula la modalità di esecuzione dell'app in Azure, ma viene invece eseguito esclusivamente nel computer.
Il swa start comando avvia l'emulatore con le impostazioni predefinite. Per impostazione predefinita, l'emulatore usa la porta 4280.
Per altre informazioni sui singoli comandi, vedere le informazioni di riferimento sull'interfaccia della riga di comando.
Gestire i file statici dal file system
L'interfaccia della riga di comando di SWA consente di gestire direttamente il contenuto statico dal file system senza altri strumenti necessari. È possibile gestire il contenuto statico dalla directory corrente o da una cartella specifica.
| Servire da... | Comando | Note |
|---|---|---|
| Cartella corrente | swa start |
Per impostazione predefinita, l'interfaccia della riga di comando avvia e gestisce contenuto statico (file HTML, immagine, script e CSS) dalla directory di lavoro corrente. |
| Cartella specifica | swa start ./my-dist |
È possibile eseguire l'override del comportamento per avviare l'emulatore con una cartella di asset statici diversa. |
Usare il server di sviluppo
Durante lo sviluppo del front-end dell'app, è possibile usare il server di sviluppo predefinito del framework. L'uso del server di un framework consente di sfruttare i vantaggi offerti, ad esempio il ricaricamento in tempo reale e la sostituzione di moduli ad accesso frequente (HMR).
Ad esempio, gli sviluppatori Angular usano ng serve spesso o npm start per eseguire il server di sviluppo.
È possibile configurare l'interfaccia della riga di comando di SWA App Web statiche per eseguire il proxy delle richieste al server di sviluppo, che offre i vantaggi offerti dall'interfaccia della riga di comando del framework contemporaneamente con App Web statiche interfaccia della riga di comando.
Esistono due passaggi per usare il server di sviluppo di un framework insieme all'interfaccia della riga di comando di SWA:
Avviare il server di sviluppo locale del framework come di consueto. Assicurarsi di annotare l'URL (inclusa la porta) usato dal framework.
Avviare l'interfaccia della riga di comando di SWA in un nuovo terminale, passando l'URL del server di sviluppo.
swa start <DEV_SERVER_URL>
Nota
Assicurarsi di sostituire il <DEV_SERVER_URL> segnaposto con il proprio valore.
Avviare il server di sviluppo
È possibile semplificare ulteriormente il flusso di lavoro facendo in modo che l'interfaccia della riga di comando di SWA avvii automaticamente il server di sviluppo.
È possibile passare un comando personalizzato al --run parametro al swa start comando .
swa start <DEV_SERVER_URL> --run <DEV_SERVER_LAUNCH_COMMAND>
Ecco alcuni esempi di avvio dell'emulatore con alcuni framework diversi:
| Framework | Comando |
|---|---|
| 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" |
È anche possibile usare il --run parametro se si vuole eseguire uno script personalizzato durante l'avvio del server di sviluppo.
swa start http://localhost:4200 --run "./startup.sh"
Usando il comando precedente, è possibile accedere all'applicazione con i servizi emulati da http://localhost:4280