jhDebugMain function

dynamic jhDebugMain({ required Widget appChild, required dynamic errorCallback(FlutterErrorDetails details)?, Function? beforeAppChildFn, DebugMode debugMode = JhConstants.ISIN_DEBUGMODE, dynamic errorWidgetFn<Widget>(String message, Object error)?, })

main入口函数修饰器

appChild runApp()内的页面组件

debugMode 错误日志输出模式，self原生模式（部份错误日志不会被打印到插件中）,inConsole将错误日志映射到插件中（开启IDE情况下，ide控制台及插件同时有错误日志）, none不映射日志（真机上依然可以捕获）

errorCallback 错误回调函数,返回错误相关信息,自定义上报错误等信息

errorWidgetFn 自定义错误显示页面，默认使用flutter内置错误页面

beforeAppChildFn 构建appChild之前钩子函数（会阻塞页面渲染），不要放过重逻辑在此函数中

Implementation

jhDebugMain({
  required Widget appChild,
  required Function(FlutterErrorDetails details)? errorCallback,
  Function? beforeAppChildFn,
  DebugMode debugMode = JhConstants.ISIN_DEBUGMODE,
  Function<Widget>(String message, Object error)? errorWidgetFn,
}) {
  if (debugMode != DebugMode.self) {
    FlutterError.onError = (FlutterErrorDetails details) {
      Zone.current
          .handleUncaughtError(details.exception, details.stack as StackTrace);
    };

    ErrorWidget.builder = (FlutterErrorDetails details) {
      Zone.current
          .handleUncaughtError(details.exception, details.stack as StackTrace);
      String message = '';
      assert(() {
        String _stringify(Object exception) {
          try {
            return exception.toString();
          } catch (e) {
            // intentionally left empty.
          }
          return 'Error';
        }

        message = _stringify(details.exception) +
            '\nSee also: https://flutter.dev/docs/testing/errors';
        return true;
      }());
      final Object exception = details.exception;
      if (errorWidgetFn != null) return errorWidgetFn(message, exception);
      return ErrorWidget.withDetails(
          message: message,
          error: exception is FlutterError ? exception : null);
    };
  }

  return runZonedGuarded(
    () async {
      WidgetsFlutterBinding.ensureInitialized();
      if (beforeAppChildFn != null) {
        try {
          await beforeAppChildFn();
        } catch (e) {}
        runApp(appChild);
        return;
      }
      runApp(appChild);
    },

    /// zone错误回调函数
    ((error, stack) {
      jhDebug.setDebugLog(
        debugLog: error.toString(),
        debugStack: stack.toString(),
      );

      /// 错误信息
      FlutterErrorDetails details = FlutterErrorDetails(
        exception: error,
        stack: stack,
        library: 'Flutter JH_DEBUG',
      );
      if (debugMode == DebugMode.inConsole) {
        FlutterError.dumpErrorToConsole(details);
      }

      // 自定义上报错误
      if (errorCallback != null) errorCallback(details);
    }),
    zoneSpecification: new ZoneSpecification(
      print: (Zone self, ZoneDelegate parent, Zone zone, String line) {
        jhDebug.setPrintLog("$line");
        parent.print(self, "$line");
      },
    ),
  );
}