このチャプターの目次
2022年6月1日、最終確認
2.0.0-dev.9
-
cacheTime/disposeDelayを使用してProviderContainerを破棄する際のタイマーリークが修正されました。
2.0.0-dev.8
- ネストした
ProviderScopeをアンマウントすると例外が発生するバグが修正されました。
2.0.0-dev.7
- 最小要求Dartバージョンが
2.17.0になりました。 - 最小要求Flutterバージョンが
3.0.0になりました。
2.0.0-dev.6
-
ConsumerStatefulWidget/ConsumerStateのinitState等の使用を想定するWidgetRef.listenOnceが追加されました。 - エラーを無視して値を取得するために
AsyncValue.valueOrNullを追加されました。 -
AsyncValue.valueがエラーがあるにも関わらすThrowしない問題が修正しました。 -
FamilyProviderでcacheTime/disposeDelayが適用されない問題が修正されました。 -
KeepAliveLinkがキャンセルされた後、非同期で例外がThrowされる場合がある不具合が修正されました。
2.0.0-dev.5
-
AsyncErrorの後にAsyncDataが発行されてもAsyncValue.hasErrorがtrueになってしまう不具合が修正されました。
2.0.0-dev.4
- Scopeの親を手動でオーバーライドできる
ProviderScope.parentが追加されました。
モーダルやダイアログがScopedなプロバイダにアクセスできるようにするために使用できます。 - プロバイダの変更をそのプロバイダ内で購読するための
ref.listenSelfが追加されました。
「ログ出力」や「データベースにプロバイダの状態を保存する」といったユースケースに使用できます。 - すべての
autoDisposeプロバイダとProviderScope/ProviderContainerにdisposeDelayが追加されました。
プロバイダへの監視（購読）が無くなってからプロバイダが破棄されるまでの遅延時間を設定できます。 -
providerContainer.invalidate(provider),ref.invalidate(provider),ref.invalidateSelf()が追加されました。
ref.refreshより安全で、プロバイダをすぐに再構築しないのでプロバイダが2回連続で再構築されるのを避けることができます。 -
cacheTimeに渡されたDurationの挙動が以下のように変更になりました。
変更前：プロバイダが最初に構築されたときの最小時間 変更後：プロバイダの最新の変更後の最小時間 - プロバイダが誤って自分自身に依存し、
autoDisposeが壊れる問題が修正されました。 -
StateNotifier.autoDisposeのstateを使用した際のメモリリークが修正されました。 -
ProviderObserver.didDisposeProviderがプロバイダのリフレッシュ時に実行されない問題が修正されました。
2.0.0-dev.3
- プロバイダ内で
ref.listenを実行しており、依存関係の1つが変更された場合に、そのプロバイダが適切に再構築されるようになりました。
2.0.0-dev.2
-
ref.maintainState = true/falseが非推奨となり、新たにref.keepAlive()が追加されました。
ref.keepAlive()関数は、各Providerの状態を一定期間維持したい複数のロジックがある場合にうまく処理されます。 - 非推奨の
ProviderReferenceが削除されました。 -
ProviderContainer.cacheTimeとMyProvider.autoDispose(_, cacheTime: duration)が追加されました。
参照されなくなったautoDisposeProviderを指定した時間生存させられます。（デフォルト値：Duration.zero） -
ref.onAddListenerが追加されました。
新しいリスナーがプロバイダに追加されるたびに実行するコールバックを追加できます。 -
ref.onRemoveListenerが追加されました。
リスナーがプロバイダから削除されたときに実行するコールバックを追加できます。 -
ref.onCancelが追加されました。
プロバイダの最後のリスナーが削除されたときに実行するコールバックを追加できます。 -
ref.onResumeが追加されました。
プロバイダの最後のリスナーが削除された（ref.onCancelの実行）後、再びリスニングされるときに実行するコールバックを追加できます。
2.0.0-dev.1
-
Dart 2.16が必須になりました。 - プロバイダの値構築中に例外が発生しても
ProviderExceptionがスローされないようになり、代わりに発生した例外とスタックトレースを再スローするようになりました。 -
AsyncValueのisError,isDataが削除されました。 -
AsyncValueにhasError,hasDataが追加されました。 -
AsyncValueに、AsyncValueを複製して1つ前の値とマージするcopyWithPreviousが追加されました。
これにより、AsyncDataがエラーを含んだり、AsyncErrorが値を含むことができるようになります。AsyncLoadingの前がAsyncData,AsyncErrorだった場合は、isLoadingがtrueのAsyncData/AsyncErrorになります。 - 非同期の値を待ちながら、再構築のフィルタリングもできる
provider.selectAsyncが追加されました。 - プロバイダが
AsyncErrorに続いてAsyncDataを発行するとき、そのAsyncDataに最新のerror/stackTraceが含まれるようになりました。 - より具体的なプロバイダタイプでプロバイダをオーバーライドする際のキャストエラーが修正されました。
-
autoDispose使用時、特定の条件下でonDiposeが2回実行されることがある不具合が修正されました。
2.0.0-dev.0
- プロバイダが
AsyncDataまたはAsyncErrorを発行した後、そのプロバイダはもうAsyncLoadingを発行しないようになりました。
その代わりに最新の値を再発行しますが、AsyncValue.isRefreshingはtrueに設定されます。
この変更により、プロバイダがリフレッシュされても、UIは以前のデータやエラーを表示し続けることができます。 -
AsyncValueにisLoading,isErrorisDataasErrorが追加されました。
これらを使えうとパターンマッチングすることなく AsyncValue の状態を確認できます。 -
provider.future,provider.streamのリフレッシュが正しく動作していなかった問題が修正されました。 -
ref.watchで発生する可能性のあったassertの誤検出が修正されました。