Iniciar o emulador da CLI de Aplicativos Web Estáticos
Importante
Para melhorar a segurança das implantações da CLI de Aplicativos Web Estáticos, foi introduzida uma alteração interruptiva que exige que você atualize para a versão mais recente (2.0.2) da CLI de Aplicativos Web Estáticos até 15 de janeiro de 2025.
Os Aplicativos Web Estáticos são uma plataforma baseada em nuvem que hospeda e executa seus aplicativos Web. Quando você executa seu aplicativo localmente, precisa de ferramentas especiais para ajudá-lo a prever como seu aplicativo seria executado na nuvem.
A CLI de Aplicativos Web Estáticos (CLI de SWA) inclui um emulador que imita como seu aplicativo seria executado no Azure, mas, em vez disso, é executado exclusivamente em seu computador.
O comando swa start inicia o emulador com configurações padrão. Por padrão, o emulador usa a porta 4280.
Para obter mais informações sobre comandos individuais, consulte a referência da CLI.
Servir arquivos estáticos do sistema de arquivos
A CLI de SWA permite que você veicule diretamente o conteúdo estático do sistema de arquivos sem precisar de outras ferramentas. Você pode veicular o conteúdo estático do diretório atual ou de uma pasta específica.
| Veicular de... | Comando | Observações |
|---|---|---|
| Pasta atual | swa start |
Por padrão, a CLI inicia e veicula conteúdo estático (HTML, imagem, script e arquivos CSS) do diretório de trabalho atual. |
| Pasta específica | swa start ./my-dist |
Você pode substituir o comportamento para iniciar o emulador com uma pasta de ativos estáticos diferente. |
Usar o servidor de desenvolvimento
Ao desenvolver o front-end do aplicativo, talvez você queira usar o servidor de desenvolvimento padrão da estrutura. O uso do servidor de uma estrutura permite que você aproveite os benefícios, como a recarga dinâmica e a substituição do módulo dinâmico (HMR).
Por exemplo, os desenvolvedores angulares geralmente usam ng serve ou npm start para executar o servidor de desenvolvimento.
Você pode configurar a CLI de SWA de Aplicativos Web Estáticos para fazer solicitações de proxy para o servidor de desenvolvimento, o que lhe dá os benefícios da CLI da estrutura e, ao mesmo tempo, trabalha com a CLI de Aplicativos Web Estáticos.
Há duas etapas para usar o servidor de desenvolvimento de uma estrutura junto com a CLI de SWA:
Inicie o servidor de desenvolvimento local da estrutura como de costume. Observe a URL (incluindo a porta) usada pela estrutura.
Inicie a CLI de SWA em um novo terminal, passando a URL do servidor de desenvolvimento.
swa start <DEV_SERVER_URL>
Observação
Certifique-se de substituir o espaço reservado <DEV_SERVER_URL> pelo seu próprio valor.
Iniciar servidor de desenvolvimento
Você pode simplificar ainda mais o fluxo de trabalho fazendo com que a CLI de SWA inicie o servidor de desenvolvimento para você.
Você pode passar um comando personalizado para o parâmetro --run para o comando swa start.
swa start <DEV_SERVER_URL> --run <DEV_SERVER_LAUNCH_COMMAND>
Aqui estão alguns exemplos de como iniciar o emulador com algumas estruturas diferentes:
| Estrutura | 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" |
Você também pode usar o parâmetro --run se quiser executar um script personalizado ao iniciar o servidor de desenvolvimento.
swa start http://localhost:4200 --run "./startup.sh"
Usando o comando acima, você pode acessar o aplicativo com os serviços emulados de http://localhost:4280