轉載請標明出處:
http://www.lxweimin.com/p/70a32892d134
本文出自:【江清清博客-代號獨狼】
(一):寫在前面的話
接著上一篇繼續更新,上一篇文章已經把FastDev4Android項目數據輕量級緩存ACache組件做了講解和使用。今天項目更新客戶端崩潰異常捕捉組件CustomCrash的講解和使用。
本文章中的例子代碼已經同步到FastDev4Android項目中,地址為:
https://github.com/jiangqqlmj/FastDev4Android
在平時我們都知道,Android系統的手機和設備千差萬別,在模擬器上運行良好的程序安裝到某款手機上說不定就出現崩潰的現象,設備比較多,所以在程序發布出去之后,如果出現了崩潰現象,開發者應該及時獲取在該設備上導致崩潰的信息,同時可以獲取設備的相關信息和用戶信息,這對于下一個版本的 BUG 修復幫助極大,所以今天就來介紹一下如何在程序崩潰的情況下收集相關的設備參數信息和具體的異常信息,并發送這些信息到服務器供開發者分析和調試程序。同時替換系統默認的崩潰彈框,提升應用的用戶體驗。
首先我們來看一下系統默認的崩潰彈框顯示:
看上面的運行狀態,一旦我們的應用出現了異常崩潰,立馬會彈框,點擊OK應用就退出了,這樣用戶也不知道發生了什么情況,一下子應用的用戶體驗下降了很多。更加嚴重的是,作為我們開發者還不知道云在用戶手機的APP什么時候崩潰的,到底因為什么原因崩潰的。 OK下面我們來具體實現自定義的攔截崩潰異常的功能;
(二):具體實現
2.1:定義類 首先我們需要自定義一個實現Thead.UncaughtExceptionHandler的類,然后實現內部接口中定義的方法: void uncaughtException(Thread thread, Throwable ex); 具體如下:
public class CustomCrash implements Thread.UncaughtExceptionHandler
/*
* (non-Javadoc) 進行重寫捕捉異常
*
* @see
* java.lang.Thread.UncaughtExceptionHandler#uncaughtException(java.lang
* .Thread, java.lang.Throwable)
*/
@Override
public void uncaughtException(Thread thread, Throwable ex) {
if(type_save==TYPE_SAVE_SDCARD){
// 1,保存信息到sdcard中
saveToSdcard(mContext, ex);
}else if(type_save==TYPE_SAVE_REMOTE){
// 2,異常崩潰信息投遞到服務器
saveToServer(mContext,ex);
}
// 3,應用準備退出
showToast(mContext, "很抱歉,程序發生異常,即將推出.");
try {
Thread.sleep(3500);
} catch (InterruptedException e) {
e.printStackTrace();
}
ManagerActivity.getInstance().finishActivity();
android.os.Process.killProcess(android.os.Process.myPid());
}
2.2.上下文注冊 我們需要把當前應用的上下文注冊到系統的異常處理器中。這樣就讓系統執行我們自定義的異常捕捉器。
public void setCustomCrashInfo(Context pContext) {
this.mContext = pContext;
Thread.setDefaultUncaughtExceptionHandler(this);
}
2.3:崩潰異常日志保存
①:數據保存到SDCard中,直接轉換異常日志信息,寫入SDCard文件中如下:
/**
* 保存異常信息到sdcard中
*
* @param pContext
* @param ex
* 異常信息對象
*/
private void saveToSdcard(Context pContext, Throwable ex) {
String fileName = null;
StringBuffer sBuffer = new StringBuffer();
// 添加異常信息
sBuffer.append(getExceptionInfo(ex));
if (Environment.getExternalStorageState().equals(
Environment.MEDIA_MOUNTED)) {
File file1 = new File(CRASH_SAVE_SDPATH);
if (!file1.exists()) {
file1.mkdir();
}
fileName = file1.toString() + File.separator + paserTime(System.currentTimeMillis()) + ".log";
File file2 = new File(fileName);
FileOutputStream fos;
try {
fos = new FileOutputStream(file2);
fos.write(sBuffer.toString().getBytes());
fos.flush();
} catch (Exception e) {
e.printStackTrace();
}
}
}
②:數據POST投遞到服務器中,進行接口存入相應的文件或者數據庫中
/**
* 進行把數據投遞至服務器
* @param pContext
* @param ex 崩潰異常
*/
private void saveToServer(Context pContext,Throwable ex){
final String carsh_log=getExceptionInfo(ex);
new Thread(new Runnable() {
@Override
public void run() {
HashMap<String,String> params=new HashMap<String,String>();
params.put("crash_log",carsh_log);
String result= IoUtils.responseFromServiceByGetNo(CARSH_LOG_DELIVER, params);
if (result.equals("1")){
Log.d(TAG,"崩潰日志投遞成功...");
}else {
Log.d(TAG,"崩潰日志投遞失敗...");
}
}
}).start();
}
2.4:異常捕捉器具體使用: 我們需要在自定義的Application初始化方法進行初始化我們的捕捉器,然后設置改變系統捕捉器處理方式:
@Override
public void onCreate() {
super.onCreate();
this.instance=this;
//初始化崩潰日志收集器
CustomCrash mCustomCrash=CustomCrash.getInstance();
mCustomCrash.setCustomCrashInfo(this);
}
OK下面我們來具體來使用一下,我們故意制造一個空指針異常:結果分別如下:
2.5:由于上面對于類的核心方法進行了講解,并且該類其他也沒有多少行代碼,方便大家閱讀這邊直接把整個類復制如下,并且為了大家測試使用,類中崩潰日志投遞的地址也是可以正常使用的。
package com.chinaztt.fda.crash;
import android.content.Context;
import android.os.Environment;
import android.os.Looper;
import android.widget.Toast;
import com.chinaztt.fda.utils.IoUtils;
import com.chinaztt.fda.utils.Log;
import com.chinaztt.fda.utils.ManagerActivity;
import com.chinaztt.fda.utils.StrUtils;
import java.io.File;
import java.io.FileOutputStream;
import java.io.PrintWriter;
import java.io.StringWriter;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.HashMap;
import java.util.TimeZone;
/**
* 當前類注釋:客戶端運行 異常崩潰數據撲捉異常保存SD卡或者實時投遞服務器工具類
* 項目名:FastDev4Android
* 包名:com.chinaztt.fda.crash
* 作者:江清清 on 15/10/26 13:29
* 郵箱:jiangqqlmj@163.com
* QQ: 781931404
* 公司:江蘇中天科技軟件技術有限公司
*/
public class CustomCrash implements Thread.UncaughtExceptionHandler{
private static final String TAG="CustomCrash";
private static final int TYPE_SAVE_SDCARD=1; //崩潰日志保存本地SDCard --建議開發模式使用
private static final int TYPE_SAVE_REMOTE=2; //崩潰日志保存遠端服務器 --建議生產模式使用
private int type_save=2; //崩潰保存日志模式 默認為2,采用保存Web服務器
private static final String CRASH_SAVE_SDPATH="sdcard/fda_cache/"; //崩潰日志SD卡保存路徑
private static final String CARSH_LOG_DELIVER="http://img2.xxh.cc:8080/SalesWebTest/CrashDeliver";
private static CustomCrash instance = new CustomCrash();
private Context mContext;
private CustomCrash() {
}
/**
*
* @return
*/
public static CustomCrash getInstance() {
return instance;
}
/*
* (non-Javadoc) 進行重寫捕捉異常
*
* @see
* java.lang.Thread.UncaughtExceptionHandler#uncaughtException(java.lang
* .Thread, java.lang.Throwable)
*/
@Override
public void uncaughtException(Thread thread, Throwable ex) {
if(type_save==TYPE_SAVE_SDCARD){
// 1,保存信息到sdcard中
saveToSdcard(mContext, ex);
}else if(type_save==TYPE_SAVE_REMOTE){
// 2,異常崩潰信息投遞到服務器
saveToServer(mContext,ex);
}
// 3,應用準備退出
showToast(mContext, "很抱歉,程序發生異常,即將推出.");
try {
Thread.sleep(3500);
} catch (InterruptedException e) {
e.printStackTrace();
}
ManagerActivity.getInstance().finishActivity();
android.os.Process.killProcess(android.os.Process.myPid());
}
/**
* 設置自定異常處理類
*
* @param pContext
*/
public void setCustomCrashInfo(Context pContext) {
this.mContext = pContext;
Thread.setDefaultUncaughtExceptionHandler(this);
}
/**
* 保存異常信息到sdcard中
*
* @param pContext
* @param ex
* 異常信息對象
*/
private void saveToSdcard(Context pContext, Throwable ex) {
String fileName = null;
StringBuffer sBuffer = new StringBuffer();
// 添加異常信息
sBuffer.append(getExceptionInfo(ex));
if (Environment.getExternalStorageState().equals(
Environment.MEDIA_MOUNTED)) {
File file1 = new File(CRASH_SAVE_SDPATH);
if (!file1.exists()) {
file1.mkdir();
}
fileName = file1.toString() + File.separator + paserTime(System.currentTimeMillis()) + ".log";
File file2 = new File(fileName);
FileOutputStream fos;
try {
fos = new FileOutputStream(file2);
fos.write(sBuffer.toString().getBytes());
fos.flush();
} catch (Exception e) {
e.printStackTrace();
}
}
}
/**
* 進行把數據投遞至服務器
* @param pContext
* @param ex 崩潰異常
*/
private void saveToServer(Context pContext,Throwable ex){
final String carsh_log=getExceptionInfo(ex);
new Thread(new Runnable() {
@Override
public void run() {
HashMap<String,String> params=new HashMap<String,String>();
params.put("crash_log",carsh_log);
String result= IoUtils.responseFromServiceByGetNo(CARSH_LOG_DELIVER, params);
if (result.equals("1")){
Log.d(TAG,"崩潰日志投遞成功...");
}else {
Log.d(TAG,"崩潰日志投遞失敗...");
}
}
}).start();
}
/**
* 獲取并且轉化異常信息
* 同時可以進行投遞相關的設備,用戶信息
* @param ex
* @return 異常信息的字符串形式
*/
private String getExceptionInfo(Throwable ex) {
StringWriter sw = new StringWriter();
ex.printStackTrace(new PrintWriter(sw));
StringBuffer stringBuffer=new StringBuffer();
stringBuffer.append("---------Crash Log Begin---------\n");
//在這邊可以進行相關設備信息投遞--這邊就稍微設置幾個吧
//其他設備和用戶信息大家可以自己去擴展收集上傳投遞
stringBuffer.append("SystemVersion:"+ StrUtils.getLocalSystemVersion()+"\n");
stringBuffer.append(sw.toString()+"\n");
stringBuffer.append("---------Crash Log End---------\n");
return stringBuffer.toString();
}
/**
* 進行彈出框提示
*
* @param pContext
* @param msg
*/
private void showToast(final Context pContext, final String msg) {
new Thread(new Runnable() {
@Override
public void run() {
Looper.prepare();
Toast.makeText(pContext, msg, Toast.LENGTH_SHORT).show();
Looper.loop();
}
}).start();
}
/**
* 將毫秒數轉換成yyyy-MM-dd-HH-mm-ss的格式
* @param milliseconds
* @return
*/
private String paserTime(long milliseconds) {
System.setProperty("user.timezone", "Asia/Shanghai");
TimeZone tz = TimeZone.getTimeZone("Asia/Shanghai");
TimeZone.setDefault(tz);
SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd-HH-mm-ss");
String times = format.format(new Date(milliseconds));
return times;
}
}
到此為止我們今天自定義異常捕捉CustomCrash的講解和使用結果,
詳細代碼項目地址: https://github.com/jiangqqlmj/FastDev4Android
同時歡迎大家star和fork整個開源快速開發框架項目~如果有什么意見和反饋,歡迎留言,必定第一時間回復。也歡迎有同樣興趣的童鞋加入到該項目中來,一起維護該項目。