天天看点

Bugly接入、实现线上异常上报并实时通过微信将异常信息发送给开发者

近期项目有一个需求就是统计App的异常信息,并且异常信息要实时的通知到开发者,方便开发者第一时间掌握线上异常,以及客户反馈的异常及时查找问题的所在,后续通过阿里云的HotFix进行线上及时修复。目前市面上使用较多的第三方移动平台质量跟踪主要有友盟、Bugly、网易云捕和crashlytics。其中前三个是国内异常统计的第三方,国内开发者使用较多的也是前三者,目前我个人使用过有友盟和Bugly,这两者接入都很简单,并且后台的异常统计信息也都是很清晰的。

首先我们来看一下Bugly的接入:

注册产品

  • 登录

使用 QQ 登录 Bugly官网

Bugly接入、实现线上异常上报并实时通过微信将异常信息发送给开发者
  • 完善开发者信息

在创建产品之前完善开发者信息: 按照要求填写邮箱,微信号和手机号以便及时收到产品的动态,同时也方便我们和开发这随时保持联系。

Bugly接入、实现线上异常上报并实时通过微信将异常信息发送给开发者
  • 创建应用

按照要求添加应用名称、选择应用平台、产品类型、产品图标和描述信息。

Bugly接入、实现线上异常上报并实时通过微信将异常信息发送给开发者

保存后即创建成功。

Bugly接入、实现线上异常上报并实时通过微信将异常信息发送给开发者

平台功能介绍

应用集成SDK后,即可在Web站点查看应用上报的崩溃数据和联网数据。

异常上报

  • 异常概览

    查看今日实时统计、崩溃趋势、崩溃排行和TOP20崩溃问题等信息
Bugly接入、实现线上异常上报并实时通过微信将异常信息发送给开发者
Bugly接入、实现线上异常上报并实时通过微信将异常信息发送给开发者
  • 崩溃分析/卡顿分析/错误分析

    查看上报问题的列表
Bugly接入、实现线上异常上报并实时通过微信将异常信息发送给开发者
  • 问题详情

    查看上报问题的详细信息
Bugly接入、实现线上异常上报并实时通过微信将异常信息发送给开发者
Bugly接入、实现线上异常上报并实时通过微信将异常信息发送给开发者
  • 高级搜索

    通过各种条件快速查找需要定位分析的异常
Bugly接入、实现线上异常上报并实时通过微信将异常信息发送给开发者

库文件导入

Bugly支持自动集成和手动集成两种方式,如果您使用Gradle编译Apk,强烈推荐您使用自动接入方式配置库文件。

同时集成SDK和NDK

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

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 SDK和NDK的配置如下图所示,后续更新Bugly SDK和NDK时,只需变更配置脚本中的版本号即可。

Bugly接入、实现线上异常上报并实时通过微信将异常信息发送给开发者

注意:自动集成时会自动包含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

参数配置

  • 在AndroidManifest.xml中添加权限:
<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混淆文件中增加以下配置:
-dontwarn com.tencent.bugly.**
-keep public class com.tencent.bugly.**{*;}
           

最简单的初始化

获取APP ID并将以下代码复制到项目Application类onCreate()中,Bugly会为自动检测环境并完成配置:

CrashReport.initCrashReport(getApplicationContext(), "注册时申请的APPID", false); 
           

为了保证运营数据的准确性,建议不要在异步线程初始化Bugly。

第三个参数为SDK调试模式开关,调试模式的行为特性如下:
  • 输出详细的Bugly SDK的Log;
  • 每一条Crash都会被立即上报;
  • 自定义日志将会在Logcat中输出。
建议在测试阶段建议设置成true,发布时设置为false。
Bugly接入、实现线上异常上报并实时通过微信将异常信息发送给开发者

此外,Bugly2.0及以上版本还支持通过“AndroidManifest.xml”来配置APP信息。如果同时又通过代码中配置了APP信息,则最终以代码配置的信息为准。

在“AndroidManifest.xml”的“Application”中增加“meta-data”配置项:

<application
    <!-- 配置APP ID -->
    <meta-data
            android:name="BUGLY_APPID"
            android:value="<APP_ID>" />
    <!-- 配置APP版本号 -->
    <meta-data
            android:name="BUGLY_APP_VERSION"
            android:value="<APP_Version>" />
    <!-- 配置APP渠道号 -->
    <meta-data
            android:name="BUGLY_APP_CHANNEL"
            android:value="<APP_Channel>" />
    <!-- 配置Bugly调试模式(true或者false)-->
    <meta-data
            android:name="BUGLY_ENABLE_DEBUG"
            android:value="<isDebug>" />
</application>
           

不同于“android:versionName”,“BUGLY_APP_VERSION”配置的是Bugly平台的APP版本号。

通过“AndroidManifest.xml”配置后的初始化方法如下:

CrashReport.initCrashReport(getApplicationContext());
           

Bugly默认从“AndroidManifest.xml”文件中读取“VersionName”作为版本号。

MultiDex注意事项

如果使用了MultiDex,建议通过Gradle的“

multiDexKeepFile

”配置等方式把Bugly的类放到主Dex,另外建议在

Application

类的"

attachBaseContext

"方法中主动加载非主dex:

public class MyApplication extends SomeOtherApplication {
  @Override
  protected void attachBaseContext(Context base) {
     super.attachBaseContext(context);
     Multidex.install(this);
  }
}
           

 以上就是Bugly的接入,我们可以写一个bug让程序crash,一分钟左右就可以在Bugly崩溃分析里看到具体的错误信息。那么要想将这些crash信息实时的发送给开发者该怎么处理呢?Bugly提供了一项功能,如图所示:

Bugly接入、实现线上异常上报并实时通过微信将异常信息发送给开发者

在这个地方绑定微信以后Bugly就会统计一个小时内的异常发送给绑定用户的人,以上就是Bugly的接入和异常统计上报的流程,有不明白的小伙伴可以给我评论留言。