前言
对于Bug相信对于所有的开发者而言都是噩梦,没有一个app是完美的,尤其是android开发需要适配的版本太多了,而且每个厂商都是定制化的系统,而且android系统还在不断的升级以及新的api的增加,这导致对于bug的调试有许多的局限性,不可能第一次上线就适配所有的使用者,我们只能收集在线收集app出现的bug,以前都是直接使用bug的log,在通过发送服务器进行bug修复在打包上版本。每个app都会上架多个渠道(应用宝,360手机助手,百度,小米,华为等等),这样的成本真的太高了。所有热更新就横空出世了,今天要介绍的主题就是 腾讯Bugly,集成Bug的异常上报以及tinker热更新的集成。
首先需要介绍的是腾讯Bugly的异常上报,App在运行过程中发生的崩溃、卡顿、ANR、错误时候,Bugly会将这些错误信息都收集起来,上传到腾讯Bugly平台,并且会对异常的统计,其中最关键的信息是可以收集到设备机型,手机的ROM版本以及手机的系统版本以及CPU框架等等,让你在处理Bug的时候得心应手。
如何在android项目中集成Bugly。
第一步:需要到Bugly官网去注册一个Bugly账号,注册流程就不附上了。
第二部:需要在我们的项目中集成Bugly异常上报,这里只提供了android studio的集成流程(可能还有些人在使用eclipse开发,希望尽快的转到android studio,好不好只有用了才知道)
Bugly支持JCenter仓库和Maven Central仓库。为了实现更加灵活的配置,Bugly SDK(2.1.5及以上版本)和NDK(SO库)目前已经分开成两个独立的仓库:如果你的项目中右使用到ndk的代码需要集成Bugly NDK,需要也同时集成Bugly SDK。
如果只是需要集成Bugly SDK
在Module的build.gradle文件中添加依赖和属性配置:
dependencies {
compile'com.tencent.bugly:crashreport:latest.release'
//其中latest.release指代最新Bugly SDK版本号,也可以指定明确的版本号,例如2.2.0}
同时集成SDK和NDK
在Module的build.gradle文件中添加依赖和属性配置:
android {
defaultConfig {
ndk {
// 设置支持的SO库架构 注意如果是虚拟机使用的话需要吧x86加上去 否则无法运行的
abiFilters'armeabi' //, 'x86', 'armeabi-v7a', 'x86_64', 'arm64-v8a'}
}
}
dependencies {
compile'com.tencent.bugly:crashreport:latest.release'
//其中latest.release指代最新Bugly SDK版本号,也可以指定明确的版本号,例如2.1.9compile'com.tencent.bugly:nativecrashreport:latest.release'
//其中latest.release指代最新Bugly NDK版本号,也可以指定明确的版本号,例如3.0}
参数配置
需要在AndroidManifest配置权限
<uses-permissionandroid:name="android.permission.READ_PHONE_STATE"/>
<uses-permissionandroid:name="android.permission.INTERNET"/>
<uses-permissionandroid:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permissionandroid:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permissionandroid:name="android.permission.READ_LOGS"/>
<uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
如果你开启混淆了,需要在proguard混淆文件中加入:
-dontwarn com.tencent.bugly.**
-keep public class com.tencent.bugly.**{*;}
到这里Bugly异常上报的集成流程就已经结束了,下面就是如何使用bugly了。
初始化Bugly
获取APP ID并将以下代码复制到项目Application类onCreate()中(只是建议,你也可以在需要的地方才初始化),Bugly会为自动检测环境并完成配置:
CrashReport.initCrashReport(getApplicationContext(),"注册时申请的APPID",false);
CrashReport.setUserId(this,"用户ID"); 这里的UserId可以自定义传递,可以用来传递电话号码,方便后期的Bug修复跟进。
这里的APPID对应每个我们新建的app,我们需要在Bugly平台上创建App,点击下图中的设置就可以找到需要的APPID,就可以完成对Bugly的初始化了。
第三个参数为SDK调试模式开关,调试模式的行为特性如下:
输出详细的Bugly SDK的Log;
每一条Crash都会被立即上报;
自定义日志将会在Logcat中输出。
建议在测试阶段建议设置成true,发布时设置为false。
此外,Bugly2.0及以上版本还支持通过“AndroidManifest.xml”来配置APP信息。如果同时又通过代码中配置了APP信息,则最终以代码配置的信息为准。
在“AndroidManifest.xml”的“Application”中增加“meta-data”配置项:
<application
<!--配置APP ID-->
<meta-data
android:name="BUGLY_APPID"
android:value="<你的APPID>" />
<!--配置APP版本号-->
<meta-data
android:name="BUGLY_APPID"
android:value="<APP_Version>" />
<!--配置APP渠道号-->
<meta-data
android:name="BUGLY_APPID"
android:value="APP_Channel" />
<!--配置Bugly调试模式(true或者false)-->
<meta-data
android:name="BUGLY_APPID"
android:value="IsDeBug" />
</application>
通过“AndroidManifest.xml”配置后的初始化方法如下:
CrashReport.initCrashReport(getApplicationContext());
最后我们需要去检查代码的异常了:
运行异常代码(SecondActivity没有在AndroidManifest中注册)
运行之后我们可以在Bugly的异常分为 异常分析以及ANR分析:
Bugly提供的异常分析有2个比较重要的部分:
第一部分包括了出现异常手机的设备信息:
其中比较重要的有用户ID 这里Bugly提供了API可以自定义上传内容,我们可以获取到该用户的手机号码作为用户ID(注意手机号码的获取需要权限在android6.0以上的处理,防止报错),以便于我们后期需要跟进BUG的修复问题。
CrashReport.setUserId(this,"用户ID");
还有一些基本设备机型以及android版本,ROM(不同厂商)以及CPU构架(这里使用的是虚拟机是X86)
第二部分是异常的的定位,方便我们查找异常以及解决bug:
到这里就是bugly异常上报的基本使用了,其实还有许多的用户信息统计以及日活跃用户的统计。
最后附上 腾讯Bugly热更新的集成以及问题