Tag: state-management

ref.watch se inscreve e reconstrói, ref.read lê uma vez e nunca reconstrói. Use watch em todo método build e read apenas dentro de callbacks de eventos. Aqui está a matriz de decisão, o código-fonte dos dois métodos no flutter_riverpod 3.4.3 e as quatro falhas silenciosas: watch em um callback, read no corpo de um provider, read em um provider autoDispose e read usado como otimização.

Uma Key é a metade de identidade de Widget.canUpdate, a única linha do framework que decide se um Element e seu State são reaproveitados ou descartados. Aqui está o que isso significa na prática, as edições de lista que corrompem o estado sem keys, qual tipo de key usar e onde a key precisa ficar para funcionar.

Escolha pelo tipo de retorno de build(): T significa Notifier, FutureOr<T> significa AsyncNotifier, Stream<T> significa StreamNotifier. Aqui está a matriz de decisão, a hierarquia de tipos que explica o porquê, e as armadilhas de filtragem por == e de sobrescrita de estado que atingem cada uma. Verificado com flutter_riverpod 3.4.2 no Flutter 3.44.2.

Um caminho passo a passo do setState local do widget para um Notifier do Riverpod 3.x: classifique o que realmente sai do widget, escreva o Notifier, converta para ConsumerWidget e sobreviva ao filtro por ==, à reexecução do build() e aos padrões de autoDispose que pegam quem vem do setState. Testado no Flutter 3.44, Dart 3.x e flutter_riverpod 3.3.2.

No Riverpod 3.0 todo provider filtra as notificações de listeners com ==, não por identidade. Um StreamProvider que reemite o mesmo objeto mutável para de reconstruir a UI depois do primeiro frame. Veja por que isso acontece e três formas de corrigir. Testado no flutter_riverpod 3.3.2, Flutter 3.44, Dart 3.x.

O Riverpod 3.0 tenta novamente um provider que falhou ate 10 vezes por padrao. Passe uma funcao de retry que retorna null no ProviderScope, ProviderContainer ou em um provider individual para desligar ou limitar esse comportamento.

Uma atualização passo a passo do flutter_riverpod 2.x para o 3.x: suba as versões dos pacotes, mova StateProvider e afins para o import legacy, elimine os tipos de ref AutoDispose e Family, lide com o empacotamento em ProviderException e o retry automático, e corrija a filtragem de notificações por == que descarta silenciosamente eventos do StreamProvider. Testado no Flutter 3.44, Dart 3.x, flutter_riverpod 3.3.2.

O Riverpod 3.0 encapsula erros lançados durante a leitura de um provider em um ProviderException. Capture esse tipo e leia e.exception para recuperar o erro original, ou use AsyncValue.error, que não é encapsulado.

Em um Notifier, resolva as dependências antes do await e depois proteja a escrita de state com if (!ref.mounted) return. É a substituição no Riverpod 3.0 do antigo mixin com onDispose, e evita UnmountedRefException quando um provider é descartado no meio de um await. Testado em flutter_riverpod 3.x, Flutter 3.44, Dart 3.x.

Uma migração passo a passo do pacote provider para Riverpod 3.x em um app Flutter real: ChangeNotifierProvider para Notifier, MultiProvider para ProviderScope, context.watch para ref.watch, ProxyProvider para composição com ref.watch, além das pegadinhas de igualdade e ciclo de vida que mordem. Testado no Flutter 3.27.1, Dart 3.11, provider 6.1.5, flutter_riverpod 3.3.1.