文章目录
- (一)添加产品APP
- (二)集成SDK
- (三)参数配置
- 权限
- 混淆
- (四)初始化
(一)添加产品APP
一)在个人头像 -> 我的头像 -> 新建产品
二)复制APPID
新建完产品以后,查看产品设置,如下图,App ID要复制好
(二)集成SDK
在Module的build.gradle文件中添加依赖和属性配置:
android {
defaultConfig {
ndk {
// 设置支持的SO库架构
abiFilters "armeabi", "x86_64" // 'x86', 'armeabi-v7a', 'x86_64', 'arm64-v8a'
}
}
}
dependencies {
implementation 'com.tencent.bugly:crashreport:latest.release' //其中latest.release指代最新Bugly SDK版本号,也可以指定明确的版本号,例如4.0.3
}
注意:
4.0.0之前版本,还需要添加nativecrashreport依赖:
implementation 'com.tencent.rqd:nativecrashreport:latest.release' //其中latest.release指代最新Bugly NDK版本号,也可以指定明确的版本号,例如3.9.2
如果在添加“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.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
混淆
请避免混淆Bugly,在Proguard混淆文件中增加以下配置:
-dontwarn com.tencent.bugly.**
-keep public class com.tencent.bugly.**{*;}
(四)初始化
CrashReport.UserStrategy strategy = new CrashReport.UserStrategy(getApplicationContext());
// 通过UserStrategy设置
strategy.setDeviceModel("userdefinedModel");
// 也可以通过CrashReport类设置,适合无法在初始化sdk时获取到deviceModel的场景,context和deviceModel不能为空(或空字符串)
CrashReport.setDeviceModel(context, "HONOR");
strategy.setAppChannel("myChannel"); //设置渠道
strategy.setAppVersion("1.0"); //App的版本
strategy.setAppPackageName("com.example.myapplicationcalculator"); //App的包名
// 也可以通过CrashReport类设置,适合在初始化sdk时无法获取到对应数据的场景,context、appChannel/appVersion/appPackage不能为空(或空字符串)
// CrashReport.setAppChannel(, String appChannel);
// CrashReport.setAppVersion(context, String appVersion);
// CrashReport.setAppPackage(context, String appPackage);
// 设置anr时是否获取系统trace文件,默认为false
// strategy.setEnableCatchAnrTrace(true);
//
// // 设置是否获取anr过程中的主线程堆栈,默认为true
// strategy.setEnableRecordAnrMainStack(true);
CrashReport.initCrashReport(context, "注册时申请的APPID", true, strategy);
注意:
为了保证运营数据的准确性,建议不要在异步线程初始化Bugly。
获取APP ID并调用初始化方法,Bugly会为自动检测环境并完成配置:
CrashReport.initCrashReport(context, "77c05226df", true, strategy);
CrashReport,initCrashReport第三个参数为SDK调试模式开关,调试模式的行为特性如下:
- 输出详细的Bugly SDK的Log;
- 每一条Crash都会被立即上报;
- 自定义日志将会在Logcat中输出。
建议在测试阶段建议设置成true,发布时设置为false。
然后自己设置一个异常进行测试,比如NPE Exception,然后在平台上进行查看监控: