现在安装Android系统的手机版本和设备千差万别,在模拟器上运行良好的程序安装到某款手机上说不定就出现崩溃的现象,开发者个人不可能购买所有设备逐个调试,所以在程序发布出去之后,如果出现了崩溃现象,开发者应该及时获取在该设备上导致崩溃的信息,这对于下一个版本的bug修复帮助极大,所以今天就来介绍一下如何在程序崩溃的情况下收集相关的设备参数信息和具体的异常信息,并发送这些信息到服务器供开发者分析和调试程序。
首先看一下效果图:
一。在MainActivity.java代码中
代码是这样写的:
- public class MainActivity extends Activity {
- private TextView tv;
- @Override
- protected void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.activity_main);
- tv.setText("我没初始化");
- }
- @Override
- public boolean onCreateOptionsMenu(Menu menu) {
- // Inflate the menu; this adds items to the action bar if it is present.
- getMenuInflater().inflate(R.menu.main, menu);
- return true;
- }
- }
遇到软件没有捕获的异常之后,系统会弹出这个默认的强制关闭对话框。
我们当然不希望用户看到这种现象,简直是对用户心灵上的打击,而且对我们的bug的修复也是毫无帮助的。我们需要的是软件有一个全局的异常捕获器,当出现一个我们没有发现的异常时,捕获这个异常,并且将异常信息记录下来,上传到服务器公开发这分析出现异常的具体原因。
接下来我们就来实现这一机制,不过首先我们还是来了解以下两个类:android.app.Application和Java.lang.Thread.UncaughtExceptionHandler。
Application:用来管理应用程序的全局状态。在应用程序启动时Application会首先创建,然后才会根据情况(Intent)来启动相应的Activity和Service。本示例中将在自定义加强版的Application中注册未捕获异常处理器。
Thread.UncaughtExceptionHandler:线程未捕获异常处理器,用来处理未捕获异常。如果程序出现了未捕获异常,默认会弹出系统中强制关闭对话框。我们需要实现此接口,并注册为程序中默认未捕获异常处理。这样当未捕获异常发生时,就可以做一些个性化的异常处理操作。
大家刚才在项目的结构图中看到的CrashHandler.java实现了Thread.UncaughtExceptionHandler,使我们用来处理未捕获异常的主要成员,代码如下:
二:CrashHandler.java
- public class CrashHandler implements UncaughtExceptionHandler {
- public static String TAG = "MyCrash";
- // 系统默认的UncaughtException处理类
- private Thread.UncaughtExceptionHandler mDefaultHandler;
- private static CrashHandler instance = new CrashHandler();
- private Context mContext;
- // 用来存储设备信息和异常信息
- private Map<String, String> infos = new HashMap<String, String>();
- // 用于格式化日期,作为日志文件名的一部分
- private DateFormat formatter = new SimpleDateFormat("yyyy-MM-dd");
- /** 保证只有一个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);
- autoClear(5);
- }
- /**
- * 当UncaughtException发生时会转入该函数来处理
- */
- @Override
- public void uncaughtException(Thread thread, Throwable ex) {
- if (!handleException(ex) && mDefaultHandler != null) {
- // 如果用户没有处理则让系统默认的异常处理器来处理
- mDefaultHandler.uncaughtException(thread, ex);
- } else {
- SystemClock.sleep(1000);
- // 退出程序
- 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;
- try {
- // 使用Toast来显示异常信息
- new Thread() {
- @Override
- public void run() {
- Looper.prepare();
- Toast.makeText(mContext, "很抱歉,程序出现异常,即将重启.",
- Toast.LENGTH_LONG).show();
- Looper.loop();
- }
- }.start();
- // 收集设备参数信息
- collectDeviceInfo(mContext);
- // 保存日志文件
- saveCrashInfoFile(ex);
- // 重启应用(按需要添加是否重启应用)
- // Intent intent = mContext.getPackageManager().getLaunchIntentForPackage(mContext.getPackageName());
- // intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
- // mContext.startActivity(intent);
- // SystemClock.sleep(1000);
- } catch (Exception e) {
- e.printStackTrace();
- }
- 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 + "";
- 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());
- } catch (Exception e) {
- Log.e(TAG, "an error occured when collect crash info", e);
- }
- }
- }
- /**
- * 保存错误信息到文件中
- * @param ex
- * @return 返回文件名称,便于将文件传送到服务器
- * @throws Exception
- */
- private String saveCrashInfoFile(Throwable ex) throws Exception {
- StringBuffer sb = new StringBuffer();
- try {
- SimpleDateFormat sDateFormat = new SimpleDateFormat(
- "yyyy-MM-dd HH:mm:ss");
- String date = sDateFormat.format(new java.util.Date());
- sb.append("\r\n" + date + "\n");
- 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.flush();
- printWriter.close();
- String result = writer.toString();
- sb.append(result);
- String fileName = writeFile(sb.toString());
- return fileName;
- } catch (Exception e) {
- Log.e(TAG, "an error occured while writing file...", e);
- sb.append("an error occured while writing file...\r\n");
- writeFile(sb.toString());
- }
- return null;
- }
- private String writeFile(String sb) throws Exception {
- String time = formatter.format(new Date());
- String fileName = "crash-" + time + ".log";
- if (FileUtil.hasSdcard()) {
- String path = getGlobalpath();
- File dir = new File(path);
- if (!dir.exists())
- dir.mkdirs();
- FileOutputStream fos = new FileOutputStream(path + fileName, true);
- fos.write(sb.getBytes());
- fos.flush();
- fos.close();
- }
- return fileName;
- }
- public static String getGlobalpath() {
- return Environment.getExternalStorageDirectory().getAbsolutePath()
- + File.separator + "crash" + File.separator;
- }
- public static void setTag(String tag) {
- TAG = tag;
- }
- /**
- * 文件删除
- * @param day 文件保存天数
- */
- public void autoClear(final int autoClearDay) {
- FileUtil.delete(getGlobalpath(), new FilenameFilter() {
- @Override
- public boolean accept(File file, String filename) {
- String s = FileUtil.getFileNameWithoutExtension(filename);
- int day = autoClearDay < 0 ? autoClearDay : -1 * autoClearDay;
- String date = "crash-" + DateUtil.getOtherDay(day);
- return date.compareTo(s) >= 0;
- }
- });
- }
- }
在收集异常信息时,朋友们也可以使用Properties,因为Properties有一个很便捷的方法properties.store(OutputStream out, String comments),用来将Properties实例中的键值对外输到输出流中,但是在使用的过程中发现生成的文件中异常信息打印在同一行,看起来极为费劲,所以换成Map来存放这些信息,然后生成文件时稍加了些操作。
完成这个CrashHandler后,我们需要在一个Application环境中让其运行,为此,我们继承android.app.Application,添加自己的代码,CrashApplication.java代码如下:
三.MyAppcation
- public class MyAppcation extends Application{
- @Override
- public void onCreate() {
- super.onCreate();
- CrashHandler.getInstance().init(this);
- }
- }
因为我们上面的CrashHandler中,遇到异常后要保存设备参数和具体异常信息到SDCARD,所以我们需要在AndroidManifest.xml中加入读写SDCARD权限:
- <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
然后看一下SDCARD生成的文件: