initServiceExtensions method

  1. @override
void initServiceExtensions()
override

Called when the binding is initialized, to register service extensions.

Bindings that want to expose service extensions should overload this method to register them using calls to registerSignalServiceExtension, registerBoolServiceExtension, registerNumericServiceExtension, and registerServiceExtension (in increasing order of complexity).

Implementations of this method must call their superclass implementation.

A registered service extension can only be activated if the vm-service is included in the build, which only happens in debug and profile mode. Although a service extension cannot be used in release mode its code may still be included in the Dart snapshot and blow up binary size if it is not wrapped in a guard that allows the tree shaker to remove it (see sample code below).

The following code registers a service extension that is only included in debug builds.
link
void myRegistrationFunction() {
  assert(() {
    // Register your service extension here.
    return true;
  }());
}

A service extension registered with the following code snippet is available in debug and profile mode.
link
void myOtherRegistrationFunction() {
  // kReleaseMode is defined in the 'flutter/foundation.dart' package.
  if (!kReleaseMode) {
    // Register your service extension here.
  }
}

Both guards ensure that Dart's tree shaker can remove the code for the service extension in release builds.

See also:

Implementation

@override
void initServiceExtensions() {
  super.initServiceExtensions();

  if (!kReleaseMode) {
    registerServiceExtension(
      name: WidgetsServiceExtensions.debugDumpApp.name,
      callback: (Map<String, String> parameters) async {
        final String data = _debugDumpAppString();
        return <String, Object>{
          'data': data,
        };
      },
    );

    registerServiceExtension(
      name: WidgetsServiceExtensions.debugDumpFocusTree.name,
      callback: (Map<String, String> parameters) async {
        final String data = focusManager.toStringDeep();
        return <String, Object>{
          'data': data,
        };
      },
    );

    if (!kIsWeb) {
      registerBoolServiceExtension(
        name: WidgetsServiceExtensions.showPerformanceOverlay.name,
        getter: () =>
        Future<bool>.value(WidgetsApp.showPerformanceOverlayOverride),
        setter: (bool value) {
          if (WidgetsApp.showPerformanceOverlayOverride == value) {
            return Future<void>.value();
          }
          WidgetsApp.showPerformanceOverlayOverride = value;
          return _forceRebuild();
        },
      );
    }

    registerServiceExtension(
      name: WidgetsServiceExtensions.didSendFirstFrameEvent.name,
      callback: (_) async {
        return <String, dynamic>{
          // This is defined to return a STRING, not a boolean.
          // Devtools, the Intellij plugin, and the flutter tool all depend
          // on it returning a string and not a boolean.
          'enabled': _needToReportFirstFrame ? 'false' : 'true',
        };
      },
    );

    registerServiceExtension(
      name: WidgetsServiceExtensions.didSendFirstFrameRasterizedEvent.name,
      callback: (_) async {
        return <String, dynamic>{
          // This is defined to return a STRING, not a boolean.
          // Devtools, the Intellij plugin, and the flutter tool all depend
          // on it returning a string and not a boolean.
          'enabled': firstFrameRasterized ? 'true' : 'false',
        };
      },
    );

    // Expose the ability to send Widget rebuilds as [Timeline] events.
    registerBoolServiceExtension(
      name: WidgetsServiceExtensions.profileWidgetBuilds.name,
      getter: () async => debugProfileBuildsEnabled,
      setter: (bool value) async {
        debugProfileBuildsEnabled = value;
      }
    );
    registerBoolServiceExtension(
      name: WidgetsServiceExtensions.profileUserWidgetBuilds.name,
      getter: () async => debugProfileBuildsEnabledUserWidgets,
      setter: (bool value) async {
        debugProfileBuildsEnabledUserWidgets = value;
      }
    );
  }

  assert(() {
    registerBoolServiceExtension(
      name: WidgetsServiceExtensions.debugAllowBanner.name,
      getter: () => Future<bool>.value(WidgetsApp.debugAllowBannerOverride),
      setter: (bool value) {
        if (WidgetsApp.debugAllowBannerOverride == value) {
          return Future<void>.value();
        }
        WidgetsApp.debugAllowBannerOverride = value;
        return _forceRebuild();
      },
    );

    WidgetInspectorService.instance.initServiceExtensions(registerServiceExtension);

    return true;
  }());
}