Novidades do Flutter 3.10

Integração perfeita entre web e mobile, performance gráfica revolucionária com o Impeller estável e mais

Bem-vindo ao Flutter 3.10! Mal podemos esperar para mostrar os enormes esforços da nossa incrível comunidade Flutter. Esta versão do Flutter roda o incrível Dart 3, também disponível hoje!

O Flutter 3.10 traz muitas melhorias para web, mobile, gráficos, segurança e muito mais. Vamos ao que interessa!

Framework

Material 3

A biblioteca Material agora está alinhada com a mais recente especificação do Material Design. As mudanças incluem novos componentes e temas de componentes, visuais de componentes atualizados e muito mais. Desenvolvedores devem “aderir” a essas mudanças usando a flag de tema useMaterial3. Na próxima versão estável, useMaterial3 terá como padrão true.

Para ativar a versão M3 da biblioteca Material, defina useMaterial3 : true no seu MaterialApp theme. O comando flutter create adiciona isso ao seu tema ao criar um novo app.

Para visualizar essas mudanças, confira o app de demonstração. A demo permite ativar e desativar useMaterial3.

ColorScheme.fromImageProvider()

Todos os componentes M3 configuram as cores padrão do ColorScheme do tema. O esquema de cores padrão usa tons de roxo. Você pode criar um esquema de cores personalizado a partir de uma única cor “seed” ou de uma imagem. Teste as duas variações com a demo. Os esquemas de cores gerados devem ficar bons e ser acessíveis.

Isso fornece uma versão M3 do widget BottomNavigationBar. Embora o M3 use cores, destaques e elevação diferentes, ele funciona como antes. Para substituir a aparência padrão do widget NavigationBars, use o widget NavigationBarTheme. Embora você não precise migrar apps existentes para este componente, deve usá-lo em apps novos.

Isso fornece um widget de seleção de destinos M3 baseado no widget Drawer. NavigationDrawer mostra uma lista de seleção única de widgets NavigationDestinations. Você também pode incluir outros widgets nessa lista. O NavigationDrawer pode rolar quando necessário. Para substituir a aparência padrão do NavigationDrawers widget, use o widget NavigationDrawerTheme.

SearchBar e SearchAnchor

Esses componentes oferecem texto preditivo para consultas de busca. Quando o usuário digita uma consulta, o app calcula uma lista de respostas correspondentes em uma “search view”. O usuário seleciona uma delas ou ajusta a consulta. Para substituir o design M3 desses componentes, use os widgets SearchBarTheme e SearchAnchorTheme.

Barra de abas secundária

O M3 permite criar um segundo nível de conteúdo em abas. Para diferenciar essa segunda TabBar, use TabBar.secondary.

DatePicker atualizado para M3

O DatePicker do M3 atualiza as cores, o layout e a forma tanto da versão de calendário quanto da versão de campo de texto do widget. Isso não altera a API, mas adiciona um novo DatePickerTheme.

TimePicker atualizado para M3

O TimePicker do M3, assim como o DatePicker, atualiza as cores, o layout e as formas das versões regular e compacta do widget.

BottomSheet atualizado para M3

Além das atualizações de cor e forma do M3, o bottom sheet agora adiciona uma alça de arraste opcional, que é incluída quando você define showDragHandle como true.

ListTile atualizado para M3

O ListTile do M3 atualiza o posicionamento e o espaçamento deste widget. Isso inclui o padding do conteúdo, o alinhamento dos widgets leading e trailing, a largura mínima do leading e o espaçamento vertical. A API permanece inalterada.

Drawer atualizado para M3

O Drawer do M3 atualiza as cores e a elevação, além de fazer pequenas mudanças de layout.

Atualizações do TextField

O M3 atualiza todos os widgets TextField para oferecer suporte a gestos nativos. Clicar duas vezes ou três vezes com o mouse funciona da mesma forma que tocar duas ou três vezes em um dispositivo touch. Por padrão, os widgets TextField e CupertinoTextField usam esses recursos.

Gestos de clique/toque duplo em TextField

  • Clique duplo + arrastar: Estende a seleção em blocos de palavras.

  • Toque duplo + arrastar: Estende a seleção em blocos de palavras.

