1. 程式人生 > >捕獲全域性異常UncaughtExceptionHandler

捕獲全域性異常UncaughtExceptionHandler

http://git.oschina.net/oschina/android-app 大家可以參考。

大家都知道,現在安裝Android系統的手機版本和裝置千差萬別,在模擬器上執行良好的程式安裝到某款手機上說不定就出現崩潰的現象,開發者個人不可能購買所有裝置逐個除錯,所以在程式釋出出去之後,如果出現了崩潰現象,開發者應該及時獲取在該裝置上導致崩潰的資訊,這對於下一個版本的bug修復幫助極大,所以今天就來介紹一下如何在程式崩潰的情況下收集相關的裝置引數資訊和具體的異常資訊,併發送這些資訊到伺服器供開發者分析和除錯程式。

我們先建立一個crash專案,專案結構如圖:

在MainActivity.java程式碼中,程式碼是這樣寫的:

  1. package com.scott.crash;  
  2. import android.app.Activity;  
  3. import android.os.Bundle;  
  4. public class MainActivity extends Activity {  
  5.     private String s;  
  6.     @Override  
  7.     public void onCreate(Bundle savedInstanceState) {  
  8.         super.onCreate(savedInstanceState);  
  9.         System.out.println(s.equals("any string"
    ));  
  10.     }  
  11. }  

 我們在這裡故意製造了一個潛在的執行期異常,當我們執行程式時就會出現以下介面:

遇到軟體沒有捕獲的異常之後,系統會彈出這個預設的強制關閉對話方塊。

我們當然不希望使用者看到這種現象,簡直是對使用者心靈上的打擊,而且對我們的bug的修復也是毫無幫助的。我們需要的是軟體有一個全域性的異常捕獲器,當出現一個我們沒有發現的異常時,捕獲這個異常,並且將異常資訊記錄下來,上傳到伺服器公開發這分析出現異常的具體原因。

接下來我們就來實現這一機制,不過首先我們還是來了解以下兩個類:android.app.Application和java.lang.Thread.UncaughtExceptionHandler。

Application:用來管理應用程式的全域性狀態。在應用程式啟動時Application會首先建立,然後才會根據情況(Intent)來啟動相應的Activity和Service。本示例中將在自定義加強版的Application中註冊未捕獲異常處理器。

Thread.UncaughtExceptionHandler:執行緒未捕獲異常處理器,用來處理未捕獲異常。如果程式出現了未捕獲異常,預設會彈出系統中強制關閉對話方塊。我們需要實現此介面,並註冊為程式中預設未捕獲異常處理。這樣當未捕獲異常發生時,就可以做一些個性化的異常處理操作。

