错误日志收集-Bugly集成

Bugly Android SDK 使用

Bugly是腾讯提供的专业Crash、Android ANR、ios卡顿解决方案，24小时实时监控和告警，可以及时发现异常问题。

自动集成方式（推荐）

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时，只需变更配置脚本中的版本号即可。latest.release 代表最新版本号

如果在添加abiFilter之后Android Studio出现以下提示：
NDK integration is deprecated in the current plugin. Consider trying the new experimental plugin.
则在项目根目录的gradle.properties文件中添加：
android.useDeprecatedNdk=true

手动集成方式
将Bugly库文件复制到工程的libs目录下；
如果集成Bugly NDK，则在Module的buid.gradle文件中添加SO库目录配置：

android {
    sourceSets {
        main.jniLibs.srcDirs = ['libs']
    }
}

点击Sync，同步配置。

参数配置

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" />

混淆配置

为了避免混淆Bugly，需要在proguard-rules.pro加入以下配置

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

最简单的初始化

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

第三个参数为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="" />
    
    <meta-data
            android:name="BUGLY_APP_VERSION"
            android:value="" />
    
    <meta-data
            android:name="BUGLY_APP_CHANNEL"
            android:value="" />
    
    <meta-data
            android:name="BUGLY_ENABLE_DEBUG"
            android:value="" />
application>

“BUGLY_APP_VERSION”配置的是Bugly平台的APP版本号

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

CrashReport.initCrashReport(getApplicationContext());

增加上报进程控制

如果App使用了多进程且各个进程都会初始化Bugly（例如在Application类onCreate()中初始化Bugly），那么每个进程下的Bugly都会进行数据上报，造成不必要的资源浪费。
因此，为了节省流量、内存等资源，建议初始化的时候对上报进程进行控制，只在主进程下上报数据：判断是否是主进程（通过进程名是否为包名来判断），并在初始化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));
// 初始化Bugly
CrashReport.initCrashReport(context, "注册时申请的APPID", isDebug, strategy);
// 如果通过“AndroidManifest.xml”来配置APP信息，初始化方法如下
// CrashReport.initCrashReport(context, strategy);

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

/**
 * 获取进程号对应的进程名
 * 
 * @param pid 进程号
 * @return 进程名
 */
private static String getProcessName(int pid) {
    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;
}

登录并进入“我的产品”，点击对应的应用即可看到对应的错误信息

MultiDex注意事项

如果使用了MultiDex，配置build.gradle

android {
    multiDexEnabled true // Enable MultiDex.
}
...
}
dependencies {
    compile 'com.android.support:multidex:1.0.0'
}

在代码里启动 MultiDex

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

参考：Bugly Android SDK集成文档