タグ: state-management

ウィジェットローカルな setState から Riverpod 3.x の Notifier へ移す手順です。何をウィジェットの外に出すかを仕分けし、Notifier を書き、ConsumerWidget に変換し、setState からの移行者を悩ませる == によるフィルタリング、build() の再実行、autoDispose の既定値の違いを乗り切ります。Flutter 3.44、Dart 3.x、flutter_riverpod 3.3.2 で検証しました。

Riverpod 3.0 では、すべてのプロバイダーがリスナー通知を同一性ではなく == でフィルタリングします。同じミュータブルオブジェクトを再度発行する StreamProvider は、最初のフレーム以降 UI を再構築しなくなります。なぜそうなるのか、そして 3 つの修正方法を解説します。flutter_riverpod 3.3.2、Flutter 3.44、Dart 3.x で検証済みです。

Riverpod 3.0 はデフォルトで失敗したプロバイダーを最大 10 回リトライします。null を返す retry 関数を ProviderScope、ProviderContainer、または個々のプロバイダーに渡すことで、無効化したり回数を制限したりできます。

flutter_riverpod 2.x から 3.x への段階的なアップグレード手順です。パッケージを更新し、StateProvider などを legacy インポートへ移し、AutoDispose と Family の ref 型を廃止し、ProviderException のラップと自動リトライに対応し、StreamProvider のイベントを暗黙的に取りこぼす == による通知フィルタリングを修正します。Flutter 3.44、Dart 3.x、flutter_riverpod 3.3.2 で検証済みです。

Riverpod 3.0 はプロバイダーの読み取り中にスローされたエラーを ProviderException でラップします。その型をキャッチして e.exception を読めば元のエラーを取り戻せます。あるいは、ラップされない AsyncValue.error を使いましょう。

Notifier では await の前に依存関係を解決し、その後 if (!ref.mounted) return で state の書き込みを保護します。これは Riverpod 3.0 における古い onDispose ミックスインの代替であり、provider が await の途中で破棄されたときの UnmountedRefException を防ぎます。flutter_riverpod 3.x、Flutter 3.44、Dart 3.x で検証済みです。

実際の Flutter アプリで provider パッケージから Riverpod 3.x へ段階的に移行する手順です。ChangeNotifierProvider から Notifier へ、MultiProvider から ProviderScope へ、context.watch から ref.watch へ、ProxyProvider から ref.watch による合成へ、加えて引っかかりやすい等価性とライフサイクルの落とし穴も解説します。Flutter 3.27.1、Dart 3.11、provider 6.1.5、flutter_riverpod 3.3.1 で検証済みです。

Riverpod 3 で単一の AsyncValue からローディング、データ、エラーの状態をレンダリングします。ミューテーションには AsyncNotifier と AsyncValue.guard を、UI には .when() と switch のパターンマッチングを使い、更新時に以前のデータを保持し、レガシーな StateNotifier パターンを移行します。flutter_riverpod 3.x、Flutter 3.44、Dart 3.x でテスト済みです。

実際の Flutter アプリで GetX から Riverpod 3.x への段階的な移行を解説します。GetxController から Notifier、.obs から派生プロバイダー、Get.find から ref.watch、Get.to から go_router、さらに snackbar、テーマ、テストまで。Flutter 3.27.1、Dart 3.11、flutter_riverpod 3.3.1 で動作確認済み。