Tag: riverpod

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.

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.

Instale flutter_riverpod para quase todo app Flutter. Use riverpod apenas para código Dart puro, e hooks_riverpod apenas se você já usa flutter_hooks.

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 de um widget FutureBuilder inline para um AsyncNotifier do Riverpod em um app Flutter real: tire o trabalho assíncrono do build, exponha-o como um provider, renderize com .when() ou correspondência de padrões com switch, e adicione métodos de refresh e mutação. Testado no Flutter 3.44, Dart 3.x, flutter_riverpod 3.3.2.