大家都知道,现在安装Android系统的手机版本和设备千差万别,在模拟器和自己的android手机上运行良好的程序安装到某款手机上说不定就出现崩溃的现象,或是本来好好的程序装到领导或老板的手机上就崩溃了,这可是很尴尬很致命的,开发者个人不可能购买所有设备逐个调试,领导们也不可能把手机拿给你通过数据线进行调试,所以在程序发布出去之后,如果出现了崩溃现象,开发者应该及时获取在该设备上导致崩溃的信息,这对于下一个版本的bug修复帮助极大,所以今天就来介绍一下如何在程序崩溃的情况下收集相关的设备参数信息和具体的异常信息,并发送这些信息到服务器供开发者分析和调试程序。
详细操作:
1、创建一个CrashHandler.java
importjava.io.File;
importjava.io.FileOutputStream;
importjava.io.PrintWriter;
importjava.io.StringWriter;
importjava.io.Writer;
importjava.lang.Thread.UncaughtExceptionHandler;
importjava.lang.reflect.Field;
importjava.text.DateFormat;
importjava.text.SimpleDateFormat;
importjava.util.Date;
importjava.util.HashMap;
importjava.util.Map;
importandroid.content.Context;
importandroid.content.pm.PackageInfo;
importandroid.content.pm.PackageManager;
importandroid.content.pm.PackageManager.NameNotFoundException;
importandroid.os.Build;
importandroid.os.Environment;
importandroid.os.Looper;
importandroid.util.Log;
importandroid.widget.Toast;
/**
* UncaughtException处理类,当程序发生Uncaught异常的时候,有该类来接管程序,并记录发送错误报告.
*/
public class CrashHandler implements UncaughtExceptionHandler {
public static final String TAG ="CrashHandler";
//系统默认的UncaughtException处理类
private Thread.UncaughtExceptionHandler mDefaultHandler;
//CrashHandler实例
privatestaticCrashHandler INSTANCE =newCrashHandler();
//程序的Context对象
private Context mContext;
//用来存储设备信息和异常信息
private Map infos =new HashMap();
//用于格式化日期,作为日志文件名的一部分
private Date Format 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);
}
}
/**
* 自定义错误处理,收集错误信息 发送错误报告等操作均在此完成.
*
* @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 =newStringBuffer();
for(Map.Entry 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(newDate());
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来存放这些信息,然后生成文件时稍加了些操作。
2、完成这个CrashHandler后,我们需要在一个Application环境中让其运行,为此,我们继承android.app.Application,在Application的onCreate()中加入以下两行代码,便可启动全局异常捕获
//启动全局获取异常
CrashHandler crashHandler = CrashHandler.getInstance();
crashHandler.init(getApplicationContext());
最后,为了让我们的CrashApplication取代android.app.Application的地位,在我们的代码中生效,我们需要修改AndroidManifest.xml:
<application android:name="你的Application类名" />
因为我们CrashHandler中,遇到异常后要保存设备参数和具体异常信息到SDCARD,所以我们需要在AndroidManifest.xml中加入读写SDCARD权限
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
网友评论