flutter_meedu 8.0.0

flutter_meedu: ^8.0.0 copied to clipboard

• BREAKING CHANGE The .select filter has a new behavior. A new optional argument called booleanCallback has beed added. If your callback (in the .select filter) returns a boolean value and you want to rebuild your consumers or notify to your listeners only when the boolean value is true you can set [booleanCallback] to true.

  If you don't define the [booleanCallback] argument and your callback return a boolean (true or false) your consumers and your listeners will notified when the value returned by the callback changes ( true to false or false to true).

  EXAMPLE:

     final controller = ref.watch(
        provider.select(
          (_) => _.user != null,
          booleanCallback: true,
        ),
    );
  

• Updated to meedu: ^7.2.0+1

• Added Provider class to be able to create providers that don't depend of SimpleNotifier or StateNotifier.
• Allow afterFirstLayout to be overridden with FutureOr.
• Allow dispose on SimpleNotifier and StateNotifier to be overridden with FutureOr.

Example:

class HomePageUiUtils {
  HomePageUiUtils._();
}
final homeTabController = 

• BREAKING CHANGE

  imports has been renamed.

  Before:

  import 'package:flutter_meedu/router.dart';
  import 'package:flutter_meedu/rx.dart';
  import 'package:flutter_meedu/state.dart';
  import 'package:flutter_meedu/page.dart';
  import 'package:flutter_meedu/navigation.dart';
  import 'package:flutter_meedu/screen_utils.dart';
  

  Now:

  import 'package:flutter_meedu/ui.dart'; /// this contains the all previous libraries in one single import
  

  IMPORTANT: package:flutter_meedu/flutter_meedu.dart has been removed in favor to package:flutter_meedu/ui.dart

• BREAKING CHANGE

  Now to use the route module you don't have to use alias. Now you have to use the global var router

  Before:

  import 'package:flutter_meedu/router.dart' as router;
  
  MaterialApp(
    navigatorKey: router.navigatorKey,// <-- ADD THIS
    home: HomePage(),
    navigatorObservers: [
      router.observer,// <-- ADD THIS
    ],
    .
    .
    .
  ),
  

  Now:

  import 'package:flutter_meedu/ui.dart'; // Alias is not needed any more
  
  MaterialApp(
    navigatorKey: router.navigatorKey,// <-- ADD THIS
    home: HomePage(),
    navigatorObservers: [
      router.observer,// <-- ADD THIS
    ],
    .
    .
    .
  ),
  

• BREAKING CHANGE:

  Get.factoryPut<T,A> has been replaced for Get. factoryPut<T>

  Before:

  Get.factoryPut<AuthRepository, String>(
    (String? arguments) => AuthRepository (arguments!),
  );
    .
    .
    .
  final testRepo = Get.factoryFind<AuthRepository,  String>(
  arguments:"https://test.api.com",
  );
  

  Now:

  Get.factoryPut<AuthRepository>(
    (arguments) => AuthRepository(arguments as  String),
  );
    .
    .
    .
  final testRepo = Get.factoryFind<AuthRepository>(
  arguments:"https://test.api.com",
  );
  

• Added AfterFirstLayoutMixin. Add with AfterLayoutMixin

  class MyWidget extends StatefulWidget {
    const _MyWidget({Key? key}) : super(key: key);
    @override
    State<MyWidget> createState() => _MyWidgetState();
  }
  
  class _MyWidgetState extends State<MyWidget> with AfterFirstLayoutMixin {
    @override
    void afterFirstLayout(BuildContext context) {
      showDialog(
        context: context,
        builder: (_) => AlertDialog(
          content: Text('after first layout'),
        ),
      );
    }
  
    @override
    Widget build(BuildContext context) {
      return Scaffold();
    }
  }
  

• Added Get.asyncPut<T>:

  Example:

   Get.asyncPut<Person>(
      (arguments) async {
        await Future.delayed(
          const Duration(milliseconds: 10),
        );
        return Person(arguments as String);
      },
  );
  .
  .
  .
  final person = await Get.asyncFind<Person>  (arguments: 'Darwin');
  

• Added export 'src/navigation/transitions/transition.dart'; in navigator library.

• Export Navigator1 as an independent library.
• Added ContextNavigatorExt extension.

• Added class Navigator1 to easy use push, pushReplacement, pushAndRemoveUntil and all pop methods.

• Updated to meedu: ^5.3.1

• Updated to meedu: ^5.3.0

• Updated to meedu: ^5.2.0

• Updated to meedu: ^5.2.0

• Updated to meedu: ^5.1.0
• Added PersistentStateMixin to save the state of your StateNotifers as a JSON.

• Fixed bug due to addPostFrameCallback in ConsumerWidget when an update is called before addPostFrameCallback has been completed.

• Release 6.x.x

• Removed deprecated methods.

• Set min dark sdk >=2.15

BREAKING CHANGE: removed .ids filter in favor to .select in SimpleProvider.

• Added @Deprecated annotation for .ids filter, that filter will be removed in flutter_meedu: ^6.x.x.

• Updated to meedu: ^4.3.0

• Updated README.md

• Added support for filters in ProviderListener and MultiProviderListener

For example:

ProviderListener<CounterController>(
  provider: counterProvider.select(
    (_) => _.counter >= 5,
  ),
  onChange: (_, controller) {

  },
  builder: (_, controller) {
    return YOUR_WIDGET;
  },
);

• Added lint rules.

• Added router.context.

• Updated readme.

• Added validations for bad use of ref.watch and ref.select.

