Novidades do Flutter 3.47
Modular por design: pacotes de UI independentes e Impeller no Desktop
O Flutter 3.47 chegou e, com ele, temos algumas novidades empolgantes.
Hoje, damos as boas-vindas ao lançamento 1.0 dos pacotes independentes
material_ui e
cupertino_ui. Este é um marco importante, pois desacopla os design systems do SDK principal.
Também estamos impulsionando desempenho e ferramentas em todas as frentes. Esta versão traz o Impeller para o desktop por padrão, prepara nossos pipelines para iOS, macOS e Xcode 27, e torna os Flutter Widget Previews estáveis.
Então, execute flutter upgrade no seu terminal para começar,
ou continue lendo para saber mais sobre as principais mudanças desta versão.
Escolha sua própria aventura de UI
O primeiro passo rumo a um Flutter desacoplado chegou: Material e Cupertino agora estão disponíveis como pacotes independentes!
Um dos maiores pontos fortes do Flutter é a capacidade de renderizar widgets Material e Cupertino com pixel perfeito. No entanto, como essas bibliotecas de design eram historicamente embutidas diretamente no SDK principal, isso desacelerava o desenvolvimento delas e dificultava a contribuição ou a atualização.
Embora o SDK principal ainda inclua essas bibliotecas nesta versão,
agora você pode optar pelos pacotes independentes material_ui e cupertino_ui
que atingiram oficialmente a versão 1.0 em pub.dev.
Roadmaps de design desacoplados (opt-in)
Ao optar pelos design systems desacoplados, você ganha controle sobre o seu roadmap de design. Como material_ui
e cupertino_ui agora vivem em pub.dev, eles podem lançar correções de bugs e novos componentes em seus próprios cronogramas semanais, independentemente das versões trimestrais do SDK do Flutter.
Desacoplar os design systems nos traz os seguintes benefícios:
- Você pode usar os estilos mais recentes de widgets Cupertino e Material sem ser obrigado a atualizar toda a sua versão do SDK do Flutter.
- Podemos incorporar contribuições e atualizações de forma mais rápida e frequente.
- Preparamos o terreno para um catálogo de widgets principal do Flutter neutro em estilo, facilitando a criação de design systems personalizados no futuro.
Como migrar
Para migrar seu projeto para os novos pacotes independentes, execute o seguinte comando:
dart fix --apply --code=migrate_design_widgets
Esta ferramenta atualiza automaticamente seus imports
de package:flutter/material.dart e package:flutter/cupertino.dart
para os novos pacotes independentes.
Observação: se a ferramenta de migração encontrar problemas ao atualizar seus
pubspec.yaml(um bug conhecido do início), você pode resolver manualmente executandoflutter pub add material_ui(ecupertino_ui, se você usar) e depois executandodart fix --applymais uma vez.
As bibliotecas de design originais dentro do SDK principal estão programadas para descontinuação formal na próxima versão estável de outono, em novembro. Se você estiver migrando um pacote do ecossistema, trate essa mudança para os pacotes independentes como uma versão major.
Preenchendo a lacuna da migração
Para ajudar a preencher a lacuna enquanto o ecossistema migra para as novas bibliotecas de design independentes, material_ui e cupertino_ui vêm com utilitários de migração. O MaterialUiCompatibilityBridge permite que sua aplicação migre para os pacotes independentes imediatamente, mesmo que algumas das dependências de pacotes ainda usem imports legados do SDK principal.
Por exemplo, você pode envolver seu app na ponte de compatibilidade:
import 'package:material_ui/material_ui.dart';
void main() {
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
return MaterialApp(
theme: ThemeData(
colorScheme: ColorScheme.fromSeed(seedColor: const Color(0xFF6750A4)),
),
builder: (BuildContext context, Widget? child) {
return MaterialUiCompatibilityBridge(child: child!);
},
home: const HomeScreen(),
);
}
}
Localizações desacopladas
Como parte dessa transição, flutter_localizations também foi desempacotado. Os delegates de localização e as strings traduzidas para os widgets Material e Cupertino agora ficam dentro de package:material_ui e package:cupertino_ui, respectivamente.
Antes:
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:flutter/material.dart';
// ...
localizationsDelegates: const <LocalizationsDelegate<dynamic>>[
GlobalCupertinoLocalizations.delegate,
GlobalMaterialLocalizations.delegate,
GlobalWidgetsLocalizations.delegate,
],
Depois:
import 'package:material_ui/material_ui.dart';
// ...
localizationsDelegates: GlobalMaterialLocalizations.delegates,
Definir localizationsDelegates como GlobalMaterialLocalizations.delegates
agora inclui também os delegates de Cupertino e Widgets, simplificando sua configuração.
Aberto para contribuições
Ao congelar as contribuições para as bibliotecas Material e Cupertino lá em abril,
conseguimos garantir uma migração tranquila. As bibliotecas que esperam por você em material_ui e cupertino_ui
são as mesmas bibliotecas que você já está usando.
Agora que estamos prontos para suspender o congelamento, fique de olho em mais correções e recursos sendo lançados regularmente nos novos pacotes, com versões previstas para sair semanalmente. Também estamos animados para abrir oficialmente esses pacotes para contribuições da comunidade.
Preparando a próxima onda de atualizações da Apple
Com o Xcode 27, o iOS 27 e o macOS 27 chegando neste outono, concentramos muitos esforços em garantir que o Flutter esteja pronto para as próximas atualizações. Para que seus usuários não tenham surpresas no primeiro dia, recomendamos testar seus apps com as betas da Apple agora.
Além disso, para oferecer suporte ao Xcode 27, as versões mínimas de sistema operacional foram aumentadas:
| Plataforma | Mínimo anterior | Novo mínimo (Flutter 3.47+) |
|---|---|---|
| iOS | 13 | 15 |
| macOS | 10.15 | 12 |
Obrigatoriedade do ciclo de vida UIScene
O iOS 27 SDK agora torna obrigatório o ciclo de vida UIScene para todos os apps baseados em UIKit. Apps criados com o Xcode 27 que não adotarem UIScene não vão abrir na inicialização.
Para a maioria dos apps, a CLI do Flutter faz essa migração automaticamente durante o build. No entanto, a migração manual é necessária se você tiver código nativo personalizado no seu AppDelegate ou usar plugins que ainda dependam do ciclo de vida legado do aplicativo. Nesses casos, você deve migrar manualmente seguindo o Guia de adoção de UIScene/Delegate.
Descontinuando os Macs Intel
Alinhado à transição da Apple para o Apple Silicon, o Flutter está encerrando o suporte aos Macs com processador Intel. Desativamos as execuções automáticas de testes em hardware Intel, e a CLI do Flutter agora exibe avisos ao fazer build em hosts Intel ou ao gerar binários para duas arquiteturas. Esses avisos vão se tornar erros em uma versão futura.
Você pode optar por gerar apps macOS somente ARM64 imediatamente executando flutter config --enable-macos-arm64-only.
Progresso do Swift Package Manager
A comunidade fez um progresso incrível na transição para o Swift Package Manager, com 92 dos 100 principais plugins iOS já migrados. Se você desativou o Swift Package Manager antes, pode tentar novamente executando flutter config --enable-swift-package-manager.
Como o CocoaPods agora está em modo de manutenção, os plugins que não migrarem para o SwiftPM eventualmente deixarão de funcionar. Plugins não migrados também recebem pontuações pub.dev mais baixas. Se você mantém um plugin, consulte o Guia de migração
e leia nosso post anterior no blog
para mais detalhes.
Esta versão também traz tempos de build otimizados, graças ao colaborador da comunidade @lukemmtt, que melhorou os pipelines de build ao filtrar cedo, no processo de build, os schemes de pacotes SwiftPM desnecessários (#186006).
Definindo o Wasm como padrão
Estamos trabalhando ativamente para habilitar o WebAssembly (Wasm) por padrão em aplicações web Flutter, trazendo desempenho nativo para o navegador. Se você ainda não testou seus apps web com Wasm, pode optar por usá-lo hoje passando a flag --wasm para o comando do seu build de release:
flutter build web --release --wasm
Ao se preparar para essa transição, lembre-se de que o Wasm exige migrar sua base de código para o novo pacote de interop JS
(package:web), já que a biblioteca legada dart:html não é suportada. Atualizar as dependências de pacotes do seu projeto costuma resolver esses problemas de interop legados automaticamente.
Para ajudar a escalar aplicações web maiores, esta versão também introduz suporte experimental a carregamento tardio (deferred loading) no Wasm. Disponível sob uma flag no canal main, isso permite dividir sua aplicação Wasm em módulos menores, carregados sob demanda, otimizando os tempos de carregamento inicial:
flutter build web --release --wasm --enable-wasm-deferred-loading
Gráficos modernos chegam ao desktop com o Impeller
Estamos comprometidos em tornar as plataformas desktop alvos de primeira classe para gráficos de alto desempenho. No Flutter 3.47, o Impeller se torna o renderizador padrão para macOS, Windows e Linux.
Se você é novo no Impeller, saiba que ele é o mecanismo de renderização de próxima geração do Flutter, construído do zero para substituir o Skia. Ao mirar APIs de hardware modernas (como Metal no macOS e Vulkan no Windows e Linux), o Impeller compila um conjunto fixo de shaders em tempo de build, em vez de compilá-los dinamicamente em tempo de execução. Isso elimina a breve trepidação chamada jank de compilação de shaders, que acontece na primeira vez em que uma animação é reproduzida, e entrega transições consistentemente suaves desde o primeiro frame. Saiba mais na documentação do mecanismo de renderização Impeller.
Se você precisar desativar temporariamente o Impeller, siga estes passos:
- macOS: defina
FLTEnableImpellercomofalseemInfo.plist. -
Windows: adicione
project.set_impeller_switch(flutter::ImpellerSwitch::Disabled)emmain.cpp. -
Linux: chame
fl_dart_project_set_enable_impeller(project, FALSE)emmy_application.cc.
As opções de fallback serão removidas em uma versão futura, então registre bugs caso precise voltar a usar o Skia. Além disso, o Wide Gamut Color agora está ativo por padrão no macOS, entregando renderização de cores ricas, vibrantes e precisas em hardware compatível.
Multi-janela experimental em andamento
Em parceria com a Canonical, e graças aos mantenedores @robert-ancell e @mattkae, estamos expandindo nossas APIs experimentais de janelas para desktop. Linux e Windows agora oferecem suporte a janelas pop-up (#185866, #184516), permitindo criar menus de contexto nativos e paletas utilitárias.
Você também pode consultar agora windowHandle nos controladores específicos de plataforma para obter um ponteiro direto para a janela nativa subjacente
(HWND, NSWindow ou GtkWindow). Isso possibilita acesso avançado a recursos nativos, como painéis acopláveis no Windows, como esta demonstração de painéis acopláveis contribuída por
@orestesgaolin:
Também resolvemos vários bugs de foco e de realização de janelas. No Windows, ativar uma janela não traz mais as janelas em segundo plano para frente nem rouba o foco de volta ao retomar o app, graças ao colaborador @9AZX (#188016):
No Linux, a criação de múltiplas janelas agora realiza explicitamente as janelas antes que elas recebam seu primeiro frame do compositor, corrigindo avisos de renderização precoces e asserções do compositor.
Também adicionamos uma nova API de dimensionamento pelo conteúdo, que permite criar janelas regulares e de diálogo que se ajustam automaticamente ao seu conteúdo.
Flavors para desktop
Windows e Linux agora oferecem suporte a flavors do Flutter.
Por exemplo, seu arquivo pubspec.yaml pode usar assets diferentes em cada flavor:
flutter:
assets:
- path: assets/flavor_a/images
flavors:
- flavor_a
- path: assets/flavor_b/images
flavors:
- flavor_c
Use a opção --flavor para especificar seu flavor. Por exemplo:
flutter build windows --flavor flavor_aflutter build linux --flavor flavor_a
Obrigado a @AngeloAvv pelas excelentes contribuições (#187034, #187029)!
Texto mais nítido no desktop
Telas de desktop costumam ter densidades de pixels menores do que os displays mobile, mas têm mais poder de processamento gráfico. Para entregar texto mais nítido e curvas vetoriais mais limpas no desktop, a engine do Flutter, usando o Impeller, agora utiliza renderização por Signed Distance Function (SDF) no macOS, Linux e Windows.
Previews estáveis e atualizações do GenUI
Widget Previews chega à versão estável
O Flutter Widget Preview agora é estável, permitindo renderizar, inspecionar e iterar rapidamente sobre componentes de UI individuais, sem precisar compilar ou iniciar todo o seu aplicativo.
Com esta versão estável, você pode esperar:
-
Tempos de inicialização mais rápidos graças ao cache local do projeto em uma pasta
.widget_preview/, que elimina a sobrecarga repetida de configuração. -
Testes mais flexíveis com uma API abstrata
PreviewThemeDataque oferece suporte a camadas sequenciais de tema para matrizes de testes complexas. -
Sincronização automática de assets da web ao visualizar widgets web, copiando diretamente os assets
web/do seu projeto host, aplicando qualquer tema personalizado ou personalizando seu arquivoindex.htmlautomaticamente ao usar Flutter web.
Avanços contínuos no GenUI
O ecossistema do Flutter continua evoluindo para atender às necessidades de desenvolvedores que usam o GenUI para criar novos tipos de experiências agênticas para seus usuários. A versão 0.10.0 do pacote genui foi lançada recentemente, trazendo várias correções e novos recursos, entre eles:
-
Um novo pacote
a2ui_coreque centraliza as classes relacionadas ao protocolo, incluindo coisas como expressões, entradas de catálogo e muito mais. - Suporte às funções do lado do cliente do A2UI, que permitem fornecer ao agente funções que ele pode direcionar ao cliente para validação, valores derivados e outras pequenas tarefas, sem uma viagem de ida e volta.
Refinando a experiência de plataforma
Esta seção destaca melhorias pontuais contribuídas pela comunidade e pela equipe do Flutter para aprimorar a experiência de desenvolvedores e de usuários em todas as plataformas.
Android
No Android, resolvemos um problema do teclado virtual em que teclas modificadoras (como Shift) podiam ficar presas durante os eventos. O responder de teclas agora ignora a síntese de teclas físicas para entradas do teclado virtual, mantendo as interações com o teclado limpas.
Matriz de dependências do Android
Para garantir builds estáveis, o Flutter 3.47 é verificado com as seguintes versões de dependências do Android:
- Java: 17 (versão mínima exigida)
- Kotlin Gradle Plugin (KGP): 2.4.0
- Android Gradle Plugin (AGP): 9.1.0 (a mais recente compatível com o KGP 2.4.0)
- Gradle: 9.3.1 (mínimo exigido para o AGP 9.1.0)
Para garantir que seu aplicativo continue sendo compilado com sucesso nas próximas versões, recomendamos usar as variáveis padrão de nível de API oferecidas pelo SDK do Flutter nos seus arquivos de build. Nesta versão, elas estão configuradas com os seguintes valores padrão:
flutter.compileSdkVersion(API 36)flutter.targetSdkVersion(API 36)flutter.minSdkVersion(API 24)
iOS e macOS
Para desenvolvedores iOS, a assinatura de código agora é mais transparente. Graças ao membro da comunidade @alex-medinsh, a CLI exibe tanto o Team ID quanto o Team Name ao selecionar um certificado (#184665).
Além disso, o membro da comunidade @mozammal-hossain melhorou a solução de problemas ao fornecer mensagens de erro mais claras sobre perfis de provisionamento quando a assinatura falha (#184051).
Desktop
As plataformas desktop também receberam refinamentos pontuais. O posicionamento do cursor (caret) na composição de texto em coreano foi corrigido no Windows (graças a @CHOIgoung,
#186353), e plugins do Windows agora podem mover tarefas custosas para fora da thread da plataforma usando FlutterEngine::PostPlatformThreadTask. No Linux, @CodeDoctorDE adicionou suporte à rotação e ao relatório de pressão da caneta stylus
(#186831).
Gráficos e engine
Na engine, shaders de fragmento voltados para OpenGLES não precisam mais de inversão condicional de coordenadas ao ler texturas. Isso agora é tratado no vertex shader. Consulte a página de breaking change de render-to-texture do OpenGLES para mais detalhes.
Refinamentos do framework
Por fim, o framework em si está mais suave, com melhorias distribuídas entre componentes-chave:
Acessibilidade e semântica: as configurações de alto contraste e de inversão de cores do Android agora são detectadas automaticamente, graças a @xxxOVALxxx
(MediaQueryData.highContrast e MediaQueryData.invertColors,
#182263). Spans de texto aninhados dentro de Text.rich agora correspondem à sua sequência de layout na árvore de semântica, e foi adicionado o bloqueio de foco do teclado para BlockSemantics.
Texto e seleção: as alças de seleção de texto em dispositivos móveis agora permanecem estáveis durante rolagens leves, e atalhos de teclado agora podem fechar menus de seleção abertos. No Android, as alças de seleção não ocultam mais o menu de contexto quando posicionadas perto do topo da tela, graças a @JhonaCodes (#182663).
| ANTES | DEPOIS |
|---|---|
|
|
Também corrigimos um crash em SelectableRegion quando a seleção começava em um contêiner rolável vazio, e resolvemos artefatos visuais de destaque em texto selecionável com fade, graças a @ikramhasan
(#183628).
| ANTES | DEPOIS |
|---|---|
|
|
Gestos e rolagem: melhoramos a propagação de gestos para views nativas do iOS incorporadas via platform views. EdgeDraggingAutoScroller agora respeita o ScrollPhysics da visualização de rolagem ativa, evitando a rolagem automática em listas travadas.
Melhorias no Core Widget: preserve as cores originais dentro de ImageIcon com useOriginalColors: true
(#180491), especifique o comportamento de clipping em AnimatedCrossFade
(#184545) e acompanhe erros de stream de imagem diretamente com ImageStreamListener.
Pronto para atualizar
Tudo está preparado, e as bases estão prontas. Falta só trazer essas atualizações para a sua máquina local:
flutter upgrade
Enquanto o seu SDK se atualiza em segundo plano, temos uma lição de casa (do tipo divertido) para você:
- Conheça os colaboradores: pegue a pipoca e assista à nossa nova série de vídeos, Apresentando: Flutter Notable Commits, que celebra os membros da comunidade que tornaram esta versão possível.
- Confira os detalhes: dê uma olhada rápida na página de Breaking Changes para se preparar para as migrações dos pacotes de UI independentes.
Estamos animados para ver o que vocês vão construir com esta versão nova e aprimorada do Flutter!