v5.0.0
- Support Flutter 3.0.0
- [BREAK CHANGE]: Removed
MaterialApp.modular()andCupertino().modular().
Use instead:return MaterialApp.router( routeInformationParser: Modular.routeInformationParser, routerDelegate: Modular.routerDelegate, );
This modification aims to keep Modular support independent of WidgetApp updates, and can be used in other bootstraps such as FluentApp [fluent_ui].
- [BREAK CHANGE]: New auto-dispose configuration.
Previously Modular had automatic closing or destruction calls for objects of typeChangeNotifier/ValueNotifier,Streamand Triple`sStores.
Starting with version 5.0, Modular will provide theBind.onDisposeproperty for calls to destroy, close or dispose methods FOR EACH BIND. This will make the dispose settings more straightforward and less universal. Therefore, Modular will manage the destruction of Binds that implementDisposableonly. This is the new configuration:
@override
final List<Bind> binds = [
Bind.singleton((i) => MyBloc(), onDispose: (bloc) => bloc.close()),
];The Bind.onDispose CANNOT be used in Bind type factory.
You can choose to use Bind.onDispose or implement the Disposable class.
- Added
Bind.selector. Generates a reactivity (Listenable/Stream) to be listened to whencontext.watch()is called.
@override
final List<Bind> binds = [
//notifier return stream or listenable to use context.watch()
Bind.singleton((i) => MyBloc(), onDispose: (bloc) => bloc.close(), selector: (bloc) => bloc.stream),
];- [BREAK CHANGE]: As already described above, the reactivities worked externally to Modular, providing a
longer life to the project. For this reason, BLoC or Triple users should use specialBind'sin order to use thecontext.watch()and auto dispose functionality. They are:BlocBind()andTripleBind(), which are available through external packages.
modular_bloc_bind -> BlocBind
modular_triple_bind -> TripleBind
Example:
@override
final List<Bind> binds = [
BlocBind.singleton((i) => MyBloc()),
];-
[BREAK CHANGE]
Bind.exportworks only after imported. -
@deprecated
ModularState.
A few months of research showed us that ModularState caused unnecessary coupling with the view and made it difficult for those who used it to understand. For this reason, we decided to deprecate it to ensure code congruence for all professionals who use Modular. -
Removed
tripledependency. -
Simplify docs.
-
Added
Modular.setArguments.
Modular.setArguments('cody1024d');
// get
Modular.args.data; // -> cody1024d
//or
Bind((i) => MyClass(i.args.data));