Bugly 使用小计

发表于 更新于 分类于

原来项目中的 crash 统计一直使用的友盟统计，最近项目需要集成热更新、热修复的功能，故选择腾讯旗下的 Bugly 来作统计、修复之用。

1、集成 Bugly 统计功能

1.1 Gradle 中集成

注册 Bugly、新建应用就不多赘述了，我们直接看看如何在项目中使用吧。

在Module的build.gradle文件中添加依赖和属性配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
android {
    defaultConfig {
        ndk {
            // 设置支持的SO库架构
            abiFilters 'armeabi' //, 'x86', 'armeabi-v7a', 'x86_64', 'arm64-v8a'
        }
    }
}

dependencies {
    compile 'com.tencent.bugly:crashreport:latest.release' //其中latest.release指代最新Bugly SDK版本号，也可以指定明确的版本号，例如2.1.9
    compile 'com.tencent.bugly:nativecrashreport:latest.release' //其中latest.release指代最新Bugly NDK版本号，也可以指定明确的版本号，例如3.0
}

注意：自动集成时会自动包含Bugly SO库，建议在Module的build.gradle文件中使用NDK的“abiFilter”配置，设置支持的SO库架构。
如果在添加“abiFilter”之后Android Studio出现以下提示：
NDK integration is deprecated in the current plugin. Consider trying the new experimental plugin.
则在项目根目录的gradle.properties文件中添加：
android.useDeprecatedNdk=true

1.2 参数配置

在AndroidManifest.xml中添加权限：

1
2
3
4
5
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_LOGS" />

注：如果您的App需要上传到google play store，您需要将READ_PHONE_STATE权限屏蔽掉或者移除，否则可能会被下架。

请避免混淆Bugly，在Proguard混淆文件中增加以下配置：

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

1.3 初始化

获取APP ID并将以下代码复制到项目Application类onCreate()中，Bugly会为自动检测环境并完成配置：
CrashReport.initCrashReport(getApplicationContext(), "注册时申请的APPID", false);
为了保证运营数据的准确性，建议不要在异步线程初始化Bugly。

第三个参数为SDK调试模式开关，调试模式的行为特性如下：

  • 输出详细的 Bugly SDK 的 Log；
  • 每一条Crash都会被立即上报；
  • 自定义日志将会在Logcat中输出。

建议在测试阶段建议设置成true，发布时设置为false。

更多集成注意事项，请参考官方文档。

完成以上三步之后既可以在 Bugly 的应用管理页面查看 App 的崩溃日志以及运营情况，这一点与友盟统计大同小异，可以根据自己需要取舍。

2、集成升级与热修复功能

参考官方手册一步步操作：https://bugly.qq.com/docs/user-guide/instruction-manual-android-hotfix/?v=20180709165613#_3