Flutter崩溃报告插件flutter_bugly的使用

腾讯 Bugly 插件，支持Android/iOS 运营统计、原生异常上报、Flutter 异常上报。应用更新可以使用 pgyer_updater。

一、引入

AndroidX

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

dependencies:
  flutter_bugly: lastVersion

Google Play（停止维护）

dependencies:
  flutter_bugly_play: lastVersion

Android Support

dependencies:
  flutter_bugly:
    git:
      url: git://github.com/crazecoder/flutter_bugly.git
      ref: dev

二、项目配置

iOS 配置

如果 iOS 报错 building for iOS Simulator, but linking in object file built for iOS 时，在 ios/Podfile 的 post_install 下加入:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    target.build_configurations.each do |config|
      config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64'
    end
  end
end

Android 配置

在 android/app/build.gradle 的 android 下加入:

lintOptions {
    // 如打包出现Failed to transform libs.jar to match attributes
    checkReleaseBuilds false
}
defaultConfig {
    ndk {
        // 设置支持的 so 库架构 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
        abiFilters 'armeabi-v7a'
    }
}

三、使用

以下是完整的示例代码，展示如何初始化和使用 flutter_bugly 插件进行异常捕获和日志记录。

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

void main() {
  FlutterBugly.postCatchedException(() async {
    WidgetsFlutterBinding.ensureInitialized();
    runApp(MyApp());
    await FlutterBugly.init(
      androidAppId: "your android app id",
      iOSAppId: "your iOS app id",
    );

    // 设置用户信息
    FlutterBugly.setUserId("user id");
    FlutterBugly.putUserData(key: "key", value: "value");
    int tag = 9527;
    FlutterBugly.setUserTag(tag);

    // 示例：上传自定义异常
    try {
      throw Exception("This is a test exception");
    } catch (e, stackTrace) {
      FlutterBugly.uploadException(
        type: e.runtimeType.toString(),
        message: e.toString(),
        detail: stackTrace.toString(),
      );
    }

    // 示例：记录日志
    FlutterBugly.log(tag: "TestTag", message: "This is a test log message", level: LogLevel.INFO);
  });

  // 如果报错 Zone mismatch. 使用下面的方法
  runZonedGuarded(() async {
    WidgetsFlutterBinding.ensureInitialized();
    runApp(MyApp());
  }, (exception, stackTrace) async {
    FlutterBugly.uploadException(
      type: exception.runtimeType.toString(),
      message: exception.toString(),
      detail: stackTrace.toString(),
    );
  });
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              'You have pushed the button this many times:',
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headline4,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: Icon(Icons.add),
      ),
    );
  }
}

四、Release 打包（Android）

64-bit

flutter build apk --release --target-platform android-arm64

32-bit（目前配合 armeabi-v7a 可以打出 32 位 64 位通用包）

flutter build apk --release --target-platform android-arm

五、支持属性（Android）

String channel; // 自定义渠道标识
bool autoCheckUpgrade = true; // 自动检查更新开关
bool autoInit = true; // 自动初始化
bool customUpgrade = true; // 设置是否使用 Flutter 自定义窗口，false 为 Bugly 自带弹窗
int initDelay = 0; // 延迟初始化，单位秒

FlutterBugly.setUserId("user id");
FlutterBugly.putUserData(key: "key", value: "value");
int tag = 9527;
FlutterBugly.setUserTag(tag);