flutter

Use shared_preferences (SharedPreferencesWithCache) para um punhado de flags simples e um arquivo JSON em getApplicationSupportDirectory para um objeto de configurações estruturado. Cobre o padrão de escrita atômica, a condição de corrida dos salvamentos concorrentes, a armadilha da pasta Documentos no Windows e no Linux, o suporte à web e custos de escrita medidos no Flutter 3.44.8.

O flutter upgrade é abortado se o git status na pasta do SDK imprimir qualquer coisa. Inspecione, restaure o pubspec.lock ou use git stash -u, e deixe o --force como último recurso.

Tudo o que você compila em um build Flutter web, incluindo valores de --dart-define, vai para o navegador em texto puro. O único padrão seguro é um pequeno proxy de backend que guarda a chave, autentica o usuário, fixa o modelo e repassa o SSE da Responses API em streaming. Proxy completo em Dart com shelf e cliente Flutter, testados com Flutter 3.44, Dart 3.12 e http 1.6.

Bloqueie uma rota do Flutter em paisagem ou retrato com SystemChrome.setPreferredOrientations sem quebrar o resto do app: um bloqueio baseado em pilha que sobrevive a pushReplacement e é restaurado no pop, por que a lista vazia é o reset errado, por que o multitasking do iPad e as telas grandes do Android 16 ignoram o bloqueio e o que UIRequiresFullScreen significa depois do iPadOS 26 e do SDK do iOS 27. Testado no Flutter 3.47.8 com Dart 3.13.7 e Xcode 27.1.

Chamar remove dentro de um loop for-in ou de forEach lança ConcurrentModificationError. Use removeWhere para filtrar no lugar, crie uma lista nova com where ou um collection-for, ou percorra o índice de trás para frente. Verificado no Dart 3.13.7, com um benchmark mostrando por que removeAt em um loop é a opção lenta.

Coloque um campo discriminador no JSON, faça um switch nele em uma factory na base sealed e faça um switch no subtipo para escrevê-lo de volta. Três versões funcionais no Dart 3.13.7: correspondência de padrões escrita à mão, json_serializable 6.15.2 e Freezed 4.0.3 com unionKey e fallbackUnion, além das armadilhas que cada uma esconde.

O depend_on_referenced_packages dispara quando um arquivo importa ou exporta um pacote que não está listado no seu próprio pubspec.yaml, mesmo que ele seja resolvido por outra dependência. Veja exatamente o que a regra verifica no Dart 3.12.2 e no Flutter 3.44.8, por que imports transitivos são um bug real e como corrigir cada variante.

Substitua os membros obsoletos Color.withOpacity, opacity, value, red, green, blue e alpha por withValues, .a/.r/.g/.b e toARGB32. O que o dart fix reescreve para você, os quatro getters que ele deixa para trás, por que asserções de cor exata e buscas em Map<Color, T> quebram após a troca, e como withOpacity descarta silenciosamente o Display P3. Medido no Flutter 3.44.8 com Dart 3.12.2.

Substitua o código de ciclo de vida feito à mão com WidgetsBindingObserver por AppLifecycleListener: o mapeamento dos callbacks, a máquina de estados que ele impõe, o novo estado hidden que quebra switches exaustivos, as solicitações de saída no desktop e o teste que de repente falha numa assertion. Testado no Flutter 3.44.8 com Dart 3.12.2.

Use Expanded quando um filho precisa ocupar sua parte de um Row ou Column, e Flexible quando ele pode ser menor que sua parte. Layouts medidos no Flutter 3.44 mostram para onde vai o espaço que sobra, por que filhos loose nunca o doam aos irmãos e quando só Flexible sobrevive a constraints ilimitadas.