大家都知道,現在安裝 Android 系統的手機和設備千差萬別,在模擬器上運行良好的程序安裝到某款手機上說不定就出現崩潰的現象,開發者個人不可能購買所有設備逐個調試,所以在程序發布出去之后,如果出現了崩潰現象,開發者應該及時獲取在該設備上導致崩潰的信息,這對於下一個版本的 BUG 修復幫助極大,所以今天就來介紹一下如何在程序崩潰的情況下收集相關的設備參數信息和具體的異常信息,並發送這些信息到服務器供開發者分析和調試程序。
我們先建立一個 crash 項目,項目結構如圖:
在 MainActivity.java 代碼中,代碼是這樣寫的:
- package com.scott.crash;
- import android.app.Activity;
- import android.os.Bundle;
- public class MainActivity extends Activity {
- private String s;
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- System.out.println(s.equals("any string"));
- }
- }
我們在這里故意制造了一個潛在的運行期異常,當我們運行程序時就會出現以下界面:
遇到軟件沒有捕獲的異常之后,系統會彈出這個默認的強制關閉對話框。
我們當然不希望用戶看到這種現象,簡直是對用戶心靈上的打擊,而且對我們的 BUG 的修復也是毫無幫助的。我們需要的是軟件有一個全局的異常捕獲器,當出現一個我們沒有發現的異常時,捕獲這個異常,並且將異常信息記錄下來,上傳到服務器公開發這分析出現異常的具體原因。
接下來我們就來實現這一機制,不過首先我們還是來了解以下兩個類:android.app.Application 和java.lang.Thread.UncaughtExceptionHandler。
1、Application:用來管理應用程序的全局狀態。在應用程序啟動時 Application 會首先創建,然后才會根據情況(Intent)來啟動相應的Activity 和 Service。本示例中將在自定義加強版的 Application 中注冊未捕獲異常處理器。
2、Thread.UncaughtExceptionHandler:線程未捕獲異常處理器,用來處理未捕獲異常。如果程序出現了未捕獲異常,默認會彈出系統中強制關閉對話框。我們需要實現此接口,並注冊為程序中默認未捕獲異常處理。這樣當未捕獲異常發生時,就可以做一些個性化的異常處理操作。
大家在剛才的項目結構圖中看到的 CrashHandler.java 實現了 Thread.UncaughtExceptionHandler,使我們用來處理未捕獲異常的主要成員,代碼如下:
- package com.scott.crash;
- import java.io.File;
- import java.io.FileOutputStream;
- 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.DateFormat;
- 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 user
- *
- */
- public class CrashHandler implements UncaughtExceptionHandler {
- public static final String TAG = "CrashHandler";
- // CrashHandler 實例
- private static CrashHandler INSTANCE = new CrashHandler();
- // 程序的 Context 對象
- private Context mContext;
- // 系統默認的 UncaughtException 處理類
- private Thread.UncaughtExceptionHandler mDefaultHandler;
- // 用來存儲設備信息和異常信息
- private Map<String, String> infos = new HashMap<String, String>();
- // 用於格式化日期,作為日志文件名的一部分
- private DateFormat formatter = 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;
- // 獲取系統默認的 UncaughtException 處理器
- mDefaultHandler = Thread.getDefaultUncaughtExceptionHandler();
- // 設置該 CrashHandler 為程序的默認處理器
- Thread.setDefaultUncaughtExceptionHandler(this);
- }
- /**
- * 當 UncaughtException 發生時會轉入該函數來處理
- */
- @Override
- public void uncaughtException(Thread thread, Throwable ex) {
- if (!handleException(ex) && mDefaultHandler != null) {
- // 如果用戶沒有處理則讓系統默認的異常處理器來處理
- mDefaultHandler.uncaughtException(thread, ex);
- } else {
- try {
- Thread.sleep(3000);
- } catch (InterruptedException e) {
- Log.e(TAG, "error : ", e);
- }
- // 退出程序,注釋下面的重啟啟動程序代碼
- android.os.Process.killProcess(android.os.Process.myPid());
- System.exit(1);
- // 重新啟動程序,注釋上面的退出程序
- Intent intent = new Intent();
- intent.setClass(mContext,MainActivity.class);
- intent.addFlag(Intent.FLAG_ACTIVITY_NEW_TASK);
- mContext.startActivity(intent);
- android.os.Process.killProcess(android.os.Process.myPid());
- }
- }
- /**
- * 自定義錯誤處理,收集錯誤信息,發送錯誤報告等操作均在此完成
- *
- * @param ex
- * @return true:如果處理了該異常信息;否則返回 false
- */
- private boolean handleException(Throwable ex) {
- if (ex == null) {
- return false;
- }
- // 使用 Toast 來顯示異常信息
- new Thread() {
- @Override
- public void run() {
- Looper.prepare();
- Toast.makeText(mContext, "很抱歉,程序出現異常,即將退出。", Toast.LENGTH_LONG).show();
- Looper.loop();
- }
- }.start();
- // 收集設備參數信息
- collectDeviceInfo(mContext);
- // 保存日志文件
- saveCrashInfo2File(ex);
- return true;
- }
- /**
- * 收集設備參數信息
- * @param ctx
- */
- public void collectDeviceInfo(Context ctx) {
- try {
- PackageManager pm = ctx.getPackageManager();
- PackageInfo pi = pm.getPackageInfo(ctx.getPackageName(), PackageManager.GET_ACTIVITIES);
- if (pi != null) {
- String versionName = pi.versionName == null ? "null" : pi.versionName;
- String versionCode = pi.versionCode + "";
- infos.put("versionName", versionName);
- infos.put("versionCode", versionCode);
- }
- } catch (NameNotFoundException e) {
- Log.e(TAG, "an error occured when collect package info", e);
- }
- Field[] fields = Build.class.getDeclaredFields();
- for (Field field : fields) {
- try {
- field.setAccessible(true);
- infos.put(field.getName(), field.get(null).toString());
- Log.d(TAG, field.getName() + " : " + field.get(null));
- } catch (Exception e) {
- Log.e(TAG, "an error occured when collect crash info", e);
- }
- }
- }
- /**
- * 保存錯誤信息到文件中
- *
- * @param ex
- * @return 返回文件名稱,便於將文件傳送到服務器
- */
- private String saveCrashInfo2File(Throwable ex) {
- StringBuffer sb = new StringBuffer();
- for (Map.Entry<String, String> entry : infos.entrySet()) {
- String key = entry.getKey();
- String value = entry.getValue();
- sb.append(key + "=" + value + "\n");
- }
- Writer writer = new StringWriter();
- PrintWriter printWriter = new PrintWriter(writer);
- ex.printStackTrace(printWriter);
- Throwable cause = ex.getCause();
- while (cause != null) {
- cause.printStackTrace(printWriter);
- cause = cause.getCause();
- }
- printWriter.close();
- String result = writer.toString();
- sb.append(result);
- try {
- long timestamp = System.currentTimeMillis();
- String time = formatter.format(new Date());
- String fileName = "crash-" + time + "-" + timestamp + ".log";
- if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {
- String path = "/sdcard/crash/";
- File dir = new File(path);
- if (!dir.exists()) {
- dir.mkdirs();
- }
- FileOutputStream fos = new FileOutputStream(path + fileName);
- fos.write(sb.toString().getBytes());
- fos.close();
- }
- return fileName;
- } catch (Exception e) {
- Log.e(TAG, "an error occured while writing file...", e);
- }
- return null;
- }
- }
在收集異常信息時,朋友們也可以使用 Properties,因為 Properties 有一個很便捷的方法 properties.store(OutputStream out, String comments),用來將Properties 實例中的鍵值對外輸到輸出流中,但是在使用的過程中發現生成的文件中異常信息打印在同一行,看起來極為費勁,所以換成 Map 來存放這些信息,然后生成文件時稍加了些操作。
完成這個 CrashHandler 后,我們需要在一個 Application 環境中讓其運行,為此,我們繼承 android.app.Application,添加自己的代碼,CrashApplication.java代碼如下:
- package com.scott.crash;
- import android.app.Application;
- public class CrashApplication extends Application {
- @Override
- public void onCreate() {
- super.onCreate();
- CrashHandler crashHandler = CrashHandler.getInstance();
- crashHandler.init(getApplicationContext());
- }
- }
最后,為了讓我們的 CrashApplication 取代 android.app.Application 的地位,在我們的代碼中生效,我們需要修改 AndroidManifest.xml:
- <application android:name=".CrashApplication" ...>
- </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
這些信息對於開發者來說幫助極大,所以我們需要將此日志文件上傳到服務器,有關文件上傳的技術,請參照 Android 中使用 HTTP 服務相關介紹。
不過在使用 HTTP 服務之前,需要確定網絡暢通,我們可以使用下面的方式判斷網絡是否可用:
- /**
- * 網絡是否可用
- *
- * @param context
- * @return
- */
- public static boolean isNetworkAvailable(Context context) {
- ConnectivityManager mgr = (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);
- NetworkInfo[] info = mgr.getAllNetworkInfo();
- if (info != null) {
- for (int i = 0; i < info.length; i++) {
- if (info[i].getState() == NetworkInfo.State.CONNECTED) {
- return true;
- }
- }
- }
- return false;
- }
轉載自:
http://blog.csdn.net/jdsjlzx/article/details/7606423