Gestos de clique/toque triplo em TextField

Clique triplo
  • Seleciona um bloco de parágrafo na posição clicada quando dentro de um TextField multilinha (Android/Fuchsia/iOS/macOS/Windows).

  • Seleciona um bloco de linha na posição clicada quando dentro de um TextField multilinha (Linux).

  • Seleciona todo o texto em um TextField de linha única.

Toque triplo
  • Seleciona um bloco de parágrafo na posição tocada quando dentro de um TextField multilinha.

  • Seleciona todo o texto em um TextField de linha única.

Clique triplo + arrastar
  • Estende a seleção em blocos de parágrafo (Android/Fuchsia/iOS/macOS/Windows).

  • Estende a seleção em blocos de linha (Linux).

O Flutter oferece suporte ao SLSA nível 1

O framework Flutter agora é compilado com o SLSA (Supply Chain Levels for Software Artifacts) nível 1. Isso reconhece a implementação de vários recursos de segurança, incluindo:

  • Processo de build com scripts. Os scripts de build do Flutter agora permitem builds automatizados em plataformas de build confiáveis. Compilar em uma arquitetura protegida ajuda a evitar adulteração de artefatos, o que melhora a segurança da cadeia de suprimentos.

  • Aprovação de múltiplas partes com registro de auditoria. Os workflows de release do Flutter só são executados após a aprovação de vários engenheiros. Todas as execuções geram registros de auditoria. Essas mudanças garantem que ninguém possa introduzir alterações entre o código-fonte e a geração do artefato.

  • Proveniência. Os releases beta e stable agora são compilados com proveniência. Isso significa que fontes confiáveis, com conteúdo esperado, geraram os artefatos de release do framework. Cada release publica links para visualizar e verificar a proveniência no arquivo do SDK.

Este trabalho também permite que a equipe avance rumo à conformidade com os níveis SLSA L2 e L3. Esses dois níveis focam em proteger os artefatos durante e depois do processo de build.

Web

Apps web Flutter carregam mais rápido

Este release reduz o tamanho dos arquivos de fontes de ícones. Foram removidos glifos não utilizados tanto do Material quanto do Cupertino.

CanvasKit com tamanho reduzido para todos os navegadores

Navegadores baseados em Chromium podem usar um “flavor” personalizado do CanvasKit ainda menor. O CanvasKit hospedado é servido pela CDN do Google, líder do setor. Isso deve melhorar ainda mais o desempenho.

Embedding por elemento

Agora você pode servir apps web Flutter a partir de um elemento específico de uma página. Antes deste release, seus apps podiam ocupar todo o body da página ou ser exibidos dentro de uma tag iframe. Exemplos de código podem ser encontrados no GitHub.

Suporte a shaders

Apps web podem usar o suporte a fragment shaders do Flutter.

Engine

Impeller

Na versão stable 3.7, apresentamos uma prévia do Impeller no iOS. Desde então, recebemos e tratamos muitos feedbacks valiosos de usuários. Com mais de 250 commits no Impeller nesta versão, definimos o Impeller como renderer padrão no iOS. Por padrão, todos os apps criados para iOS com o Flutter 3.10 usam o Impeller. Esses apps iOS terão menos jank e desempenho mais consistente.

Desde a versão 3.7, o Impeller no iOS melhorou o consumo de memória. O Impeller usa menos render passes e render targets intermediários. Em iPhones mais novos, ativar a compressão de textura com perdas reduziu o consumo de memória sem afetar a fidelidade. Esses avanços também trouxeram uma melhora notável de desempenho em iPads.

Considere uma tela complexa, como a tela “pull quote” do app Wonderous. Juntas, essas melhorias reduziram o consumo de memória dessas telas em quase metade. A redução no uso de memória também gera uma queda modesta na carga da GPU e da CPU. O app Wonderous pode não registrar essa queda de carga. Seus frames já eram renderizados dentro do orçamento, mas essa mudança deve prolongar a duração da bateria.

