riverpod-migration

Riverpod — 移行ガイド

手順

このスキルでは、さまざまな状況に対応する詳細な移行ガイドを案内します。該当するケースに一致するリファレンスファイルを使用してください。

使用するガイド

状況	リファレンス
StateNotifier から Notifier / AsyncNotifier への移行	migration_from_state_notifier.md
ChangeNotifier から AsyncNotifier への移行	migration_from_change_notifier.md
0.13.x → 0.14.x へのアップグレード（StateNotifierProvider の構文、watch(provider) と provider.state の違い）	migration_0_13_0_14.md
0.14.x → 1.0 へのアップグレード（ScopedReader → WidgetRef、useProvider → ref.watch、StateProvider）	migration_0_14_1_0.md

Riverpod 2.0 → 3.0 については、riverpod-3-0-migration スキルを参照してください。

よくあるテーマ

• StateNotifier → Notifier/AsyncNotifier： 初期化ロジックは build に記述します。dispose をオーバーロードする代わりに ref.onDispose を使用します。mounted はないため、キャンセル（Completer や HTTP のキャンセルトークンなど）を使用します。コンシューマー側は変更ありません（ref.watch、notifier のメソッド）。
• ChangeNotifier → AsyncNotifier： isLoading／hasError／手動の try-catch を AsyncValue に置き換えます。状態は state のみとし、state を再代入して変更します。
• CLI： 0.14 および 1.0 へのアップグレードでは、プロジェクト内で dart pub global activate riverpod_cli を実行し、その後 riverpod migrate を実行できます（先に Riverpod を手動でアップグレードしないでください。ツールがバージョンと変更内容を提案します）。

手順を追った説明とコード例については、該当するリファレンスファイルを開いてください。