UncaughtExceptionHandler接口实现

首先创建一个OPhone项目(项目的创建请参考OPhoneSDN上的其他文章)，本文示例项目名称为：CrashReporter ；包名为：org.goodev.cr；并创建一个默认的Activity名字为：ReporterTest。然后创建CrashHandler类实现UncaughtExceptionHandler接口，并实现其函数：public void uncaughtException(Thread thread, Throwable ex)。CrashHandler类实现了错误报告的主要处理逻辑，该类代码如下(在代码中会有详细注释来解释各种处理情况)：

packageorg.goodev.cr;

Import 省略...；

/**

* UncaughtException处理类,当程序发生Uncaught异常的时候,有该类

* 来接管程序,并记录 发送错误报告.

*

*/

publicclassCrashHandlerimplementsUncaughtExceptionHandler {

/** Debug Log tag*/

publicstaticfinalString TAG ="CrashHandler";

/** 是否开启日志输出,在Debug状态下开启,

* 在Release状态下关闭以提示程序性能

* */

publicstaticfinalbooleanDEBUG =true;

/** 系统默认的UncaughtException处理类 */

privateThread.UncaughtExceptionHandler mDefaultHandler;

/** CrashHandler实例 */

privatestaticCrashHandler INSTANCE;

/** 程序的Context对象 */

privateContext mContext;

/** 使用Properties来保存设备的信息和错误堆栈信息*/

privateProperties mDeviceCrashInfo =newProperties();

privatestaticfinalString VERSION_NAME ="versionName";

privatestaticfinalString VERSION_CODE ="versionCode";

privatestaticfinalString STACK_TRACE ="STACK_TRACE";

/** 错误报告文件的扩展名 */

privatestaticfinalString CRASH_REPORTER_EXTENSION =".cr";

/** 保证只有一个CrashHandler实例 */

privateCrashHandler() {}

/** 获取CrashHandler实例 ,单例模式*/

publicstaticCrashHandler getInstance() {

if(INSTANCE ==null) {

INSTANCE =newCrashHandler();

}

returnINSTANCE;

}

/**

* 初始化,注册Context对象,

* 获取系统默认的UncaughtException处理器,

* 设置该CrashHandler为程序的默认处理器

*

* @param ctx

*/

publicvoidinit(Context ctx) {

mContext = ctx;

mDefaultHandler = Thread.getDefaultUncaughtExceptionHandler();

Thread.setDefaultUncaughtExceptionHandler(this);

}

/**

* 当UncaughtException发生时会转入该函数来处理

*/

@Override

publicvoiduncaughtException(Thread thread, Throwable ex) {

if(!handleException(ex) && mDefaultHandler !=null) {

//如果用户没有处理则让系统默认的异常处理器来处理

mDefaultHandler.uncaughtException(thread, ex);

}else{

//Sleep一会后结束程序

try{

Thread.sleep(3000);

}catch(InterruptedException e) {

Log.e(TAG,"Error : ", e);

}

Android.os.Process.killProcess(android.os.Process.myPid());

System.exit(10);

}

}

/**

* 自定义错误处理,收集错误信息

* 发送错误报告等操作均在此完成.

* 开发者可以根据自己的情况来自定义异常处理逻辑

* @param ex

* @return true:如果处理了该异常信息;否则返回false

*/

privatebooleanhandleException(Throwable ex) {

if(ex ==null) {

returntrue;

}

finalString msg = ex.getLocalizedMessage();

//使用Toast来显示异常信息

newThread() {

@Override

publicvoidrun() {

Looper.prepare();

Toast.makeText(mContext,"程序出错啦:"+ msg, Toast.LENGTH_LONG)

.show();

Looper.loop();

}

}.start();

//收集设备信息

collectCrashDeviceInfo(mContext);

//保存错误报告文件

String crashFileName = saveCrashInfoToFile(ex);

//发送错误报告到服务器

sendCrashReportsToServer(mContext);

returntrue;

}

/**

* 在程序启动时候, 可以调用该函数来发送以前没有发送的报告

*/

publicvoidsendPreviousReportsToServer() {

sendCrashReportsToServer(mContext);

}

/**

* 把错误报告发送给服务器,包含新产生的和以前没发送的.

*

* @param ctx

*/

privatevoidsendCrashReportsToServer(Context ctx) {

String[] crFiles = getCrashReportFiles(ctx);

if(crFiles !=null&& crFiles.length >0) {

TreeSet sortedFiles =newTreeSet();

sortedFiles.addAll(Arrays.asList(crFiles));

for(String fileName : sortedFiles) {

File cr =newFile(ctx.getFilesDir(), fileName);

postReport(cr);

cr.delete();// 删除已发送的报告

}

}

}

privatevoidpostReport(File file) {

// TODO 使用HTTP Post 发送错误报告到服务器

// 这里不再详述,开发者可以根据OPhoneSDN上的其他网络操作

// 教程来提交错误报告

}

/**

* 获取错误报告文件名

* @param ctx

* @return

*/

privateString[] getCrashReportFiles(Context ctx) {

File filesDir = ctx.getFilesDir();

FilenameFilter filter =newFilenameFilter() {

publicbooleanaccept(File dir, String name) {

returnname.endsWith(CRASH_REPORTER_EXTENSION);

}

};

returnfilesDir.list(filter);

}

/**

* 保存错误信息到文件中

* @param ex

* @return

*/

privateString saveCrashInfoToFile(Throwable ex) {

Writer info =newStringWriter();

PrintWriter printWriter =newPrintWriter(info);

ex.printStackTrace(printWriter);

Throwable cause = ex.getCause();

while(cause !=null) {

cause.printStackTrace(printWriter);

cause = cause.getCause();

}

String result = info.toString();

printWriter.close();

mDeviceCrashInfo.put(STACK_TRACE, result);

try{

longtimestamp = System.currentTimeMillis();

String fileName ="crash-"+ timestamp + CRASH_REPORTER_EXTENSION;

FileOutputStream trace = mContext.openFileOutput(fileName,

Context.MODE_PRIVATE);

mDeviceCrashInfo.store(trace,"");

trace.flush();

trace.close();

returnfileName;

}catch(Exception e) {

Log.e(TAG,"an error occured while writing report file...", e);

}

returnnull;

}

/**

* 收集程序崩溃的设备信息

*

* @param ctx

*/

publicvoidcollectCrashDeviceInfo(Context ctx) {

try{

PackageManager pm = ctx.getPackageManager();

PackageInfo pi = pm.getPackageInfo(ctx.getPackageName(),

PackageManager.GET_ACTIVITIES);

if(pi !=null) {

mDeviceCrashInfo.put(VERSION_NAME,

pi.versionName ==null?"not set": pi.versionName);

mDeviceCrashInfo.put(VERSION_CODE, pi.versionCode);

}

}catch(NameNotFoundException e) {

Log.e(TAG,"Error while collect package info", e);

}

//使用反射来收集设备信息.在Build类中包含各种设备信息,

//例如: 系统版本号,设备生产商 等帮助调试程序的有用信息

//具体信息请参考后面的截图

Field[] fields = Build.class.getDeclaredFields();

for(Field field : fields) {

try{

field.setAccessible(true);

mDeviceCrashInfo.put(field.getName(), field.get(null));

if(DEBUG) {

Log.d(TAG, field.getName() +" : "+ field.get(null));

}

}catch(Exception e) {

Log.e(TAG,"Error while collect crash info", e);

}

}

}

}