O Impeller também permite à equipe entregar mais rápido pedidos populares de funcionalidades. Um exemplo é o suporte ao gamut de cores P3, mais amplo, no iOS. Veja mais adiante neste post a descrição desse recurso.

As contribuições da comunidade aceleraram nosso progresso, em especial dos usuários do GitHub ColdPaleLight e luckysmg. Eles escreveram vários patches relacionados ao Impeller que melhoraram a fidelidade e o desempenho.

Embora o Impeller atenda às necessidades de renderização da maioria dos apps Flutter, você pode optar por desativá-lo. Se fizer isso, considere abrir uma issue no GitHub para nos contar o motivo. Usuários do app podem notar que o Skia e o Impeller renderizam com pequenas diferenças. Essas diferenças podem ser bugs, então não hesite em abrir issues. Em uma versão futura, vamos remover o renderer Skia legado no iOS para reduzir o tamanho do Flutter.

O trabalho no backend Vulkan para o Impeller continua. O Impeller no Android segue em desenvolvimento ativo, mas ainda não está pronto para prévia. Pretendemos compartilhar mais sobre ele em breve.

Para acompanhar nosso progresso, confira nosso board de projeto no GitHub.

Desempenho

Este release traz mais melhorias de desempenho e correções, além das relacionadas ao Impeller.

Eliminando o jank

Queremos agradecer ao colaborador open source luckysmg. Ele descobriu que era possível reduzir drasticamente o tempo para obter a próxima camada drawable do driver Metal. Para aproveitar esse ganho, você precisa definir a cor de fundo do FlutterViews como um valor não nil. Essa mudança elimina quedas de frame rate em displays recentes de 120Hz do iOS. Em alguns casos, ela triplica o frame rate. Isso nos ajudou a fechar mais de meia dúzia de issues do GitHub. Essa mudança teve tanta importância que fizemos o backport de um hotfix para a versão 3.7.

Na versão stable 3.7, passamos o carregamento de imagens locais da thread de plataforma para a thread do Dart, para evitar atrasar os eventos de vsync vindos da thread de plataforma. No entanto, usuários perceberam que esse trabalho adicional na thread do Dart também causava jank. Nesta versão, movemos a abertura e a decodificação de imagens locais da thread do Dart para uma thread em background. Essa mudança elimina pausas longas potenciais em telas com muitas imagens locais, sem atrasar os eventos de vsync. Em nossos testes locais e benchmarks automatizados, essa mudança reduziu pela metade o tempo de carregamento de várias imagens simultâneas.

Continuamos construindo otimizações sobre a nova estrutura interna DisplayList do Flutter. Nesta versão, adicionamos um mecanismo de culling baseado em R-Tree. Esse mecanismo elimina o processamento de operações de desenho bem antes no nosso renderer. Essa otimização acelera, por exemplo, um custom painter cuja saída fica fora da tela. Nossos microbenchmarks mostraram uma redução de até 50% no tempo de processamento do DisplayList. Apps com custom paints recortados podem ver melhorias diferentes. O grau de melhoria depende da complexidade e da quantidade de operações de desenho ocultas.

Reduzindo a latência de inicialização no iOS

Uma estratégia ineficiente para buscas de identificadores em bundles de apps aumentava a latência de inicialização do app. Essa latência cresce proporcionalmente ao tamanho do app. Nesta versão, corrigimos a busca do bundle identifier. Isso reduziu a latência de inicialização em 100 ms, ou cerca de 30–50% em um app grande de produção.

Reduzindo o tamanho

O Flutter usa SkParagraph como biblioteca padrão para shaping, layout e renderização de texto. Incluímos uma flag para voltar às bibliotecas libtxt e minikin legadas. Como temos total confiança em SkParagraph, removemos libtxt e minikin e a flag correspondente nesta versão. Isso reduz em 30 KB o tamanho compactado do Flutter.

Estabilidade

