android 程序错误全局处理
一、Application Crash Report for Android
转:http://www.chengyunfeng.com/2010/07/application-crash-report-for-android
你的Android程序是否会崩溃呢!是否有用户抱怨程序崩溃,但是您又收集不到崩溃时候的详细信息呢?是否希望给您的用户提供更好的用户体验呢?ACRA(Android程序崩溃报告)就是一个帮助您在程序崩溃时候收集信息的项目.
使用ACRA当您的程序崩溃的时候,可以发送一个崩溃报告到Google Doc中,然后您就可以查看程序崩溃时候系统的信息.
项目主页:http://code.google.com/p/acra/
使用文档:http://code.google.com/p/acra/wiki/ACRAHowTo
二、android 程序错误全局处理
转:http://blog.csdn.net/liangguohuan/archive/2010/11/19/6022419.aspx
本文将分析在程序出错的情况下如何收集相关的错误信息,并发送错误信息到服务器供开发者分析和调试程序。错误信息将成为您Debug的一把利刃,通过错误信息您可以最及时的掌握程序在各个系统版本和设备上的运行情况。错误处理介绍在一般情况下,OPhone程序出错都会出现如下一个提示对话框:
图一:OPhone默认出错提示
这种情况下,用户只有点击“强行关闭”来结束程序。当该对话框出现对用户来说是相当不友好的,本文中将会告诉您如何在程序出错时不显示该对话框。
随着OPhone设备和系统版本的增加,现在在不同设备和版本上调试程序越来越麻烦,开发者不可能购买所有的设备来逐个调试程序。如果程序在模拟器上运行正常但是到最终用户手中运行却出现了错误,这种情况下如果可以收集到程序错误堆栈信息和具体设备的信息,对开发者调试程序就有莫大的帮助了。
要收集错误信息,我们需要了解两个主要接口API的使用:android.app.Application 和java.lang.Thread.UncaughtExceptionHandler 。下面就对着两个API做简单介绍。
UncaughtExceptionHandler:线程未捕获异常控制器是用来处理未捕获异常的。如果程序出现了未捕获异常默认情况下则会出现上面所示的强行关闭对话框。在本文将实现该接口并注册为程序中的默认未捕获异常处理。这样当未捕获异常发生时,就可以做些异常处理操作,例如:收集异常信息,发送错误报告 等。
Application:在开发OPhone应用时都会和Activity打交道,而Application使用的就相对较少了。Application 在OPhone中是用来管理应用程序的全局状态的,比如载入资源文件。在应用程序启动的时候Application会首先创建,然后才会根据情况(Intent)来启动相应的Activity或者Service。在本文将在Application中注册未捕获异常处理器。
UncaughtExceptionHandler接口实现
首先创建一个OPhone项目(项目的创建请参考OPhoneSDN上的其他文章),本文示例项目名称为:CrashReporter ;包名为:org.goodev.cr;并创建一个默认的Activity名字为:ReporterTest。然后创建CrashHandler类实现UncaughtExceptionHandler接口,并实现其函数:public void uncaughtException(Thread thread, Throwable ex)。CrashHandler类实现了错误报告的主要处理逻辑,该类代码如下(在代码中会有详细注释来解释各种处理情况):
[c-sharp] view plain copy print ?- packageorg.goodev.cr;
- Import省略...;
- /**
- *UncaughtException处理类,当程序发生Uncaught异常的时候,有该类
- *来接管程序,并记录发送错误报告.
- *
- */
- publicclassCrashHandlerimplementsUncaughtExceptionHandler{
- /**DebugLogtag*/
- publicstaticfinalStringTAG="CrashHandler";
- /**是否开启日志输出,在Debug状态下开启,
- *在Release状态下关闭以提示程序性能
- **/
- publicstaticfinalbooleanDEBUG=true;
- /**系统默认的UncaughtException处理类*/
- privateThread.UncaughtExceptionHandlermDefaultHandler;
- /**CrashHandler实例*/
- privatestaticCrashHandlerINSTANCE;
- /**程序的Context对象*/
- privateContextmContext;
- /**使用Properties来保存设备的信息和错误堆栈信息*/
- privatePropertiesmDeviceCrashInfo=newProperties();
- privatestaticfinalStringVERSION_NAME="versionName";
- privatestaticfinalStringVERSION_CODE="versionCode";
- privatestaticfinalStringSTACK_TRACE="STACK_TRACE";
- /**错误报告文件的扩展名*/
- privatestaticfinalStringCRASH_REPORTER_EXTENSION=".cr";
- /**保证只有一个CrashHandler实例*/
- privateCrashHandler(){}
- /**获取CrashHandler实例,单例模式*/
- publicstaticCrashHandlergetInstance(){
- if(INSTANCE==null){
- INSTANCE=newCrashHandler();
- }
- returnINSTANCE;
- }
- /**
- *初始化,注册Context对象,
- *获取系统默认的UncaughtException处理器,
- *设置该CrashHandler为程序的默认处理器
- *
- *@paramctx
- */
- publicvoidinit(Contextctx){
- mContext=ctx;
- mDefaultHandler=Thread.getDefaultUncaughtExceptionHandler();
- Thread.setDefaultUncaughtExceptionHandler(this);
- }
- /**
- *当UncaughtException发生时会转入该函数来处理
- */
- @Override
- publicvoiduncaughtException(Threadthread,Throwableex){
- if(!handleException(ex)&&mDefaultHandler!=null){
- //如果用户没有处理则让系统默认的异常处理器来处理
- mDefaultHandler.uncaughtException(thread,ex);
- }else{
- //Sleep一会后结束程序
- try{
- Thread.sleep(3000);
- }catch(InterruptedExceptione){
- Log.e(TAG,"Error:",e);
- }
- android.os.Process.killProcess(android.os.Process.myPid());
- System.exit(10);
- }
- }
- /**
- *自定义错误处理,收集错误信息
- *发送错误报告等操作均在此完成.
- *开发者可以根据自己的情况来自定义异常处理逻辑
- *@paramex
- *@returntrue:如果处理了该异常信息;否则返回false
- */
- privatebooleanhandleException(Throwableex){
- if(ex==null){
- returntrue;
- }
- finalStringmsg=ex.getLocalizedMessage();
- //使用Toast来显示异常信息
- newThread(){
- @Override
- publicvoidrun(){
- Looper.prepare();
- Toast.makeText(mContext,"程序出错啦:"+msg,Toast.LENGTH_LONG)
- .show();
- Looper.loop();
- }
- }.start();
- //收集设备信息
- collectCrashDeviceInfo(mContext);
- //保存错误报告文件
- StringcrashFileName=saveCrashInfoToFile(ex);
- //发送错误报告到服务器
- sendCrashReportsToServer(mContext);
- returntrue;
- }
- /**
- *在程序启动时候,可以调用该函数来发送以前没有发送的报告
- */
- publicvoidsendPreviousReportsToServer(){
- sendCrashReportsToServer(mContext);
- }
- /**
- *把错误报告发送给服务器,包含新产生的和以前没发送的.
- *
- *@paramctx
- */
- privatevoidsendCrashReportsToServer(Contextctx){
- String[]crFiles=getCrashReportFiles(ctx);
- if(crFiles!=null&&crFiles.length>0){
- TreeSet<String>sortedFiles=newTreeSet<String>();
- sortedFiles.addAll(Arrays.asList(crFiles));
- for(StringfileName:sortedFiles){
- Filecr=newFile(ctx.getFilesDir(),fileName);
- postReport(cr);
- cr.delete();//删除已发送的报告
- }
- }
- }
- privatevoidpostReport(Filefile){
- //TODO使用HTTPPost发送错误报告到服务器
- //这里不再详述,开发者可以根据OPhoneSDN上的其他网络操作
- //教程来提交错误报告
- }
- /**
- *获取错误报告文件名
- *@paramctx
- *@return
- */
- privateString[]getCrashReportFiles(Contextctx){
- FilefilesDir=ctx.getFilesDir();
- FilenameFilterfilter=newFilenameFilter(){
- publicbooleanaccept(Filedir,Stringname){
- returnname.endsWith(CRASH_REPORTER_EXTENSION);
- }
- };
- returnfilesDir.list(filter);
- }
- /**
- *保存错误信息到文件中
- *@paramex
- *@return
- */
- privateStringsaveCrashInfoToFile(Throwableex){
- Writerinfo=newStringWriter();
- PrintWriterprintWriter=newPrintWriter(info);
- ex.printStackTrace(printWriter);
- Throwablecause=ex.getCause();
- while(cause!=null){
- cause.printStackTrace(printWriter);
- cause=cause.getCause();
- }
- Stringresult=info.toString();
- printWriter.close();
- mDeviceCrashInfo.put(STACK_TRACE,result);
- try{
- longtimestamp=System.currentTimeMillis();
- StringfileName="crash-"+timestamp+CRASH_REPORTER_EXTENSION;
- FileOutputStreamtrace=mContext.openFileOutput(fileName,
- Context.MODE_PRIVATE);
- mDeviceCrashInfo.store(trace,"");
- trace.flush();
- trace.close();
- returnfileName;
- }catch(Exceptione){
- Log.e(TAG,"anerroroccuredwhilewritingreportfile...",e);
- }
- returnnull;
- }
- /**
- *收集程序崩溃的设备信息
- *
- *@paramctx
- */
- publicvoidcollectCrashDeviceInfo(Contextctx){
- try{
- PackageManagerpm=ctx.getPackageManager();
- PackageInfopi=pm.getPackageInfo(ctx.getPackageName(),
- PackageManager.GET_ACTIVITIES);
- if(pi!=null){
- mDeviceCrashInfo.put(VERSION_NAME,
- pi.versionName==null?"notset":pi.versionName);
- mDeviceCrashInfo.put(VERSION_CODE,pi.versionCode);
- }
- }catch(NameNotFoundExceptione){
- Log.e(TAG,"Errorwhilecollectpackageinfo",e);
- }
- //使用反射来收集设备信息.在Build类中包含各种设备信息,
- //例如:系统版本号,设备生产商等帮助调试程序的有用信息
- //具体信息请参考后面的截图
- Field[]fields=Build.class.getDeclaredFields();
- for(Fieldfield:fields){
- try{
- field.setAccessible(true);
- mDeviceCrashInfo.put(field.getName(),field.get(null));
- if(DEBUG){
- Log.d(TAG,field.getName()+":"+field.get(null));
- }
- }catch(Exceptione){
- Log.e(TAG,"Errorwhilecollectcrashinfo",e);
- }
- }
- }
- }
在上面CrashHandler实现中,当错误发生的时候使用Toast显示错误信息,然后收集错误报告并保存在文件中。 发送错误报告代码请读者自己实现。在uncaughtException函数中调用了Thread.sleep(3000);来让线程停止一会是为了显示Toast信息给用户,然后Kill程序。如果你不用Toast来显示信息则可以去除该代码。除了Toast外,开发者还可以选择使用Notification来显示错误内容并让用户选择是否提交错误报告而不是自动提交。关于Notification的实现请读者参考:NotificationManager。在发送错误报道的时候,可以先检测网络是否可用,如果不可用则可以在以后网络情况可用的情况下发送。 网络监测代码如下:
[c-sharp] view plain copy print ?- /**
- *检测网络连接是否可用
- *@paramctx
- *@returntrue可用;false不可用
- */
- privatebooleanisNetworkAvailable(Contextctx){
- ConnectivityManagercm=
- (ConnectivityManager)ctx.getSystemService(Context.CONNECTIVITY_SERVICE);
- if(cm==null){
- returnfalse;
- }
- NetworkInfo[]netinfo=cm.getAllNetworkInfo();
- if(netinfo==null){
- returnfalse;
- }
- for(inti=0;i<netinfo.length;i++){
- if(netinfo[i].isConnected()){
- returntrue;
- }
- }
- returnfalse;
- }
下面是在模拟器和笔者手机(Dell mini3i OPhone1.5系统)上收集的具体信息截图:
图二: 模拟器信息截图
图三:Dell mini3i 设备信息截图
Application 实现
实现一个自定义Application来注册CrashHandler. 代码如下:
[c-sharp] view plain copy print ?- publicclassCrashApplicationextendsApplication{
- @Override
- publicvoidonCreate(){
- super.onCreate();
- CrashHandlercrashHandler=CrashHandler.getInstance();
- //注册crashHandler
- crashHandler.init(getApplicationContext());
- //发送以前没发送的报告(可选)
- crashHandler.sendPreviousReportsToServer();
- }
- }
在AndroidManifest.xml中注册
最后只要在AndroidManifest.xml中注册CrashApplication就可以了。代码如下:
[c-sharp] view plain copy print ?- <?xmlversion="1.0"encoding="utf-8"?>
- <manifestxmlns:android="http://schemas.android.com/apk/res/android"
- package="org.goodev.cr"
- android:versionCode="1"
- android:versionName="1.0">
- <applicationandroid:icon="@drawable/icon"android:label="@string/app_name"
- android:name=".CrashApplication">
- <activityandroid:name=".ReporterTest"
- android:label="@string/app_name">
- <intent-filter>
- <actionandroid:name="android.intent.action.MAIN"/>
- <categoryandroid:name="android.intent.category.LAUNCHER"/>
- </intent-filter>
- </activity>
- </application>
- </manifest>
总结:通过本文示例的方式,开发者可以在程序中收集详细的崩溃信息,从而为调试程序带来便利,如果您的程序还没有该功能赶快加入吧。crashReporter.zip中包含本文使用的项目文件及资源。
作者简介:程云峰,网名icess,目前就职于杭州恒生电子研发中心,喜欢Java开源技术。
个人网站:http://www.chengyunfeng.com/
(声明:本网的新闻及文章版权均属OPhone SDN网站所有,如需转载请与我们编辑团队联系。任何媒体、网站或个人未经本网书面协议授权,不得进行任何形式的转载。已经取得本网协议授权的媒体、网站,在转载使用时请注明稿件来源。)
更多相关文章
- 探讨android图片资源的抖动处理和格式转换
- 解析Android消息处理机制:Handler/Thread/Looper & MessageQueue
- Android(安卓)webkit 事件传递流程
- Android(安卓)本地代码中的LIKELY和UNLIKELY宏
- Android的事件处理机制(概念理解)
- 轻量级Android(安卓)HTTP框架
- android的PreferenceActivity
- Android(安卓)webkit 事件传递流程
- Android(安卓)webkit 事件传递流程