Flutter崩溃报告与错误监控插件flutter_bugly_play的使用

腾讯Bugly flutter运营统计插件，带更新功能请至flutter_bugly

支持Android/iOS 运营统计、原生异常上报、flutter异常上报、应用更新

一、引入

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

dependencies:
  flutter_bugly_play: lastVersion

二、项目配置

在android/app/build.gradle文件中进行以下配置：

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

三、使用

首先导入插件并初始化：

import 'package:flutter_bugly/flutter_bugly.dart';

// 使用flutter异常上报
void main() => FlutterBugly.postCatchedException(
      () => runApp(MyApp()),
      debugUpload: true, // 在调试模式下上传错误日志
    );

// 初始化插件
FlutterBugly.init(
  androidAppId: "your android app id", // Android应用ID
  iOSAppId: "your iOS app id", // iOS应用ID
  // 自动检查更新功能（可选）
  // autoCheckUpgrade: true,
  // checkUpgradeCount: 0,
  // upgradeCheckPeriod: 60,
);

四、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）

以下是一些常用的API示例：

String channel, // 自定义渠道标识
int initDelay = 0, // 延迟初始化，单位秒

// 设置用户ID
FlutterBugly.setUserId("user id");

// 添加用户数据
FlutterBugly.putUserData(key: "key", value: "value");

// 设置用户标签
int tag = 9527;
FlutterBugly.setUserTag(tag);

完整示例代码

以下是完整的示例代码，展示如何集成和使用flutter_bugly_play插件。

example/lib/main.dart

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

void main() => FlutterBugly.postCatchedException(
      () => runApp(MyApp()),
      debugUpload: true, // 在调试模式下上传错误日志
    );

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomePage(),
    );
  }
}

class HomePage extends StatefulWidget {
  [@override](/user/override)
  State<StatefulWidget> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  String _platformVersion = 'Unknown';

  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化插件
    FlutterBugly.init(
      androidAppId: "5346b6e5bb", // 替换为你的Android App ID
      iOSAppId: "your app id", // 替换为你的iOS App ID
      // 自动检查更新功能（可选）
      // autoCheckUpgrade: true,
      // checkUpgradeCount: 0,
      // upgradeCheckPeriod: 60,
    ).then((_result) {
      setState(() {
        _platformVersion = _result.message;
        print(_result.appId);
      });
    });

    // 设置用户ID
    FlutterBugly.setUserId("user id");

    // 添加用户数据
    FlutterBugly.putUserData(key: "key", value: "value");

    // 设置用户标签
    int tag = 9527;
    FlutterBugly.setUserTag(tag);

    // 自动检查更新功能时，可以省略手动检查
    // if (mounted) _checkUpgrade();
  }

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Plugin example app'),
      ),
      body: GestureDetector(
        onTap: () {
          throw 'test'; // 模拟抛出异常
        },
        child: Center(
          child: Text('init result: $_platformVersion\n'),
        ),
      ),
    );
  }
}