Na versão 3.0, ativamos um recurso do Android no fim do nosso pipeline de renderização. Esse recurso usava recursos avançados do driver de GPU. Esses recursos de driver repintam menos a tela quando apenas uma região “suja” muda. Adicionamos isso às otimizações anteriores do nosso pipeline gráfico, com efeitos semelhantes. Embora nossos resultados de benchmark fossem animadores, surgiram dois problemas. Primeiro, o benchmark mais beneficiado pode não representar casos de uso práticos. Segundo, o conjunto de dispositivos e versões do Android que suportavam esse recurso do driver de GPU se mostrou difícil de encontrar. Diante dos ganhos limitados e do suporte restrito, desativamos o recurso de repintura parcial no Android.

O recurso continua ativado no iOS ao usar o backend Skia. Esperamos ativá-lo com o Impeller em uma versão futura.

Melhorias de API

Decodificador APNG

O Flutter 3.10 resolve um dos problemas mais pedidos pela comunidade. Ele adiciona a capacidade de decodificar imagens APNG. Você pode carregar imagens APNG com as APIs de carregamento de imagens já existentes no Flutter.

Melhorias na API de carregamento de imagens

O Diretor de Engenharia do Flutter, tvolkert, incluiu melhorias nas APIs de carregamento de imagens do dart:ui. Adicionamos um novo método instantiateImageCodecWithSize. Ele atende ao caso de uso de carregar uma imagem que atende a estas três condições:

  • uma proporção desconhecida no momento do carregamento

  • uma restrição de caixa delimitadora (bounding box)

  • uma restrição de proporção original

Um exemplo seria quando um app tenta exibir uma imagem de um conjunto de possibilidades carregadas pela rede.

Mobile

iOS

Debug sem fio

Agora você pode executar e usar o hot reload dos seus apps Flutter para iOS sem cabo! Depois de parear com sucesso o seu dispositivo iOS no Xcode, você pode implantar o app nesse dispositivo usando flutter run. Se encontrar problemas, verifique se o ícone de rede aparece ao lado do seu dispositivo em Window > Devices e Simulators > Devices. Para saber mais, confira nossa documentação.

Suporte a imagens de gamut amplo

Apps Flutter no iOS agora podem oferecer renderização precisa de imagens de gamut amplo. Para usar esse suporte, o app precisa usar o Impeller e adicionar a flag FLTEnableWideGamut no arquivo Info.plist.

Suporte a verificação ortográfica

O widget SpellCheckConfiguration() agora usa por padrão o serviço de verificação ortográfica da Apple no iOS. Para usar esse widget, defina-o pelo parâmetro spellCheckConfiguration em CupertinoTextField.

Checkbox e radio adaptativos

Esta versão adiciona os widgets CupertinoCheckBox e CupertinoRadio à biblioteca Cupertino. Eles criam componentes de checkbox e botão de rádio que seguem o estilo da Apple.

Os widgets de checkbox e radio do Material ganharam os construtores .adaptive. No iOS e no macOS, esses construtores usam os widgets Cupertino correspondentes. Nas demais plataformas, usam widgets Material.

Refinamento de animações, transições e cores do Cupertino

O Flutter 3.10 melhorou algumas animações, transições e cores para ficarem alinhadas ao SwiftUI. Essas melhorias incluem:

Desempenho de PlatformView

Quando PlatformViews aparecem na tela, o Flutter limita a taxa de atualização no iOS para reduzir o jank. Os usuários do app vão notar isso quando o app exibir PlatformViews animados ou roláveis.

macOS e iOS podem usar código compartilhado em plugins

O Flutter agora oferece suporte à chave sharedDarwinSource no arquivo pubspec.yaml dos plugins. Essa chave indica que o Flutter deve compartilhar o código de iOS e macOS.

yaml
ios:
  pluginClass: PathProviderPlugin
  dartPluginClass: PathProviderFoundation
  sharedDarwinSource: true
macos:
  pluginClass: PathProviderPlugin
  dartPluginClass: PathProviderFoundation
  sharedDarwinSource: true

Novos recursos para extensões de app

Adicionamos documentação para desenvolvedores Flutter usarem extensões de apps iOS. Essas extensões incluem live activities, widgets de tela inicial e extensões de compartilhamento.

Para simplificar a criação de widgets de tela inicial e o compartilhamento de dados, adicionamos novos métodos aos plugins path_provider e homescreen_widget.

Novos recursos para design multiplataforma

