Android程序Crash时的异常上报

转载请注明来源：http://blog.csdn.net/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，代码以下，代码我就不作解释了，注释至关清晰了

public class CrashHandler implements UncaughtExceptionHandler {
    private static final String TAG = "CrashHandler";
    private static final boolean DEBUG = true;

    private static final String PATH = Environment.getExternalStorageDirectory().getPath() + "/ryg_test/log/";
    private static final String FILE_NAME = "crash";

    //log文件的后缀名
    private static final String FILE_NAME_SUFFIX = ".trace";

    private static CrashHandler sInstance = new CrashHandler();

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

    private Context mContext;

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

    public static CrashHandler getInstance() {
        return sInstance;
    }

    //这里主要完成初始化工做
    public void init(Context context) {
        //获取系统默认的异常处理器
        mDefaultCrashHandler = Thread.getDefaultUncaughtExceptionHandler();
        //将当前实例设为系统默认的异常处理器
        Thread.setDefaultUncaughtExceptionHandler(this);
        //获取Context，方便内部使用
        mContext = context.getApplicationContext();
    }

    /**
     * 这个是最关键的函数，当程序中有未被捕获的异常，系统将会自动调用#uncaughtException方法
     * thread为出现未捕获异常的线程，ex为未捕获的异常，有了这个ex，咱们就能够获得异常信息。
     */
    @Override
    public void uncaughtException(Thread thread, Throwable ex) {
        try {
            //导出异常信息到SD卡中
            dumpExceptionToSDCard(ex);
            //这里能够经过网络上传异常信息到服务器，便于开发人员分析日志从而解决bug
            uploadExceptionToServer();
        } catch (IOException e) {
            e.printStackTrace();
        }

        //打印出当前调用栈信息
        ex.printStackTrace();

        //若是系统提供了默认的异常处理器，则交给系统去结束咱们的程序，不然就由咱们本身结束本身
        if (mDefaultCrashHandler != null) {
            mDefaultCrashHandler.uncaughtException(thread, ex);
        } else {
            Process.killProcess(Process.myPid());
        }

    }

    private void dumpExceptionToSDCard(Throwable ex) throws IOException {
        //若是SD卡不存在或没法使用，则没法把异常信息写入SD卡
        if (!Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {
            if (DEBUG) {
                Log.w(TAG, "sdcard unmounted,skip dump exception");
                return;
            }
        }

        File dir = new File(PATH);
        if (!dir.exists()) {
            dir.mkdirs();
        }
        long current = System.currentTimeMillis();
        String time = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date(current));
        //以当前时间建立log文件
        File file = new File(PATH + FILE_NAME + time + FILE_NAME_SUFFIX);

        try {
            PrintWriter pw = new PrintWriter(new BufferedWriter(new FileWriter(file)));
            //导出发生异常的时间
            pw.println(time);

            //导出手机信息
            dumpPhoneInfo(pw);

            pw.println();
            //导出异常的调用栈信息
            ex.printStackTrace(pw);

            pw.close();
        } catch (Exception e) {
            Log.e(TAG, "dump crash info failed");
        }
    }

    private void dumpPhoneInfo(PrintWriter pw) throws NameNotFoundException {
        //应用的版本名称和版本号
        PackageManager pm = mContext.getPackageManager();
        PackageInfo pi = pm.getPackageInfo(mContext.getPackageName(), PackageManager.GET_ACTIVITIES);
        pw.print("App Version: ");
        pw.print(pi.versionName);
        pw.print('_');
        pw.println(pi.versionCode);

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

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

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

        //cpu架构
        pw.print("CPU ABI: ");
        pw.println(Build.CPU_ABI);
    }

    private void uploadExceptionToServer() {
        //TODO Upload Exception Message To Your Web Server
    }

}

2.为ui线程添加默认异常事件Handler

//Thread类中标识默认异常事件Handler的成员

private static UncaughtExceptionHandler defaultUncaughtHandler;

这里涉及到在哪里添加的问题，从源码中注意到，这个defaultUncaughtHandler是Thread类中一个静态的成员，因此，按道理，咱们为任意一个线程设置异常处理，全部的线程都应该能共用这个异常处理器，这个是个人猜想，没有通过验证，不过不要紧，有一个观点是你们都承认的：就是为主线程也就是ui线程添加异常程序器。为了在ui线程中添加异常处理Handler，咱们推荐你们在Application中添加而不是在Activity中添加。Application标识着整个应用，在Android声明周期中是第一个启动的，早于任何的Activity、Service等。

public class TestApp extends Application {

    private static TestApp sInstance;

    @Override
    public void onCreate() {
        super.onCreate();
        sInstance = this;

        //在这里为应用设置异常处理程序，而后咱们的程序才能捕获未处理的异常
        CrashHandler crashHandler = CrashHandler.getInstance();
        crashHandler.init(this);
    }

    public static TestApp getInstance() {
        return sInstance;
    }

}

效果

通过了上面两个步骤，咱们的程序已经能够处理任何异常了，不再怕程序crash了，而且咱们还能从服务器上查看用户的crash信息，下面咱们就模拟下发生crash的情形，看咱们的程序是如何处理的。

public class CrashActivity extends Activity implements OnClickListener{

    private Button mButton;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_crash);
        initView();
    }

    private void initView() {
        mButton = (Button)findViewById(R.id.button1);
        mButton.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        if (v == mButton) {
            //在这里默认异常抛出状况，人为抛出一个运行时异常
            throw new RuntimeException("自定义异常：这是本身抛出的异常");
        }
        
    }
}

咱们给按钮加一个点击事件，在onClick中人为抛出一个运行时异常，这个时候程序就crash了，看看异常处理器为咱们作了什么。从下面的图片能够看出，异常处理器为咱们建立了一个日志文件，打开日志文件，能够看到手机的信息以及异常发生时的调用栈，有了这些，开发人员就很好定位问题了吧。从下面的日志调用栈能够看出，CrashActivity的28行发生了RuntimeException，再看下咱们的代码，发现28行就是咱们认为抛出的异常。从如今开始，为你的应用加上默认异常事件处理器吧。

demo下载：http://download.csdn.net/download/singwhatiwanna/6706023