RaiiWidgetsBindingObserver class

A lifecycle implementation that manages the lifecycle of a WidgetsBindingObserver.

This class automatically handles registration and removal of WidgetsBindingObservers with the WidgetsBinding instance. It's particularly useful for managing app lifecycle events, keyboard visibility changes, system settings changes, and other app-wide events.

See also WidgetsBindingRaiiExt.

Example:

// Basic app lifecycle observer
class AppLifecycleObserver with WidgetsBindingObserver {
  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    switch (state) {
      case AppLifecycleState.resumed:
        print('App resumed');
        break;
      case AppLifecycleState.inactive:
        print('App inactive');
        break;
      case AppLifecycleState.paused:
        print('App paused');
        break;
      case AppLifecycleState.detached:
        print('App detached');
        break;
    }
  }
}

// Attach the observer
final lifecycleObserver = AppLifecycleObserver();
RaiiWidgetsBindingObserver.withLifecycle(
  lifecycleAware,
  lifecycleObserver,
  debugLabel: 'AppLifecycle',
);

// System settings observer
class SystemSettingsObserver with WidgetsBindingObserver {
  @override
  void didChangePlatformBrightness() {
    print('Brightness changed');
  }

  @override
  void didChangeLocales(List<Locale>? locales) {
    print('Locales changed');
  }
}

// Attach the system observer
final settingsObserver = SystemSettingsObserver();
RaiiWidgetsBindingObserver.withLifecycle(
  lifecycleAware,
  WidgetsBinding.instance,
  settingsObserver,
  debugLabel: 'SystemSettings',
);