大家剛才在專案的結構圖中看到的CrashHandler.java實現了Thread.UncaughtExceptionHandler,使我們用來處理未捕獲異常的主要成員,程式碼如下:

  1. package com.scott.crash;  
  2. import java.io.File;  
  3. import java.io.FileOutputStream;  
  4. import java.io.PrintWriter;  
  5. import java.io.StringWriter;  
  6. import java.io.Writer;  
  7. import java.lang.Thread.UncaughtExceptionHandler;  
  8. import java.lang.reflect.Field;  
  9. import java.text.DateFormat;  
  10. import java.text.SimpleDateFormat;  
  11. import java.util.Date;  
  12. import java.util.HashMap;  
  13. import java.util.Map;  
  14. import android.content.Context;  
  15. import android.content.pm.PackageInfo;  
  16. import android.content.pm.PackageManager;  
  17. import android.content.pm.PackageManager.NameNotFoundException;  
  18. import android.os.Build;  
  19. import android.os.Environment;  
  20. import android.os.Looper;  
  21. import android.util.Log;  
  22. import android.widget.Toast;  
  23. /** 
  24.  * UncaughtException處理類,當程式發生Uncaught異常的時候,有該類來接管程式,並記錄傳送錯誤報告. 
  25.  *  
  26.  * @author user 
  27.  *  
  28.  */  
  29. public class CrashHandler implements UncaughtExceptionHandler {  
  30.     public static final String TAG = "CrashHandler";  
  31.     //系統預設的UncaughtException處理類   
  32.     private Thread.UncaughtExceptionHandler mDefaultHandler;  
  33.     //CrashHandler例項  
  34.     private static CrashHandler INSTANCE = new CrashHandler();  
  35.     //程式的Context物件  
  36.     private Context mContext;  
  37.     //用來儲存裝置資訊和異常資訊  
  38.     private Map<String, String> infos = new HashMap<String, String>();  
  39.     //用於格式化日期,作為日誌檔名的一部分  
  40.     private DateFormat formatter = new SimpleDateFormat("yyyy-MM-dd-HH-mm-ss");  
  41.     /** 保證只有一個CrashHandler例項 */  
  42.     private CrashHandler() {  
  43.     }  
  44.     /** 獲取CrashHandler例項 ,單例模式 */  
  45.     public static CrashHandler getInstance() {  
  46.         return INSTANCE;  
  47.     }  
  48.     /** 
  49.      * 初始化 
  50.      *  
  51.      * @param context 
  52.      */  
  53.     public void init(Context context) {  
  54.         mContext = context;  
  55.         //獲取系統預設的UncaughtException處理器  
  56.         mDefaultHandler = Thread.getDefaultUncaughtExceptionHandler();  
  57.         //設定該CrashHandler為程式的預設處理器  
  58.         Thread.setDefaultUncaughtExceptionHandler(this);  
  59.     }  
  60.     /** 
  61.      * 當UncaughtException發生時會轉入該函式來處理 
  62.      */  
  63.     @Override  
  64.     public void uncaughtException(Thread thread, Throwable ex) {  
  65.         if (!handleException(ex) && mDefaultHandler != null) {  
  66.             //如果使用者沒有處理則讓系統預設的異常處理器來處理  
  67.             mDefaultHandler.uncaughtException(thread, ex);  
  68.         } else {  
  69.             try {  
  70.                 Thread.sleep(3000);  
  71.             } catch (InterruptedException e) {  
  72.                 Log.e(TAG, "error : ", e);  
  73.             }  
  74.             //退出程式  
  75.             android.os.Process.killProcess(android.os.Process.myPid());  
  76.             System.exit(1);  
  77.         }  
  78.     }  
  79.     /** 
  80.      * 自定義錯誤處理,收集錯誤資訊 傳送錯誤報告等操作均在此完成. 
  81.      *  
  82.      * @param ex 
  83.      * @return true:如果處理了該異常資訊;否則返回false. 
  84.      */  
  85.     private boolean handleException(Throwable ex) {  
  86.         if (ex == null) {  
  87.             return false;  
  88.         }  
  89.         //使用Toast來顯示異常資訊  
  90.         new Thread() {  
  91.             @Override  
  92.             public void run() {  
  93.                 Looper.prepare();  
  94.                 Toast.makeText(mContext, "很抱歉,程式出現異常,即將退出.", Toast.LENGTH_LONG).show();  
  95.                 Looper.loop();  
  96.             }  
  97.         }.start();  
  98.         //收集裝置引數資訊   
  99.         collectDeviceInfo(mContext);  
  100.         //儲存日誌檔案   
  101.         saveCrashInfo2File(ex);  
  102.         return true;  
  103.     }  
  104.     /** 
  105.      * 收集裝置引數資訊 
  106.      * @param ctx 
  107.      */  
  108.     public void collectDeviceInfo(Context ctx) {  
  109.         try {  
  110.             PackageManager pm = ctx.getPackageManager();  
  111.             PackageInfo pi = pm.getPackageInfo(ctx.getPackageName(), PackageManager.GET_ACTIVITIES);  
  112.             if (pi != null) {  
  113.                 String versionName = pi.versionName == null ? "null" : pi.versionName;  
  114.                 String versionCode = pi.versionCode + "";  
  115.                 infos.put("versionName", versionName);  
  116.                 infos.put("versionCode", versionCode);  
  117.             }  
  118.         } catch (NameNotFoundException e) {  
  119.             Log.e(TAG, "an error occured when collect package info", e);  
  120.         }  
  121.         Field[] fields = Build.class.getDeclaredFields();  
  122.         for (Field field : fields) {  
  123.             try {  
  124.                 field.setAccessible(true);  
  125.                 infos.put(field.getName(), field.get(null).toString());  
  126.                 Log.d(TAG, field.getName() + " : " + field.get(null));  
  127.             } catch (Exception e) {  
  128.                 Log.e(TAG, "an error occured when collect crash info", e);  
  129.             }  
  130.         }  
  131.     }  
  132.     /** 
  133.      * 儲存錯誤資訊到檔案中 
  134.      *  
  135.      * @param ex 
  136.      * @return  返回檔名稱,便於將檔案傳送到伺服器 
  137.      */  
  138.     private String saveCrashInfo2File(Throwable ex) {  
  139.         StringBuffer sb = new StringBuffer();  
  140.         for (Map.Entry<String, String> entry : infos.entrySet()) {  
  141.             String key = entry.getKey();  
  142.             String value = entry.getValue();  
  143.             sb.append(key + "=" + value + "\n");  
  144.         }  
  145.         Writer writer = new StringWriter();  
  146.         PrintWriter printWriter = new PrintWriter(writer);  
  147.         ex.printStackTrace(printWriter);  
  148.         Throwable cause = ex.getCause();  
  149.         while (cause != null) {  
  150.             cause.printStackTrace(printWriter);  
  151.             cause = cause.getCause();  
  152.         }  
  153.         printWriter.close();  
  154.         String result = writer.toString();  
  155.         sb.append(result);  
  156.         try {  
  157.             long timestamp = System.currentTimeMillis();  
  158.             String time = formatter.format(new Date());  
  159.             String fileName = "crash-" + time + "-" + timestamp + ".log";  
  160.             if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {  
  161.                 String path = "/sdcard/crash/";  
  162.                 File dir = new File(path);  
  163.                 if (!dir.exists()) {  
  164.                     dir.mkdirs();  
  165.                 }  
  166.                 FileOutputStream fos = new FileOutputStream(path + fileName);  
  167.                 fos.write(sb.toString().getBytes());  
  168.                 fos.close();  
  169.             }  
  170.             return fileName;  
  171.         } catch (Exception e) {  
  172.             Log.e(TAG, "an error occured while writing file...", e);  
  173.         }  
  174.         return null;  
  175.     }  
  176. }  