在上面CrashHandler实现中，当错误发生的时候使用Toast显示错误信息，然后收集错误报告并保存在文件中。 发送错误报告代码请读者自己实现。在uncaughtException函数中调用了Thread.sleep(3000)；来让线程停止一会是为了显示Toast信息给用户，然后Kill程序。如果你不用Toast来显示信息则可以去除该代码。除了Toast外，开发者还可以选择使用Notification来显示错误内容并让用户选择是否提交错误报告而不是自动提交。关于Notification的实现请读者参考：NotificationManager。在发送错误报道的时候，可以先检测网络是否可用，如果不可用则可以在以后网络情况可用的情况下发送。 网络监测代码如下：

/**

* 检测网络连接��否可用

* @param ctx

* @return true 可用; false 不可用

*/

privatebooleanisNetworkAvailable(Context ctx) {

ConnectivityManager cm =

(ConnectivityManager) ctx.getSystemService(Context.CONNECTIVITY_SERVICE);

if(cm ==null) {

returnfalse;

}

NetworkInfo[] netinfo = cm.getAllNetworkInfo();

if(netinfo ==null) {

returnfalse;

}

for(inti =0; i

if(netinfo[i].isConnected()) {

returntrue;

}

}

returnfalse;

}

下面是在模拟器和笔者手机(Dell mini3i OPhone1.5系统)上收集的具体信息截图:

图二: 模拟器信息截图

图三:Dell mini3i 设备信息截图

Application 实现

实现一个自定义Application来注册CrashHandler. 代码如下:

publicclassCrashApplicationextendsApplication {

@Override

publicvoidonCreate() {

super.onCreate();

CrashHandler crashHandler = CrashHandler.getInstance();

//注册crashHandler

crashHandler.init(getApplicationContext());

//发送以前没发送的报告(可选)

crashHandler.sendPreviousReportsToServer();

}

}

在AndroidManifest.xml中注册

最后只要在AndroidManifest.xml中注册CrashApplication就可以了。代码如下：

package="org.goodev.cr"

android:versionCode="1"

android:versionName="1.0">

android:name=".CrashApplication">

android:label="@string/app_name">

总结：通过本文示例的方式，开发者可以在程序中收集详细的崩溃信息，从而为调试程序带来便利，如果您的程序还没有该功能赶快加入吧。crashReporter.zip中包含本文使用的项目文件及资源。