Android使用bugly捕捉异常

前言

之前给项目用过一次bugly，说实话腾讯的这个bugly还是挺方便的，捕捉异常，热更，应用升级，都可以实现，但是太长时间没用，都快给忘记了，今天决定做笔记记录一下

集成SDK

在 $\color{red}{Module}$ 的 $\color{red}{build.gradle}$ 文件中添加依赖和配置属性

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

同时集成SDK和NDK

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}

$\color{red}{注意：自动集成时会自动包含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" />

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

混淆bugly

-dontwarn com.tencent.bugly.**

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

Bugly初始化

获取APP ID并将一下代码复制到Application类onCreate()中,Bugly会自动完成初始化

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

为保证数据准确性，不要在异步线程中初始化bugly

$\color{red}{APPID可以在产品设置中查看}$

第三个参数是控制sdk调试模式的开关，打开后特性如下

输出详细的Bugly SDK的Log；

每一条Crash都会被立即上报；

自定义日志将会在Logcat中输出。

其他

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

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

<application

<meta-data

android:name="BUGLY_APPID"

android:value="<APP_ID>" />



<meta-data

android:name="BUGLY_APP_VERSION"

android:value="<APP_Version>" />



<meta-data

android:name="BUGLY_APP_CHANNEL"

android:value="<APP_Channel>" />



<meta-data

android:name="BUGLY_ENABLE_DEBUG"

android:value="<isDebug>" />

</application>

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

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

CrashReport.initCrashReport(getApplicationContext());

MultiDex注意事项

如果使用了MultiDex，建议通过Gradle的“multiDexKeepFile”配置等方式把Bugly的类放到主Dex，另外建议在Application类的"attachBaseContext"方法中主动加载非主dex：

public classMyApplicationextendsSomeOtherApplication{

@Override protectedvoidattachBaseContext(Context base){

super.attachBaseContext(context);

Multidex.install(this);

}

}

增加上报进程控制

如果App使用了多进程且各个进程都会初始化Bugly（例如在Application类onCreate()中初始化Bugly），那么每个进程下的Bugly都会进行数据上报，造成不必要的资源浪费。

因此，为了节省流量、内存等资源，建议初始化的时候对上报进程进行控制，$\color{red}{只在主进程下上报数据}$：判断是否是主进程（通过进程名是否为包名来判断），并在初始化Bugly时增加一个上报进程的策略配置。

Context context = getApplicationContext();// 获取当前包名String packageName = context.getPackageName();// 获取当前进程名String processName = getProcessName(android.os.Process.myPid());// 设置是否为上报进程UserStrategy strategy = new UserStrategy(context);

strategy.setUploadProcess(processName == null || processName.equals(packageName));// 初始化BuglyCrashReport.initCrashReport(context, "注册时申请的APPID", isDebug, strategy);// 如果通过“AndroidManifest.xml”来配置APP信息，初始化方法如下// CrashReport.initCrashReport(context, strategy);

其中获取进程名的方法“getProcessName”有多种实现方法，推荐方法如下：

/** * 获取进程号对应的进程名 * * @parampid 进程号 * @return进程名 */privatestaticStringgetProcessName(intpid){

BufferedReader reader = null;

try {

reader = new BufferedReader(new FileReader("/proc/" + pid + "/cmdline"));

String processName = reader.readLine();

if (!TextUtils.isEmpty(processName)) {

processName = processName.trim();

}

return processName;

} catch (Throwable throwable) {

throwable.printStackTrace();

} finally {

try {

if (reader != null) {

reader.close();

}

} catch (IOException exception) {

exception.printStackTrace();

}

}

return null;

}

测试

现在您可以制造一个Crash（建议通过“按键”来触发），来体验Bugly的能力了。在初始化Bugly的之后，调用Bugly测Java Crash接口

CrashReport.testJavaCrash();

$\color{red}{此文章仅仅是捕捉异常，如果用到应用升级或者热更新功能}$ ，请看官方文档应用升级功能简介 - Bugly 文档