bloc_dev_tools 1.0.1 copy "bloc_dev_tools: ^1.0.1" to clipboard
bloc_dev_tools: ^1.0.1 copied to clipboard

The Remote DevTools package for `flutter_bloc` connects all Blocs to the Remote DevTools server, allowing developers to inspect changes in Bloc states and events during runtime.

Remote Devtools for flutter_bloc #

A Flutter plugin that visualizes state inspection displaying the data inside the state and events changing them.

Features #

  • Supports Cubit and bloc.
  • Inspect bloc state and Event.
  • Supports Skip Action: This allows dropping a state from the list of states in the app.
  • Support Jump Action:This allows jumping to any state and starting the sliding of states from the selected state.
  • Changes to the states made through the dashboard will be rendered on the tested mobile device.
  • Support Slider that tracks all states except skipped states.

Devtools Demo

Installation #

Add the library to pubspec.yaml:

dev_dependencies:
  bloc_dev_tools: ^1.0.0

BlocObserver configuration #

Add RemoteDevToolsObserver to your Bloc.observer:

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  final observer = RemoteDevToolsObserver(
    portNumber: 8000,
    ipAddress: 'localhost',
  );

  await observer.connect();
  Bloc.observer = observer;

  runApp(const CounterApp());
}
/*
Notes About Ip Address on different Devices :

*In real device ip
Find the local IP address of your machine
On Windows:
Open Command Prompt and type ipconfig.
On macOS/Linux:

Open Terminal and type ifconfig (or ip a on Linux).
Look for the inet address under your active network interface (e.g., en0).

*In Simulator
localhost

*In Emulator
10.0.2.2
 */

Making your Events and States Mappable #

Events and States have to implements MappableToJson, MappableFromJson:

class CounterState extends Equatable implements MappableToJson, MappableFromJson {
  final int counter;

  const CounterState({
    required this.counter,
  });

  CounterState copyWith({
    int? counter,
  }) =>
      CounterState(
        counter: counter ?? this.counter,
      );

  @override
  List<Object> get props => [
    counter,
  ];

  @override
  Map<String, dynamic> toJson() => {
    'counter': counter,
  };

  @override
  CounterState fromJson(Map<String, dynamic> json) {
    return CounterState(counter: json['counter']);
  }
}

Using remotedev #

Use the Javascript Remote Devtools package. Start the remotedev server on your machine

npm install -g remotedev-server
remotedev --port 8000

Run your application. It will connect to the remotedev server. You can now debug your flutter_bloc application by opening up http://localhost:8000 in a web browser.

Examples #

4
likes
160
pub points
30%
popularity

Publisher

verified publisher525k.io

The Remote DevTools package for `flutter_bloc` connects all Blocs to the Remote DevTools server, allowing developers to inspect changes in Bloc states and events during runtime.

Repository (GitHub)
View/report issues

Documentation

API reference

License

Apache-2.0 (license)

Dependencies

bloc, flutter, socketcluster_client

More

Packages that depend on bloc_dev_tools