Flutter应用中第三方异常上报服务

贺公子之数据科学与艺术

发布于 2025-12-18 09:41:46

1050

Dart接口实现

在Flutter中集成Bugly或其他第三方异常上报服务，通常需要通过插件方式调用原生平台SDK。以下是一个简单的Dart层封装示例：

class BuglyReport {
  static const MethodChannel _channel = MethodChannel('bugly_report');

  static Future<void> init(String appId) async {
    await _channel.invokeMethod('init', {'appId': appId});
  }

  static Future<void> reportException({
    required String error,
    required String stackTrace,
    Map<String, dynamic>? extraInfo,
  }) async {
    await _channel.invokeMethod('reportException', {
      'error': error,
      'stackTrace': stackTrace,
      'extraInfo': extraInfo,
    });
  }
}

原生平台实现

对于Android平台，需要在MainActivity中初始化Bugly并实现异常上报：

public class BuglyPlugin implements MethodCallHandler {
    private final Activity activity;

    BuglyPlugin(Activity activity) {
        this.activity = activity;
    }

    public static void registerWith(Registrar registrar) {
        final MethodChannel channel = new MethodChannel(registrar.messenger(), "bugly_report");
        channel.setMethodCallHandler(new BuglyPlugin(registrar.activity()));
    }

    @Override
    public void onMethodCall(MethodCall call, Result result) {
        if (call.method.equals("init")) {
            String appId = call.argument("appId");
            CrashReport.initCrashReport(activity.getApplicationContext(), appId, false);
            result.success(null);
        } else if (call.method.equals("reportException")) {
            String error = call.argument("error");
            String stackTrace = call.argument("stackTrace");
            Map<String, String> extraInfo = call.argument("extraInfo");
            
            CrashReport.postException(
                4, // Exception type
                "Flutter Exception", 
                error, 
                stackTrace, 
                extraInfo
            );
            result.success(null);
        } else {
            result.notImplemented();
        }
    }
}

异常捕获与上报集成

将异常捕获与上报服务结合，修改之前的Zone配置：

void main() {
  FlutterError.onError = (FlutterErrorDetails details) {
    Zone.current.handleUncaughtError(details.exception, details.stack!);
  };

  runZoned<Future<void>>(() async {
    await BuglyReport.init('YOUR_APP_ID');
    runApp(MyApp());
  }, onError: (error, stackTrace) async {
    await BuglyReport.reportException(
      error: error.toString(),
      stackTrace: stackTrace.toString(),
      extraInfo: {
        'platform': Platform.operatingSystem,
        'version': Platform.version,
      },
    );
  });
}

自定义错误页面改进

增强错误页面的用户体验，同时确保异常信息被上报：

ErrorWidget.builder = (FlutterErrorDetails details) {
  WidgetsBinding.instance.addPostFrameCallback((_) {
    BuglyReport.reportException(
      error: details.exceptionAsString(),
      stackTrace: details.stack?.toString() ?? '',
    );
  });
  
  return Scaffold(
    body: Center(
      child: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          Icon(Icons.error_outline, size: 48, color: Colors.grey),
          SizedBox(height: 16),
          Text('发生了一些问题', style: TextStyle(fontSize: 18)),
          SizedBox(height: 8),
          Text('我们已记录该问题', style: TextStyle(color: Colors.grey)),
          SizedBox(height: 24),
          ElevatedButton(
            child: Text('重试'),
            onPressed: () => Navigator.of(context).pushReplacement(...),
          ),
        ],
      ),
    ),
  );
};