Android将程序崩溃信息保存本地文件

源码下载地址：http://download.csdn.net/detail/weidi1989/4588310

我们先建立一个crash项目，项目结构如图：

　　　　

了解以下两个类：android.app.Application 和 java.lang.Thread.UncaughtExceptionHandler。

Application：用来管理应用程序的全局状态。在应用程序启动时Application会首先创建，然后才会根据情况(Intent)来启动相应的Activity和Service。本示例中将在自定义加强版的Application中注册未捕获异常处理器。

Thread.UncaughtExceptionHandler：线程未捕获异常处理器，用来处理未捕获异常。如果程序出现了未捕获异常，默认会弹出系统中强制关闭对话框。我们需要实现此接口，并注册为程序中默认未捕获异常处理。这样当未捕获异常发生时，就可以做一些个性化的异常处理操作。

大家刚才在项目的结构图中看到的CrashHandler.java实现了Thread.UncaughtExceptionHandler，使我们用来处理未捕获异常的主要成员，代码如下：

package com.way.crash;  
  
import java.io.File;  
import java.io.FileNotFoundException;  
import java.io.FileOutputStream;  
import java.io.IOException;  
import java.io.PrintWriter;  
import java.io.StringWriter;  
import java.io.Writer;  
import java.lang.Thread.UncaughtExceptionHandler;  
import java.lang.reflect.Field;  
import java.text.SimpleDateFormat;  
import java.util.Date;  
import java.util.HashMap;  
import java.util.Map;  
  
import android.content.Context;  
import android.content.pm.PackageInfo;  
import android.content.pm.PackageManager;  
import android.content.pm.PackageManager.NameNotFoundException;  
import android.os.Build;  
import android.os.Environment;  
import android.os.Looper;  
import android.util.Log;  
import android.widget.Toast;  
  
/** 
 * UncaughtException处理类,当程序发生Uncaught异常的时候,由该类来接管程序,并记录发送错误报告. 
 *  
 * @author way 
 *  
 */  
public class CrashHandler implements UncaughtExceptionHandler {  
    private static final String TAG = "CrashHandler";  
    private Thread.UncaughtExceptionHandler mDefaultHandler;// 系统默认的UncaughtException处理类  
    private static CrashHandler INSTANCE = new CrashHandler();// CrashHandler实例  
    private Context mContext;// 程序的Context对象  
    private Map<String, String> info = new HashMap<String, String>();// 用来存储设备信息和异常信息  
    private SimpleDateFormat format = new SimpleDateFormat(  
            "yyyy-MM-dd-HH-mm-ss");// 用于格式化日期,作为日志文件名的一部分  
  
    /** 保证只有一个CrashHandler实例 */  
    private CrashHandler() {  
  
    }  
  
    /** 获取CrashHandler实例 ,单例模式 */  
    public static CrashHandler getInstance() {  
        return INSTANCE;  
    }  
  
    /** 
     * 初始化 
     *  
     * @param context 
     */  
    public void init(Context context) {  
        mContext = context;  
        mDefaultHandler = Thread.getDefaultUncaughtExceptionHandler();// 获取系统默认的UncaughtException处理器  
        Thread.setDefaultUncaughtExceptionHandler(this);// 设置该CrashHandler为程序的默认处理器  
    }  
  
    /** 
     * 当UncaughtException发生时会转入该重写的方法来处理 
     */  
    public void uncaughtException(Thread thread, Throwable ex) {  
        if (!handleException(ex) && mDefaultHandler != null) {  
            // 如果自定义的没有处理则让系统默认的异常处理器来处理  
            mDefaultHandler.uncaughtException(thread, ex);  
        } else {  
            try {  
                Thread.sleep(3000);// 如果处理了，让程序继续运行3秒再退出，保证文件保存并上传到服务器  
            } catch (InterruptedException e) {  
                e.printStackTrace();  
            }  
            // 退出程序  
            android.os.Process.killProcess(android.os.Process.myPid());  
            System.exit(1);  
        }  
    }  
  
    /** 
     * 自定义错误处理,收集错误信息 发送错误报告等操作均在此完成. 
     *  
     * @param ex 
     *            异常信息 
     * @return true 如果处理了该异常信息;否则返回false. 
     */  
    public boolean handleException(Throwable ex) {  
        if (ex == null)  
            return false;  
        new Thread() {  
            public void run() {  
                Looper.prepare();  
                Toast.makeText(mContext, "很抱歉,程序出现异常,即将退出", 0).show();  
                Looper.loop();  
            }  
        }.start();  
        // 收集设备参数信息  
        collectDeviceInfo(mContext);  
        // 保存日志文件  
        saveCrashInfo2File(ex);  
        return true;  
    }  
  
