Etiqueta: state-management

ref.watch se suscribe y reconstruye, ref.read lee una vez y nunca reconstruye. Usa watch en cada método build y read solo dentro de callbacks de eventos. Aquí está la matriz de decisión, el código fuente de ambos métodos en flutter_riverpod 3.4.3 y los cuatro fallos silenciosos: watch en un callback, read en el cuerpo de un provider, read sobre un provider autoDispose y read usado como optimización.

Una Key es la mitad de identidad de Widget.canUpdate, la única línea del framework que decide si un Element y su State se reutilizan o se descartan. Esto es lo que significa en la práctica, las ediciones de listas que corrompen el estado sin keys, qué tipo de key usar y dónde debe ir la key para funcionar.

Elige según el tipo de retorno de build(): T significa Notifier, FutureOr<T> significa AsyncNotifier, Stream<T> significa StreamNotifier. Aquí está la matriz de decisión, la jerarquía de tipos que lo explica y los problemas de filtrado por == y de sobrescritura de estado que afectan a cada uno. Verificado con flutter_riverpod 3.4.2 en Flutter 3.44.2.

Un recorrido paso a paso desde el setState local del widget hacia un Notifier de Riverpod 3.x: clasifica lo que realmente sale del widget, escribe el Notifier, conviértelo a ConsumerWidget y sobrevive al filtrado por ==, a la reejecución de build() y a los valores por defecto de autoDispose que muerden a quienes vienen de setState. Probado con Flutter 3.44, Dart 3.x y flutter_riverpod 3.3.2.

En Riverpod 3.0 cada provider filtra las notificaciones a los listeners con ==, no con identidad. Un StreamProvider que vuelve a emitir el mismo objeto mutable deja de reconstruir la UI después del primer frame. Aquí explicamos por qué pasa y tres formas de solucionarlo. Probado en flutter_riverpod 3.3.2, Flutter 3.44, Dart 3.x.

Riverpod 3.0 reintenta un provider fallido hasta 10 veces por defecto. Pasa una función de retry que devuelva null en ProviderScope, ProviderContainer o un provider individual para desactivarlo o acotarlo.

Una actualización paso a paso de flutter_riverpod 2.x a 3.x: sube las versiones de los paquetes, mueve StateProvider y compañía al import legacy, elimina los tipos de ref AutoDispose y Family, maneja el envoltorio de ProviderException y el reintento automático, y arregla el filtrado de notificaciones por == que descarta silenciosamente eventos de StreamProvider. Probado en Flutter 3.44, Dart 3.x, flutter_riverpod 3.3.2.

Riverpod 3.0 envuelve en un ProviderException los errores lanzados al leer un provider. Captura ese tipo y lee e.exception para recuperar tu error original, o usa AsyncValue.error, que viene sin envolver.

En un Notifier, resuelve las dependencias antes del await y luego protege la escritura de state con if (!ref.mounted) return. Es el reemplazo en Riverpod 3.0 del viejo mixin con onDispose, y evita UnmountedRefException cuando un provider se descarta a mitad de un await. Probado en flutter_riverpod 3.x, Flutter 3.44, Dart 3.x.

Una migracion paso a paso del paquete provider a Riverpod 3.x en una app de Flutter real: de ChangeNotifierProvider a Notifier, de MultiProvider a ProviderScope, de context.watch a ref.watch, de ProxyProvider a composicion con ref.watch, mas los detalles de igualdad y ciclo de vida que muerden. Probado en Flutter 3.27.1, Dart 3.11, provider 6.1.5, flutter_riverpod 3.3.1.