Android平台异常崩溃捕捉处理

原文：https://blog.csdn.net/leeo1010/article/details/50522892

在我们Android开发的过程中，经常碰到app崩溃的状况。目前市面上各种各样的手机，可能不会每个都能兼容，在开发的时候可能不会出现这种状况，但是上线之后，可能会出现个别机型crash的情况。同时开发时由于各种疏忽也会造成有些bug漏洞。在这些情况下，我们就要实时的手机这个报错日志，进行查看和分析。目前有两种处理方案，一个是利用第三方的sdk进行崩溃日志收集，另一个则是实现UncaughtExceptionHandler。

1、第三方崩溃日志处理

目前我所知道的第三方的崩溃日志收集有腾讯的bugly和友盟，接触比较多的也是腾讯，所以接下来我会介绍腾讯的bugly,其实也是借鉴别人的，又不好的地方请大家指导。https://bugly.qq.com/docs/user-guide/instruction-manual-android/?v=20170912151050#_1。具体步骤如下：

 

• • 库文件导入
    • 自动集成（推荐）
      • 集成SDK
      • 同时集成SDK和NDK
    • 手动集成
  • 参数配置
  • 最简单的初始化
  • MultiDex注意事项
  • 增加上报进程控制
  • 测试

库文件导入

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

自动集成（推荐）

Bugly支持JCenter仓库和Maven Central仓库。为了实现更加灵活的配置，Bugly SDK（2.1.5及以上版本）和NDK（SO库）目前已经分开成两个独立的仓库：

• SDK：com.tencent.bugly:crashreport
• NDK：com.tencent.bugly:nativecrashreport

其中，集成Bugly NDK时，需要同时集成Bugly SDK。

集成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库架构
            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 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

手动集成

如果您不采用上述自动导入方式，也可以手动集成Bugly SDK。

下载Bugly库文件

• 下载Bugly的Android SDK包；
• 如果您的工程有Native代码（C/C++）或者集成了其他第三方SO库，建议下载Bugly的NDK动态库。

Bugly NDK包含多个架构的SO库：

• armeabi
• armeabi-v7a
• arm64-v8a
• x86
• x86_64

在集成Bugly SO库时，请注意只保留支持的架构SO库。

Eclipse工程

• 将Bugly库文件复制到工程的libs目录下；
• Refresh一下工程；
• 添加工程依赖：鼠标右键点击Bugly的JAR文件，添加到编译路径中。

Android Studio工程

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

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

• 点击Sync，同步配置。

为了使APP Crash堆栈的可读性更高，建议您配置符号表文件，更准确地定位问题：

• 纯Java代码的工程：只需要配置混淆后生成的Mapping文件即可；
• 含有Native代码的工程：建议配置符号表工具从Debug SO中提取的Symbol符号表文件。

Bugly支持手动和自动配置两种方式，具体的配置方法请参考：《Bugly Android符号表配置》

参数配置

• 在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混淆文件中增加以下配置：

-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。

此外，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>

不同于“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);
  }
}

增加上报进程控制

如果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;
}

测试

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

CrashReport.testJavaCrash();

执行到这段代码时会发生一个Crash，Logcat的TAG=CrashReportInfo中输出为：

现在您已经可以在“崩溃”页面看到刚才触发的Crash issue了（延迟一般在10s以内）。

如果项目包含了Native工程或者使用了代码混淆，建议配置符号表文件

2、实现UncaughtExceptionHandler

 

• 1、https://blog.csdn.net/tangxiaoyin/article/details/80121547
• 2、https://blog.csdn.net/qq_30379689/article/details/53731646
• 一般来说是用try{}catch{}来捕捉异常，但是在开发时候不可能都加上try{}catch{}。第一比较繁琐，第二代码的可读性可不高。所以采取另一种方案。Android崩溃的时候，线程就会终止，系统就通知线程的UncaughtExceptionHandler然后调用uncaughtException方法进行处理。在uncaughtException方法里手机崩溃日志，存储在本地文档里，然后在一定时候上传到服务器。

• public class CrashHandler implements Thread.UncaughtExceptionHandler {
      private static CrashHandler instance;
      private Thread.UncaughtExceptionHandler defaultExceptionHandler;
      private final String TAG = "CrashHandler";
      private Context context;
  
      public static CrashHandler getInstance() {
          if (instance == null) {
              synchronized (CrashHandler.class) {
                  instance = new CrashHandler();
              }
          }
          return instance;
      }
  
      public void init(Context context) {
          // 系统默认的异常处s理器
          this.context = context;
          defaultExceptionHandler = Thread.getDefaultUncaughtExceptionHandler();
          // 将当前实例设为系统默认的异常处理器
          Thread.setDefaultUncaughtExceptionHandler(this);
          // 获取App信息时用户此参数
      }
  
      @Override
      public void uncaughtException(Thread thread, Throwable ex) {
  
          // 导出崩溃信息到日志文件
          dumpExceptionToSDCard(ex);
  
          // 打印崩溃信息到Log日志
          ex.printStackTrace();
  
          // 如果系统提供了默认的异常处理器，则交给系统去结束我们的程序，否则就由我们自己结束自己
          if (null != defaultExceptionHandler) {
              defaultExceptionHandler.uncaughtException(thread, ex);
          } else {
              Process.killProcess(Process.myPid());
          }
      }
  
      // 导出崩溃信息到日志文件
      private void dumpExceptionToSDCard(Throwable ex) {
          // 检测SDCard是否可用--如果不可以在log中给予提醒
          if (!Environment.getExternalStorageState().equals(
                  Environment.MEDIA_MOUNTED)) {
              Log.w(TAG, "SDCard unmounted!");
              return;
          }
          FileUtils.createNewDirectory(FileUtils.getAvailableDevicePath(context) + "/crashLog");
          // 判断Crash文件夹是否存在，如果不存在则创建
          File crashDir = new File("崩溃日志路径");
          if (!crashDir.exists()) {
              crashDir.mkdir();
          }
  
          // 创建当前崩溃日志文件
          String currentTime = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss")
                  .format(new Date(System.currentTimeMillis()));
          String logFileName = currentTime + ".txt";
          File logFile = new File(crashDir, logFileName);
  
          BufferedWriter bufferedWriter = null;
          PrintWriter printWriter = null;
          try {
              bufferedWriter = new BufferedWriter(new FileWriter(logFile));
              printWriter = new PrintWriter(bufferedWriter);
  
              // 崩溃发生时间
              printWriter.write(currentTime);
              // 崩溃手机的系统信息及其用户所用的软件信息
              String phoneInfo = SystemUtils.getPhoneInfoToCrash(context);
              printWriter.write(phoneInfo);
              // 崩溃信息
              ex.printStackTrace(printWriter);
  
              printWriter.flush();
          } catch (IOException e) {
              e.printStackTrace();
          } finally {
              if (null != bufferedWriter) {
                  try {
                      bufferedWriter.close();
                  } catch (IOException e) {
                      e.printStackTrace();
                  }
              }
  
              if (null != printWriter) {
                  printWriter.close();
              }
          }
      }