    /** 
     * 收集设备参数信息 
     *  
     * @param context 
     */  
    public void collectDeviceInfo(Context context) {  
        try {  
            PackageManager pm = context.getPackageManager();// 获得包管理器  
            PackageInfo pi = pm.getPackageInfo(context.getPackageName(),  
                    PackageManager.GET_ACTIVITIES);// 得到该应用的信息，即主Activity  
            if (pi != null) {  
                String versionName = pi.versionName == null ? "null"  
                        : pi.versionName;  
                String versionCode = pi.versionCode + "";  
                info.put("versionName", versionName);  
                info.put("versionCode", versionCode);  
            }  
        } catch (NameNotFoundException e) {  
            e.printStackTrace();  
        }  
  
        Field[] fields = Build.class.getDeclaredFields();// 反射机制  
        for (Field field : fields) {  
            try {  
                field.setAccessible(true);  
                info.put(field.getName(), field.get("").toString());  
                Log.d(TAG, field.getName() + ":" + field.get(""));  
            } catch (IllegalArgumentException e) {  
                e.printStackTrace();  
            } catch (IllegalAccessException e) {  
                e.printStackTrace();  
            }  
        }  
    }  
  
    private String saveCrashInfo2File(Throwable ex) {  
        StringBuffer sb = new StringBuffer();  
        for (Map.Entry<String, String> entry : info.entrySet()) {  
            String key = entry.getKey();  
            String value = entry.getValue();  
            sb.append(key + "=" + value + "\r\n");  
        }  
        Writer writer = new StringWriter();  
        PrintWriter pw = new PrintWriter(writer);  
        ex.printStackTrace(pw);  
        Throwable cause = ex.getCause();  
        // 循环着把所有的异常信息写入writer中  
        while (cause != null) {  
            cause.printStackTrace(pw);  
            cause = cause.getCause();  
        }  
        pw.close();// 记得关闭  
        String result = writer.toString();  
        sb.append(result);  
        // 保存文件  
        long timetamp = System.currentTimeMillis();  
        String time = format.format(new Date());  
        String fileName = "crash-" + time + "-" + timetamp + ".log";  
        if (Environment.getExternalStorageState().equals(  
                Environment.MEDIA_MOUNTED)) {  
            try {  
                File dir = new File(Environment.getExternalStorageDirectory().getAbsolutePath() +                           File.separator + "crash");  
                Log.i("CrashHandler", dir.toString());  
                if (!dir.exists())  
                    dir.mkdir();  
                FileOutputStream fos = new FileOutputStream(new File(dir,  
                         fileName));  
                fos.write(sb.toString().getBytes());  
                fos.close();  
                return fileName;  
            } catch (FileNotFoundException e) {  
                e.printStackTrace();  
            } catch (IOException e) {  
                e.printStackTrace();  
            }  
        }  
        return null;  
    }  
}  

然后，我们需要在应用启动的时候在Application中注册一下：

package com.way.crash;  
  
import android.app.Application;  
  
public class CrashApplication extends Application {  
    @Override  
    public void onCreate() {  
        super.onCreate();  
        CrashHandler crashHandler = CrashHandler.getInstance();  
        crashHandler.init(this);  
    }  
}  

最后，为了让我们的CrashApplication取代android.app.Application的地位，在我们的代码中生效，我们需要修改AndroidManifest.xml：

<application android:name=".CrashApplication"  
       android:icon="@drawable/ic_launcher"  
       android:label="@string/app_name"  
       android:theme="@style/AppTheme" >  
  ...  
</application> 

因为我们上面的CrashHandler中，遇到异常后要保存设备参数和具体异常信息到SDCARD，所以我们需要在AndroidManifest.xml中加入读写SDCARD权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>  

搞定了上边的步骤之后，我们来运行一下这个项目：

看以看到，并不会有强制关闭的对话框出现了，取而代之的是我们比较有好的提示信息。

然后看一下SDCARD生成的文件：

用文本编辑器打开日志文件，看一段日志信息：

CPU_ABI=armeabi  
CPU_ABI2=unknown  
ID=FRF91  
MANUFACTURER=unknown  
BRAND=generic  
TYPE=eng  
......  
Caused by: java.lang.NullPointerException  
    at com.scott.crash.MainActivity.onCreate(MainActivity.java:13)  
    at android.app.Instrumentation.callActivityOnCreate(Instrumentation.java:1047)  
    at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2627)  
    ... 11 more  

这些信息对于开发者来说帮助极大，所以我们需要将此日志文件上传到服务器。