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類實現了錯誤報表的主要處理邏輯，該類代碼如下（在代碼中會有詳細注釋來解釋各種處理情況）：

 

 

package org.goodev.cr; </p><p>Import 省略...；<br />/**<br /> * UncaughtException處理類,當程式發生Uncaught異常的時候,有該類<br /> * 來接管程式,並記錄 發送錯誤報表.<br /> *<br /> */<br />public class CrashHandler implements UncaughtExceptionHandler {<br /> /** Debug Log tag*/<br /> public static final String TAG = "CrashHandler";<br /> /** 是否開啟日誌輸出,在Debug狀態下開啟,<br /> * 在Release狀態下關閉以提示程式效能<br /> * */<br /> public static final boolean DEBUG = true;<br /> /** 系統預設的UncaughtException處理類 */<br /> private Thread.UncaughtExceptionHandler mDefaultHandler;<br /> /** CrashHandler執行個體 */<br /> private static CrashHandler INSTANCE;<br /> /** 程式的Context對象 */<br /> private Context mContext; </p><p> /** 使用Properties來儲存裝置的資訊和錯誤堆棧資訊*/<br /> private Properties mDeviceCrashInfo = new Properties();<br /> private static final String VERSION_NAME = "versionName";<br /> private static final String VERSION_CODE = "versionCode";<br /> private static final String STACK_TRACE = "STACK_TRACE";<br /> /** 錯誤報表檔案的副檔名 */<br /> private static final String CRASH_REPORTER_EXTENSION = ".cr"; </p><p> /** 保證只有一個CrashHandler執行個體 */<br /> private CrashHandler() {}<br /> /** 擷取CrashHandler執行個體 ,單例模式*/<br /> public static CrashHandler getInstance() {<br /> if (INSTANCE == null) {<br /> INSTANCE = new CrashHandler();<br /> }<br /> return INSTANCE;<br /> } </p><p> /**<br /> * 初始化,註冊Context對象,<br /> * 擷取系統預設的UncaughtException處理器,<br /> * 設定該CrashHandler為程式的預設處理器<br /> *<br /> * @param ctx<br /> */<br /> public void init(Context ctx) {<br /> mContext = ctx;<br /> mDefaultHandler = Thread.getDefaultUncaughtExceptionHandler();<br /> Thread.setDefaultUncaughtExceptionHandler(this);<br /> } </p><p> /**<br /> * 當UncaughtException發生時會轉入該函數來處理<br /> */<br /> @Override<br /> public void uncaughtException(Thread thread, Throwable ex) {<br /> if (!handleException(ex) && mDefaultHandler != null) {<br /> //如果使用者沒有處理則讓系統預設的異常處理器來處理<br /> mDefaultHandler.uncaughtException(thread, ex);<br /> } else {<br /> //Sleep一會後結束程式<br /> try {<br /> Thread.sleep(3000);<br /> } catch (InterruptedException e) {<br /> Log.e(TAG, "Error : ", e);<br /> }<br /> android.os.Process.killProcess(android.os.Process.myPid());<br /> System.exit(10);<br /> }<br /> } </p><p> /**<br /> * 自訂錯誤處理,收集錯誤資訊<br /> * 發送錯誤報表等操作均在此完成.<br /> * 開發人員可以根據自己的情況來自訂異常處理邏輯<br /> * @param ex<br /> * @return true:如果處理了該異常資訊;否則返回false<br /> */<br /> private boolean handleException(Throwable ex) {<br /> if (ex == null) {<br /> return true;<br /> }<br /> final String msg = ex.getLocalizedMessage();<br /> //使用Toast來顯示異常資訊<br /> new Thread() {<br /> @Override<br /> public void run() {<br /> Looper.prepare();<br /> Toast.makeText(mContext, "程式出錯啦:" + msg, Toast.LENGTH_LONG)<br /> .show();<br /> Looper.loop();<br /> } </p><p> }.start();<br /> //收集裝置資訊<br /> collectCrashDeviceInfo(mContext);<br /> //儲存錯誤報表檔案<br /> String crashFileName = saveCrashInfoToFile(ex);<br /> //發送錯誤報表到伺服器<br /> sendCrashReportsToServer(mContext);<br /> return true;<br /> } </p><p> /**<br /> * 在程式啟動時候, 可以調用該函數來發送以前沒有發送的報告<br /> */<br /> public void sendPreviousReportsToServer() {<br /> sendCrashReportsToServer(mContext);<br /> } </p><p> /**<br /> * 把錯誤報表發送給伺服器,包含新產生的和以前沒發送的.<br /> *<br /> * @param ctx<br /> */<br /> private void sendCrashReportsToServer(Context ctx) {<br /> String[] crFiles = getCrashReportFiles(ctx);<br /> if (crFiles != null && crFiles.length > 0) {<br /> TreeSet<String> sortedFiles = new TreeSet<String>();<br /> sortedFiles.addAll(Arrays.asList(crFiles)); </p><p> for (String fileName : sortedFiles) {<br /> File cr = new File(ctx.getFilesDir(), fileName);<br /> postReport(cr);<br /> cr.delete();// 刪除已發送的報告<br /> }<br /> }<br /> } </p><p> private void postReport(File file) {<br /> // TODO 使用HTTP Post 發送錯誤報表到伺服器<br /> // 這裡不再詳述,開發人員可以根據OPhoneSDN上的其他網路操作<br /> // 教程來提交錯誤報表<br /> } </p><p> /**<br /> * 擷取錯誤報表檔案名稱<br /> * @param ctx<br /> * @return<br /> */<br /> private String[] getCrashReportFiles(Context ctx) {<br /> File filesDir = ctx.getFilesDir();<br /> FilenameFilter filter = new FilenameFilter() {<br /> public boolean accept(File dir, String name) {<br /> return name.endsWith(CRASH_REPORTER_EXTENSION);<br /> }<br /> };<br /> return filesDir.list(filter);<br /> }<br /> /**<br /> * 儲存錯誤資訊到檔案中<br /> * @param ex<br /> * @return<br /> */<br /> private String saveCrashInfoToFile(Throwable ex) {<br /> Writer info = new StringWriter();<br /> PrintWriter printWriter = new PrintWriter(info);<br /> ex.printStackTrace(printWriter); </p><p> Throwable cause = ex.getCause();<br /> while (cause != null) {<br /> cause.printStackTrace(printWriter);<br /> cause = cause.getCause();<br /> } </p><p> String result = info.toString();<br /> printWriter.close();<br /> mDeviceCrashInfo.put(STACK_TRACE, result); </p><p> try {<br /> long timestamp = System.currentTimeMillis();<br /> String fileName = "crash-" + timestamp + CRASH_REPORTER_EXTENSION;<br /> FileOutputStream trace = mContext.openFileOutput(fileName,<br /> Context.MODE_PRIVATE);<br /> mDeviceCrashInfo.store(trace, "");<br /> trace.flush();<br /> trace.close();<br /> return fileName;<br /> } catch (Exception e) {<br /> Log.e(TAG, "an error occured while writing report file...", e);<br /> }<br /> return null;<br /> } </p><p> /**<br /> * 收集程式崩潰的裝置資訊<br /> *<br /> * @param ctx<br /> */<br /> public void collectCrashDeviceInfo(Context ctx) {<br /> try {<br /> PackageManager pm = ctx.getPackageManager();<br /> PackageInfo pi = pm.getPackageInfo(ctx.getPackageName(),<br /> PackageManager.GET_ACTIVITIES);<br /> if (pi != null) {<br /> mDeviceCrashInfo.put(VERSION_NAME,<br /> pi.versionName == null ? "not set" : pi.versionName);<br /> mDeviceCrashInfo.put(VERSION_CODE, pi.versionCode);<br /> }<br /> } catch (NameNotFoundException e) {<br /> Log.e(TAG, "Error while collect package info", e);<br /> }<br /> //使用反射來收集裝置資訊.在Build類中包含各種裝置資訊,<br /> //例如: 系統版本號碼,裝置生產商 等協助偵錯工具的有用資訊<br />//具體資訊請參考後面的<br /> Field[] fields = Build.class.getDeclaredFields();<br /> for (Field field : fields) {<br /> try {<br /> field.setAccessible(true);<br /> mDeviceCrashInfo.put(field.getName(), field.get(null));<br /> if (DEBUG) {<br /> Log.d(TAG, field.getName() + " : " + field.get(null));<br /> }<br /> } catch (Exception e) {<br /> Log.e(TAG, "Error while collect crash info", e);<br /> } </p><p> } </p><p> } </p><p>}  

 

在上面CrashHandler實現中，當錯誤發生的時候使用Toast顯示錯誤資訊，然後收集錯誤報表並儲存在檔案中。 發送錯誤報表代碼請讀者自己實現。在uncaughtException函數中調用了Thread.sleep(3000)；來讓線程停止一會是為了顯示Toast資訊給使用者，然後Kill程式。如果你不用Toast來顯示資訊則可以去除該代碼。除了Toast外，開發人員還可以選擇使用Notification來顯示錯誤內容並讓使用者選擇是否提交錯誤報表而不是自動認可。關於Notification的實現請讀者參考：NotificationManager。在發送錯誤判道的時候，可以先檢測網路是否可用，如果不可用則可以在以後網路情況可用的情況下發送。 網路監測代碼如下：

 

/**<br /> * 檢測網路連接是否可用<br /> * @param ctx<br /> * @return true 可用; false 不可用<br /> */<br /> private boolean isNetworkAvailable(Context ctx) {<br /> ConnectivityManager cm =<br /> (ConnectivityManager) ctx.getSystemService(Context.CONNECTIVITY_SERVICE);<br /> if(cm == null) {<br /> return false;<br /> }<br /> NetworkInfo[] netinfo = cm.getAllNetworkInfo();<br /> if(netinfo == null) {<br /> return false;<br /> }<br /> for (int i = 0; i < netinfo.length; i++) {<br /> if(netinfo[i].isConnected()) {<br /> return true;<br /> }<br /> }<br /> return false;<br /> }  

 

下面是在模擬器和筆者手機(Dell mini3i OPhone1.5系統)上收集的具體資訊:

 

 

圖二: 模擬器資訊

圖三:Dell mini3i 裝置資訊

 

 

 

Application 實現

實現一個自訂Application來註冊CrashHandler. 代碼如下:

 

 

public class CrashApplication extends Application { </p><p> @Override<br /> public void onCreate() {<br /> super.onCreate();<br /> CrashHandler crashHandler = CrashHandler.getInstance();<br /> //註冊crashHandler<br /> crashHandler.init(getApplicationContext());<br /> //發送以前沒發送的報告(可選)<br /> crashHandler.sendPreviousReportsToServer();<br /> } </p><p>}  

 

 

在AndroidManifest.xml中註冊

最後只要在AndroidManifest.xml中註冊CrashApplication就可以了。代碼如下：

 

<?xml version="1.0" encoding="utf-8"?><br /><manifest xmlns:android="http://schemas.android.com/apk/res/android"<br /> package="org.goodev.cr"<br /> android:versionCode="1"<br /> android:versionName="1.0"><br /> <application android:icon="@drawable/icon" android:label="@string/app_name"<br /> android:name=".CrashApplication"><br /> <activity android:name=".ReporterTest"<br /> android:label="@string/app_name"><br /> <intent-filter><br /> <action android:name="android.intent.action.MAIN" /><br /> <category android:name="android.intent.category.LAUNCHER" /><br /> </intent-filter><br /> </activity><br /> </application><br /></manifest>  

 

 

總結：通過本文樣本的方式，開發人員可以在程式中收集詳細的崩潰資訊，從而為偵錯工具帶來便利，如果您的程式還沒有該功能趕快加入吧。crashReporter.zip中包含本文使用的專案檔及資源。

作者簡介： 程雲峰，網名icess，目前就職於杭州恒生電子研發中心，喜歡Java開源技術。
個人網站：http://www.chengyunfeng.com/ 

（聲明：本網的新聞及文章著作權均屬OPhone SDN網站所有，如需轉載請與我們編輯團隊聯絡。任何媒體、網站或個人未經本網書面協議授權，不得進行任何形式的轉載。已經取得本網協議授權的媒體、網站，在轉載使用時請註明稿件來源。）