wrs-bugly腾讯Bugly插件

2021-07-09 本文已影响0人浪人残风

前言

wrs-bugly是腾讯Bugly官方插件

功能

APP检查应用版本升级
运营统计
异常上报，bug奔溃闪退日志

原生插件通用使用流程

HBuildX集成原生插件请参考:https://www.jianshu.com/p/1418c9e73eb3 或官网https://nativesupport.dcloud.net.cn/NativePlugin/use/use

wrs-bugly插件

使用步骤：

腾讯Bugly官网申请应用

到腾讯Bugly官网创建android、iOS应用，记录下应用的App ID

初始化插件

在App.vue应用启动时初始化插件,appId替换成腾讯Bugly官网创建的应用App ID.

    var bugly = uni.requireNativePlugin("wrs-bugly");
    export default {
        onLaunch: function() {
            console.log('App Launch')
            var options = {};
            switch (uni.getSystemInfoSync().platform) {
                case 'android':
                    options.appId = 'a2452039c6';
                    // options.strategy = {
                    //  "channel": "小米",
                    //  "version": "1.0.1",
                    //  "packageName": "com.wrs.project"
                    // };
                    // options.autoCheckUpgrade = true;
                    // options.autoDownloadOnWifi = true;
                    // options.autoDownloadOn4g = false;
                    break;
                case 'ios':
                    options.appId = '277da62019';
                    break;
                default:
                    break;
            }
            
            bugly.init(options);
        },

strategy参数用于渠道打包，一般业务都用不上strategy参数
channel: 渠道包
version: 版本号
packageName: 包名

其他常用参数：
autoCheckUpgrade: 是否自动检查升级
autoDownloadOnWifi: wifi网络是否自动下载新包
autoDownloadOn4g: 4G网络是否自动下载新包

API功能

检查更新(只支持Android)

用于在APP设置页“检查更新”按钮功能

bugly.checkUpgrade();

获取本地已有升级策略(只支持Android)

获取本地已经下载的更新包，用于“检查更新”按钮旁边是否显示红点

                bugly.getUpgradeInfo((resp) => {
                    var infoStr = JSON.stringify(resp);
                    console.log("getUpgradeInfo:" + infoStr);
                });

设置用户ID

设置用户ID 您可能会希望能精确定位到某个用户的异常，我们提供了用户ID记录接口。例：网游用户登录后，通过该接口记录用户ID，在页面上可以精确定位到每个用户发生Crash的情况

                var options = {};
                options.userId = "1024222221xxxs";
                bugly.setUserId(options);

主动上报异常

主动上报开发者Catch的异常您可能会关注某些重要异常的Catch情况。我们提供了上报这类异常的接口。例：统计某个重要的数据库读写问题比例。

                
                var options = {};
                options.name = "EmpytException"; // 异常名称
                options.reason = "value is null"; // 异常原因
                options.userInfo = {}; // 用户数据
                bugly.postCatchedException(options);

自定义标签

自定义标签，用于标明App的某个“场景”。在发生Crash时会显示该Crash所在的“场景”，以最后设置的标签为准，标签id需大于0。例：当用户进入界面A时，打上9527的标签

                var options = {};
                options.userSceneTag = 1024;
                bugly.setUserSceneTag(options);

设置自定义Map参数

自定义Map参数可以保存发生Crash时的一些自定义的环境信息。在发生Crash时会随着异常信息一起上报并在页面展示。
最多可以有9对自定义的key-value（超过则添加失败）；
key限长50字节，value限长200字节，过长截断；
key必须匹配正则：[a-zA-Z[0-9]]+

                var options = {};
                options.userData = {
                    "account": "123456",
                    "age": 24,
                    "sex": "男"
                };
                bugly.putUserData(options);

自定义日志功能

自定义日志功能我们提供了自定义Log的接口，用于记录一些开发者关心的调试日志，可以更全面地反应App异常时的前后文环境。使用方式与android.util.Log一致。用户传入TAG和日志内容。该日志将在Logcat输出，并在发生异常时上报。

                var options = {};
                options.tag = "index.nvue";
                options.log = "登录";
                bugly.log(options);

组件文档:https://www.jianshu.com/p/545786e91f43 <br />