• now the router module allows you access to the route arguments without BuildContext. To do this you need to add the observer in your navigatorObservers.

import 'package:flutter_meedu/router.dart' as router;

MaterialApp(
  navigatorKey: router.navigatorKey,// <-- ADD THIS
  home: HomePage(),
  navigatorObservers: [
    router.observer,// <-- ADD THIS
  ],
  .
  .
  .
),

then you can access to the route setting or arguments

import 'package:flutter_meedu/router.dart' as router;
.
.
.
// now you can use
final arguments = router.arguments;

/// current route settings
final settings = router.settings;

.
.
.
/// also you can pass directly the route arguments to your controllers
final counterProvider = SimpleProvider(
  (_) => CounterController(router.arguments as int),
);

or

final counterProvider = SimpleProvider<CounterController>(
  (_) {
    final initialValue = router.arguments as int;
    return CounterController(initialValue);
  },
);


/// if you need to write unit or widget testing
/// you can use the [overrideProvider] method
setUp((){
  counterProvider.overrideProvider(
    (_) => CounterController(mockedInitialValue),
  );
});

• Updated to meedu: ^4.2.1

• BREAKING CHANGE: Removed ScopedReader and replaced by BuilderRef.

Before: the watch function allways return the notifier linked to the provider passed as parameter to the watch function.

 Consumer(builder: (_, watch, __) {
     final controller = watch(counterProvider);
     return Text("${controller.counter}");
 })

 Consumer(builder: (_, watch, __) {
     final controller = watch(
       counterProvider.select((_) => _.counter),
     );
     return Text("${controller.counter}");
 })

After: now the consumer widget has replaced the watch parameter for one instance of BuilderRef with this change to listen the changes you need to use ref.watch

 Consumer(builder: (_, ref, __) {
     final controller = ref.watch(counterProvider);
    return Text("${controller.counter}");
 })

// or

 Consumer(builder: (_, ref, __) {
     final controller = ref.watch(
       counterProvider.select((_) => _.counter),
     );
    return Text("${controller.counter}");
 })

or if you want direct access to the value returned by counterProvider.select((_) => _.counter) you can use ref.select

 Consumer(builder: (_, ref, __) {
     final int counter = ref.select(
       counterProvider.select((_) => _.counter),
     );
    return Text("$counter");
 })

• ref.watch can be used to listen the changes in a provider even you can use filters like .ids, .select and .when with ref.watch but it allways returns the notifier linked to the provider.

• ref.select can be used to listen the changes in a provider only using filters like .select and .when and the value returned by ref.select depends of the value returned by the filters.

IMPORTANT: the .ids filter only should be used with ref.watch.

#

• Fixed multiples rebuilds with custom transitions using named routes.

• Added MultiProviderListener widget.

• Added autoRemove and onRemove in dependency injection.

• Added result parameter in pushReplacementNamed.

• Added custom transitions for named routes.
• Updated docs.

• Added isDarkMode extension.

• Added const constructor in PageWithArgumentsWidget class.

• Added const constructor in PageWithArgumentsWidget class.

• Added PageWithArgumentsWidget class.

• Updated to meedu: ^4.1.0

• Updated to meedu: ^4.0.0+1
• Improved ConsumerWidget class.

• Added comments in the consumer widget.

• Removed WatchFilter class.
• Added .ids, .select and .when methods in SimpleProvider and StateProvider.

• Added PageWithArguments Widget.

• Updated to meedu: ^3.0.8

• Updated README.

• Updated to meedu: ^3.0.7

• Updated to meedu: ^3.0.6
• Added lint rules.

• Updated to meedu: ^3.0.5

• Updated Navigator Observer.

• Updated to meedu: ^3.0.4

• Updated to meedu: ^3.0.2

• Updated tests

• Updated to meedu: ^3.0.1

• Updated README.MD

• Ready for production

• Updated to meedu: ^3.0.0-prev.15

• Updated to meedu: ^3.0.0-prev.14
• call AutoDispose after route dismiss animation.

• Added dispose method in router module.

• Updated to meedu: ^3.0.0-prev.13

• Updated to meedu: ^3.0.0-prev.11

• Removed Logs on Consumer widget.

• ProviderListener onChange callback is called after next frame.

• Fixed routeName on NavigatorObserver.

• Fixed Provider widget.

• Added WatchFilter class.

• Added buildWhen, buildByIds and buildBySelect in the watch method of ConsumerWidget.

• fixed router.arguments.

• Fixed autoDispose in pushAndRemoveUntil usinf didRemove.

• Fixed autoDispose in pushAndRemoveUntil.

• fixed autoDispose for multiples providers.

• fixed autoDispose when navigate using Navigator.push(...).

• meedu: ^3.0.0-prev.5

• meedu: ^3.0.0-prev.4

• meedu: ^3.0.0-prev.3

• meedu: ^3.0.0-prev.2

• Fixed read method into ProviderReference.

• Added events to ProviderListener.

• Prev version of 3.0.0

• Fixed router navigator key.

• Updated export file.

• Updated meedu: ^2.1.0

• Updated meedu: ^2.0.1

• Added support for flutter 2 and null safety.

• Fixed push with Generic types.

• Updated meedu: ^0.5.4.

• Added tag support for Provider.of<...>(...)

• Removed unused imports.

• Fixed route.arguments in ProviderPage.

• Updated meedu version.

• Added documentation url.

• Added ProviderPage.

• Added SimpleWidget and StateWidget.

• Added screen utils.

• initial version.