A documentação agora inclui considerações de design multiplataforma para componentes de UI específicos. Para saber mais sobre cada um desses componentes, confira as discussões no repositório GitHub de UX do Flutter. Agradecemos qualquer contribuição ou feedback!

Android

Suporte ao CameraX no Android

Camera X, uma biblioteca do Jetpack, simplifica a adição de recursos ricos de câmera ao seu app Android. Essa funcionalidade se aplica a uma ampla variedade de hardwares de câmera do Android. Com esta versão, adicionamos suporte preliminar ao CameraX no plugin Camera do Flutter. Esse suporte cobre os seguintes casos de uso:

  • Captura de imagem

  • Gravação de vídeo

  • Exibição da prévia da câmera ao vivo

Para experimentar, opte por usar a implementação do CameraX. Para isso, adicione a seguinte linha ao seu arquivo pubspec.yaml.

yaml
dependencies:
  camera: ^0.10.4 # Latest camera version
  camera_android_camerax: ^0.5.0

Adoraríamos receber seu feedback enquanto continuamos adicionando recursos ao CameraX, até torná-lo a implementação padrão.

DevTools

Continuamos melhorando o DevTools, o conjunto de ferramentas de desempenho e depuração para Dart e Flutter. Alguns destaques incluem:

  • A UI do DevTools agora usa o Material 3. Isso moderniza o visual e melhora a acessibilidade.

  • O console do DevTools agora oferece suporte a avaliações para um app em execução no modo debug. Antes desta versão, isso só era possível quando você pausava o app.

  • Um visualizador de trace Perfetto incorporado substitui o visualizador de trace de timeline anterior. O Perfetto lida com conjuntos de dados maiores e tem desempenho melhor que o visualizador legado. O Perfetto inclui mais recursos, como:

    • Permitir fixar threads de interesse.
    • Clicar e arrastar para selecionar vários eventos da timeline de vários frames.
    • Usar consultas SQL para extrair dados específicos dos eventos da timeline.

Para saber mais, confira as notas de versão do DevTools 2.23.1, DevTools 2.22.2 e DevTools 2.21.1.

Descontinuações e breaking changes

APIs descontinuadas

Os breaking changes desta versão incluem APIs descontinuadas que expiraram após o lançamento da v3.7. Para ver todas as APIs afetadas, com contexto adicional e orientações de migração, confira o guia de descontinuação desta versão. O Dart Fix pode resolver muitos desses problemas, incluindo quick fixes na IDE e aplicação em lote com o comando dart fix.

Upgrade para o Android Studio Flamingo

Depois de atualizar o Android Studio para o Flamingo, você pode ver um erro ao executar flutter run ou flutter build nos seus apps Android Flutter. Esse erro ocorre porque o Android Studio Flamingo atualiza o SDK Java incluído de 11 para 17. Versões do Gradle anteriores à 7.3 não rodam com o Java 17. Nós atualizamos flutter analyze --suggestions para verificar se esse erro ocorre por incompatibilidade entre o seu SDK Java e a versão do Gradle.

Para conhecer diferentes formas de corrigir esse erro, confira nosso guia de migração.

Descontinuação do singleton Window

Esta versão descontinua o singleton window. Apps e bibliotecas que dependem dele devem migrar para longe dele. Isso prepara seu app para o suporte a múltiplas janelas, que chegará em uma versão futura do Flutter.

Obrigado à comunidade

Como sempre, muito obrigado à comunidade por contribuir com testes, que nos ajudam a identificar esses breaking changes. Para saber mais, confira nossa política de breaking changes.

Para finalizar

Ao encerrarmos este release, a equipe do Flutter no Google agradece a todos os colaboradores que tornaram esta versão possível. Sua dedicação e seu trabalho duro ajudaram a tornar o Flutter um divisor de águas no setor e continuam a revolucionar o desenvolvimento de aplicações. Encorajamos você a começar a explorar esta versão stable mais recente do Flutter para aproveitar todos os recursos incríveis que ela oferece. Para isso, basta flutter upgrade! Fique ligado para mais novidades do Flutter no futuro.

Mais do Flutter