owlscopeAuto function

void owlscopeAuto(void body(), { String name = 'flutter-app', String host = 'localhost', int port = 9090, int httpMaxBodyBytes = defaultMaxBodyBytes, bool enableInRelease = false, })

Implementation

void owlscopeAuto(
  void Function() body, {
  String name = 'flutter-app',
  String host = 'localhost',
  int port = 9090,
  // Per-body capture cap for the HTTP plugin. Defaults to 16 MiB. Pass `0`
  // for unlimited — useful when debugging huge JSON payloads, but a runaway
  // download will buffer entirely in memory.
  int httpMaxBodyBytes = defaultMaxBodyBytes,
  // Set to `true` when profiling release builds — `flutter run --release`
  // strips assertions and enables AOT, which is the only way to see real
  // production performance numbers. Off by default so a shipped app
  // doesn't try to open a debug socket on user devices.
  //
  // Android: also run `dart run owlscope:setup` once — it installs a
  // Network Security Config that allows cleartext only to `localhost`
  // and the emulator IPs, leaving the rest of the app HTTPS-only.
  bool enableInRelease = false,
}) {
  OwlScopeRunner.guard(() {
    if (kReleaseMode && !enableInRelease) {
      // No-op in release: just run the body without any instrumentation.
      body();
      return;
    }

    OwlScope.configure(
      name: name,
      host: host,
      port: port,
      plugins: const PluginConfig(
        printPlugin: true,
        http: true,
        errors: true,
        navigation: true,
        performance: true,
      ),
    )
      ..use(ErrorPlugin())
      ..use(HttpPlugin(maxBodyBytes: httpMaxBodyBytes))
      ..use(PerformancePlugin())
      ..use(NavigationPlugin(owlscopeNavigatorObserver));

    body();
  });
}