Android的Crash日志记录

转载于：http://blog.youkuaiyun.com/singwhatiwanna/article/details/17289479

一、前言

大家都知道，Android应用不可避免的会发生crash，无论你的程序写的多完美，总是无法完全避免crash的发生，可能是由于android系统底层的bug，也可能是由于不充分的机型适配或者是糟糕的网络状况。当crash发生时，系统会kill掉你的程序，表现就是闪退或者程序已停止运行，这对用户来说是很不友好的，也是开发者所不愿意看到的，更糟糕的是，当用户发生了crash，开发者却无法得知程序为何crash，即便你想去解决这个crash，但是由于你无法知道用户当时的crash信息，所以你也无能为力。是否真的这样呢，其实android中有处理这类问题的方法，请看下面Thread类中的一个方法#setDefaultUncaughtExceptionHandler

    /**
     * Sets the default uncaught exception handler. This handler is invoked in
     * case any Thread dies due to an unhandled exception.
     *
     * @param handler
     *            The handler to set or null.
     */
    public static void setDefaultUncaughtExceptionHandler(UncaughtExceptionHandler handler) {
        Thread.defaultUncaughtHandler = handler;
    }

从方法的字面意义来看，这个方法好像是可以设置系统的默认异常处理器，其实，这个方法就可以解决应用常见的crash问题。当crash发生的时候，我们可以捕获到异常信息，把异常信息存储到SD卡中，然后在合适的时机通过网络将crash信息上传到服务器上，这样开发人员就可以分析用户crash的场景从而在后面的版本中修复此类crash。我们还可以在crash发生时，弹出一个通知告诉用户程序crash了，然后再退出，这样做比闪退要温和一点。

二、步骤

1、 建立异常处理Handler
新建一个类，比如叫CrashHandler.Java，代码如下，代码我就不做解释了，注释相当清晰了

/**
 * Created by Administrator on 2017/1/19.
 * 用于应用Crash之后的捕获保存到SD卡，或者上传到服务器
 * 在Application中初始化
 */

public class CrashHandler implements Thread.UncaughtExceptionHandler {

    private static final String TAG = "CrashHandler";
    private static final boolean DEBUG = true;

    //存放在SD卡中的位置
    private static final String PATH = Environment.getExternalStorageDirectory().getPath() + "/crash/";
    //存放在SD卡中文件名字
    private static final String FILE_NAME = "crash";
    //存放在SD卡中文件后缀
    private static final String FILE_NAME_SUFFIX = ".trace";

    private static CrashHandler mCrashHandler = new CrashHandler();

    //系统默认的异常处理（默认情况下，系统会终止当前的异常程序）
    private Thread.UncaughtExceptionHandler mDefaultCrashHandler;

    private Context mContext;

    /**
     * 构造方法私有，防止外部创建多个实例，采用单例模式
     */
    private CrashHandler() {
    }

    public static CrashHandler getInstance() {
        return mCrashHandler;
    }

    /**
     * 进行初始化工作
     *
     * @param _context
     */
    public void init(Context _context) {
        //获取系统默认的异常处理器
        mDefaultCrashHandler = Thread.getDefaultUncaughtExceptionHandler();
        //将当前实例设为系统默认的异常处理器
        Thread.setDefaultUncaughtExceptionHandler(this);
        //获取Context，方便内部使用
        mContext = _context.getApplicationContext();
    }

    /**
     * 这个是最关键的函数，当程序中有未被捕获的异常，系统将会自动调用#uncaughtException方法
     * thread为出现未捕获异常的线程，e为未捕获的异常，有了这个e，我们就可以得到异常信息。
     */
    @Override
    public void uncaughtException(Thread t, Throwable e) {
        //导出异常到SD卡中
        pushExceptionToSDCard(e);
        //向服务器发送异常
        uploadExceptionToServer(e);
        //打印出当前的调用栈
        e.printStackTrace();
        //如果系统提供了默认的异常处理器，则交给系统去结束我们的程序，否则就由我们自己结束自己
        if (null != mDefaultCrashHandler) {
            mDefaultCrashHandler.uncaughtException(t, e);
        } else {
            Process.killProcess(Process.myPid());
        }
    }

    private void pushExceptionToSDCard(Throwable _e) {
        //如果SD卡不存在或无法使用，则无法把异常信息写入SD卡
        if (!Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {
            if (DEBUG) {
                Log.w(TAG, "sdcard unmounted,skip push exception");
                return;
            }
        }
        File _dir = new File(PATH);
        if (!_dir.exists()) {
            _dir.mkdirs();
        }
        long _currentTime = System.currentTimeMillis();
        String _time = new SimpleDateFormat("yyyy-MM-dd HH:MM:SS").format(new Date(_currentTime));
        //以当前时间创建记录文件
        File _file = new File(PATH + FILE_NAME + _time + FILE_NAME_SUFFIX);
        try {
            PrintWriter _printWriter = new PrintWriter(new BufferedWriter(new FileWriter(_file)));
            //导出发生异常的时间
            _printWriter.println(_time);
            //导出手机信息
            pushPhoneInfo(_printWriter);
            //导出异常的调用栈信息
            _e.printStackTrace(_printWriter);
            //关闭
            _printWriter.close();
        } catch (Exception e) {
            Log.e(TAG, "push crash info fail");
        }
    }

    private void pushPhoneInfo(PrintWriter _printWriter) throws PackageManager.NameNotFoundException {
        //获取应用的版本名称和版本号
        PackageManager _packageManager = mContext.getPackageManager();
        PackageInfo _packageInfo = _packageManager.getPackageInfo(mContext.getPackageName(), PackageManager.GET_ACTIVITIES);
        _printWriter.print("App Version:");
        _printWriter.print(_packageInfo.versionName);
        _printWriter.print('_');
        _printWriter.println(_packageInfo.versionCode);

        //android版本号
        _printWriter.print("OS Version:");
        _printWriter.print(Build.VERSION.RELEASE);
        _printWriter.print('_');
        _printWriter.println(Build.VERSION.SDK_INT);

        //手机制造商
        _printWriter.print("Vendor:");
        _printWriter.println(Build.MANUFACTURER);

        //手机型号
        _printWriter.print("Model:");
        _printWriter.println(Build.MODEL);

        //手机cup架构
        _printWriter.print("CPU API:");
        _printWriter.println(Build.CPU_ABI);
    }

    private void uploadExceptionToServer(Throwable _e) {
        //上传至服务器，便于开发者研究
    }

}

2、为ui线程添加默认异常事件Handler
//Thread类中标识默认异常事件Handler的成员
private static UncaughtExceptionHandler defaultUncaughtHandler;
这里涉及到在哪里添加的问题，从源码中注意到，这个defaultUncaughtHandler是Thread类中一个静态的成员，所以，按道理，我们为任意一个线程设置异常处理，所有的线程都应该能共用这个异常处理器，这个是我的猜测，没有经过验证，不过没关系，有一个观点是大家都认可的：就是为主线程也就是ui线程添加异常程序器。为了在ui线程中添加异常处理Handler，我们推荐大家在Application中添加而不是在Activity中添加。Application标识着整个应用，在Android声明周期中是第一个启动的，早于任何的Activity、Service等。

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        CrashHandler.getInstance().init(this);
    }

}

3、效果
经过了上面两个步骤，我们的程序已经可以处理任何异常了，再也不怕程序crash了，并且我们还能从服务器上查看用户的crash信息，下面我们就模拟下发生crash的情形，看我们的程序是如何处理的。

throw new RuntimeException("测试的Crash记录");

4、文件
手机目录：

文件内容：