Expose dispose method on BlocProvider

[felangel]

Status

READY

Breaking Changes

YES

Description

• Update BlocProvider to expose dispose method to allow full control over when a bloc should be disposed.

This PR allows us to go from:

class MyApp extends StatefulWidget {
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  MyBloc _myBloc;
  
  @override
  initState() {
    super.initState();
    _myBloc = MyBloc();
  }

  @override
  Widget build(BuildContext context) {
    return BlocProvider(
      bloc: _myBloc,
      child: MyPage(),
    );
  }

  @override
  dispose() {
    _myBloc.dispose();
    super.dispose();
  }
}

To this:

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return BlocProvider(
      builder: (BuildContext context) => MyBloc(),
      dispose: (BuildContext context, MyBloc bloc) => bloc.dispose(),
      child: MyPage(),
    );
  }
}

Related PRs

List related PRs against other branches:

branch	PR
BlocProvider to Automatically Dispose Blocs	link

Todos

• Tests
• Documentation
• Examples

Impact to Remaining Code Base

Breaking change to flutter_bloc API which will be included in flutter_bloc v0.16.0

[jorgecoca]

LGTM! Good job!

[felangel]

LGTM! Good job!

Thanks! 🙏