在收集異常資訊時,朋友們也可以使用Properties,因為Properties有一個很便捷的方法properties.store(OutputStream out, String comments),用來將Properties例項中的鍵值對外輸到輸出流中,但是在使用的過程中發現生成的檔案中異常資訊列印在同一行,看起來極為費勁,所以換成Map來存放這些資訊,然後生成檔案時稍加了些操作。

完成這個CrashHandler後,我們需要在一個Application環境中讓其執行,為此,我們繼承android.app.Application,新增自己的程式碼,CrashApplication.java程式碼如下:

  1. package com.scott.crash;  
  2. import android.app.Application;  
  3. public class CrashApplication extends Application {  
  4.     @Override  
  5.     public void onCreate() {  
  6.         super.onCreate();  
  7.         CrashHandler crashHandler = CrashHandler.getInstance();  
  8.         crashHandler.init(getApplicationContext());  
  9.     }  
  10. }  

最後,為了讓我們的CrashApplication取代android.app.Application的地位,在我們的程式碼中生效,我們需要修改AndroidManifest.xml:

  1. <application android:name=".CrashApplication" ...>  
  2. </application>  

因為我們上面的CrashHandler中,遇到異常後要儲存裝置引數和具體異常資訊到SDCARD,所以我們需要在AndroidManifest.xml中加入讀寫SDCARD許可權:

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

搞定了上邊的步驟之後,我們來執行一下這個專案:

看以看到,並不會有強制關閉的對話框出現了,取而代之的是我們比較有好的提示資訊。

然後看一下SDCARD生成的檔案:



用文字編輯器開啟日誌檔案,看一段日誌資訊:

  1. CPU_ABI=armeabi  
  2. CPU_ABI2=unknown  
  3. ID=FRF91  
  4. MANUFACTURER=unknown  
  5. BRAND=generic  
  6. TYPE=eng  
  7. ......  
  8. Caused by: java.lang.NullPointerException  
  9.     at com.scott.crash.MainActivity.onCreate(MainActivity.java:13)  
  10.     at android.app.Instrumentation.callActivityOnCreate(Instrumentation.java:1047)  
  11.     at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2627)  
  12.     ... 11 more  

這些資訊對於開發者來說幫助極大,所以我們需要將此日誌檔案上傳到伺服器,有關檔案上傳的技術,請參照Android中使用HTTP服務相關介紹。

不過在使用HTTP服務之前,需要確定網路暢通,我們可以使用下面的方式判斷網路是否可用:

  1. /** 
  2.      * 網路是否可用 
  3.      *  
  4.      * @param context 
  5.      * @return 
  6.      */  
  7.     public static boolean isNetworkAvailable(Context context) {  
  8.         ConnectivityManager mgr = (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);  
  9.         NetworkInfo[] info = mgr.getAllNetworkInfo();  
  10.         if (info != null) {  
  11.             for (int i = 0; i < info.length; i++) {  
  12.                 if (info[i].getState() == NetworkInfo.State.CONNECTED) {  
  13.                     return true;  
  14.                 }  
  15.             }  
  16.         }  
  17.         return false;  
  18.     }