Flutter崩溃捕获与分析插件tencent_bugly_plugin的使用

Flutter崩溃捕获与分析插件tencent_bugly_plugin的使用

flutter_bugly_plugin

Flutter Bugly 插件，只集成了崩溃统计。

Bugly版本

• Android Bugly Version: 4.1.9.3
• IOS Bugly Version: 2.6.1

使用

在pubspec.yaml文件中添加依赖：

dependencies:
  tencent_bugly_plugin: ^latest

混淆

Android需要配置混淆：

-dontwarn com.tencent.bugly.**
-keep public class com.tencent.bugly.**{*;}

初始化

在任意区域调用。androidID与ios为必传参数，其他为可选项。flutterError为Flutter错误回调。

BuglyPlugin.initBugly(
  BuglyConfig(
    androidAppId: "your android AppId",
    iosAppId: "your ios AppId",
    channel: "your channel",
    debugMode: true,
  ), 
  flutterError: (flutterError) {
    print("receive error: $flutterError");
    print("errorinfo = ${flutterError.exception};");
    print("stack = ${flutterError.stack}");
  }
);

上报自己try catch的异常

BuglyPlugin.reportException(String errorInfo, String errorStack);

Dart触发的错误将在Bugly的错误界面上显示。

完整示例Demo

以下是一个完整的示例Demo，展示了如何使用tencent_bugly_plugin插件来捕获和分析崩溃。

import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:tencent_bugly_plugin/bugly_config.dart';
import 'package:tencent_bugly_plugin/bugly_plugin.dart';

void main() {
  // 初始化Bugly插件
  BuglyPlugin.initBugly(
    BuglyConfig(
      androidAppId: "b9668c775a", // 你的Android AppId
      iosAppId: "15910284fd", // 你的iOS AppId
      channel: "Demo", // 渠道
      debugMode: true, // 调试模式
    ), 
    flutterError: (flutterError) {
      print("receive error: $flutterError");
      print("errorinfo = ${flutterError.exception};");
      print("stack = ${flutterError.stack}");
    }
  );
  
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown';

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 异步初始化平台状态
  Future<void> initPlatformState() async {
    String platformVersion;
    
    // 使用try/catch处理可能的平台异常
    try {
      platformVersion = await BuglyPlugin.getPlatformVersion() ?? 'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    // 如果组件已经从树中移除，则不更新UI
    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: Column(
            children: [
              Text('Running on: $_platformVersion\n'),
              ElevatedButton(
                onPressed: () {
                  // 抛出一个测试异常
                  throw Exception('OnlyTestFlutterCodeCrash');
                },
                child: Text("Test DartCrash"),
              ),
              ElevatedButton(
                onPressed: () {
                  // 触发原生代码崩溃测试
                  BuglyPlugin.testNativeCrash();
                },
                child: Text("Test NativeCrash"),
              )
            ],
          ),
        ),
      ),
    );
  }
}