Semana: experimente o Flutter Web com WebAssembly
Desbloqueie de 2x a 5x mais performance na web ativando hoje a compilação Wasm
O Flutter permite que você crie apps multiplataforma expressivos a partir de uma única base de código. Seja para construir um dashboard, uma ferramenta para a sua equipe ou uma aplicação web completa, o Flutter Web permite levar seu app para qualquer navegador.
De 17 a 21 de agosto, estamos realizando a Semana Try Flutter Web with WebAssembly! Ao longo da semana, engenheiros do Dart e do Flutter vão fazer a triagem de issues recebidas em tempo real para ajudar a desbloquear migrações, e nossa equipe de relações com desenvolvedores vai compartilhar suas conquistas nos canais da comunidade.
WebAssembly no Flutter Web
Estabilizamos o suporte a WebAssembly (Wasm) no Flutter 3.22, lá em maio de 2024, combinando o compilador do Dart com o WebAssembly Garbage Collection (WasmGC).
Desde então, a compilação para Wasm se provou em apps do mundo real. Por exemplo, o Dart DevTools (dartdevtools), um app web complexo e altamente interativo feito em Flutter, vem sendo entregue com WebAssembly por padrão desde o fim de 2024. Hoje, mais de 97% dos desenvolvedores que usam o DevTools o executam em Wasm, aproveitando a inspeção suave da UI, o carregamento rápido e uma estabilidade inabalável.
A compilação para Wasm é testada e aprovada, e está pronta para produção. De fato, nossa análise mostra que mais de 58% dos apps web existentes em Flutter compilam para WebAssembly hoje, sem nenhuma mudança de código.
Quando você compila para WebAssembly, seu app se beneficia tanto da aceleração do compilador (dart2wasm) quanto da renderização multithread (skwasm):
- ⚡ Até 2x mais rápido nos tempos de frame e 60 FPS sustentados: sob forte troca de widgets na árvore, em que o JavaScript cai para cerca de 30 FPS (tempo total de frame de 34.5 ms), o Wasm mantém a entrega suave de 60 FPS (tempo total de frame de 17.4 ms).
- ⚡ Até 2.5x mais rápido na construção e execução de widgets: estruturas nativas do WasmGC aceleram a lógica complexa da UI e as atualizações de estado, reduzindo o tempo de construção de widgets de 29.3 ms para 11.4 ms.
- ⚡ Rasterização em background multithread: o Skwasm descarrega a rasterização do canvas para um Web Worker dedicado, mantendo a thread principal do navegador livre para interações responsivas da UI.
- 🎯 Mais de 3x de consistência de frames mais suave: reduz o jitter dos frames de ±1.5 ms para ±0.5 ms, eliminando pausas de coleta de lixo.
- 📦 Mudança mínima no tamanho do bundle: o tamanho total do bundle da aplicação fica no máximo 5% maior, compactado na transferência pela rede.
Experimente você mesmo! Você pode testar e comparar a performance no seu próprio hardware usando nossa demo interativa em flutter-wasm-compare.web.app (código-fonte).
As métricas de benchmark acima foram medidas no Google Chrome 151 (151.0.7922.109) em um MacBook Pro com Apple M4 Pro (48 GB, macOS Sequoia 15.7.7), com taxa de atualização de tela limitada a 60 Hz, sob estresse médio (200 nós animados com alta troca).
Por que o JavaScript ainda é o compilador padrão
Se o Wasm entrega mais velocidade e estabilidade, por que flutter build web
ainda usa JavaScript como padrão (dart2js)?
Mudar o compilador padrão para milhões de desenvolvedores é uma decisão grande. Embora mais da metade dos apps web em Flutter já compile com Wasm por padrão, alguns pub.dev
pacotes ainda dependem de interop legado com JavaScript (dart:html ou dart:js) que precisa ser atualizado para compatibilidade com Wasm.
Isso cria um clássico dilema de ovo e galinha:
-
Não podemos tornar
--wasmo padrão até que mais pacotes do ecossistema atualizem seu código de interop com JS. - Os autores de pacotes costumam não priorizar a atualização até que os desenvolvedores optem pelo Wasm e solicitem suporte a Wasm.
Recursos para migração para WebAssembly
Para ajudar na migração, atualizamos nossa documentação web. Confira estes guias antes de começar:
-
WebAssembly no Flutter Web:
Aprenda a definir headers do servidor (
COEP: credentiallesseCOOP: same-origin), depurar builds de produção e detectar suporte a Wasm em tempo de execução. -
Migrando para
package:webe interop moderna com JS: Afastar-se dedart:htmledart:jsé essencial para a compatibilidade com Wasm. Este guia mostra como migrar parapackage:webedart:js_interop. - Guia de build e deploy para web: Encontre instruções para builds de release, source maps, Firebase Hosting e cache de CDN.
- FAQ técnico do Flutter Web: Obtenha respostas sobre web workers, service workers e imports condicionais.
Experimente o WebAssembly nesta semana
Seja você quem mantém um pacote pub.dev, gerencia um app web em produção ou tem projetos paralelos, teste seu código com WebAssembly nesta semana!
Começar
-
🚀 Atualize para o Flutter 3.47: execute
flutter upgradepara garantir que você está na versão estável mais recente, com as otimizações mais novas do WasmGC e as correções de runtime. -
⚙️ Compile com Wasm: execute
flutter build web --wasmno terminal do seu projeto. - 📝 Informe bloqueios: se encontrar problemas com dependências de pacotes ou no runtime, nos avise! Envie um relatório no formulário de feedback sobre Wasm do Flutter para que nossos engenheiros possam ajudar a desbloquear a migração.
- 🎉 Compartilhe suas conquistas: se seu app compilar sem erros e rodar mais rápido, conte para a gente! Compartilhe suas métricas e ganhos de framerate.
Ao postar nas redes sociais, use #FlutterWasmWeek para que possamos destacar seus resultados!
Construindo um futuro da web com Wasm por padrão
Ao testar seus apps e resolver as dependências de pacotes juntos esta semana, podemos abrir caminho para tornar o WebAssembly o compilador padrão do Flutter Web.
Execute flutter upgrade, experimente flutter build web --wasm e nos conte como foi!
