01.Android崩溃Crash封装库

目录介绍

  • 01.该库具有的功能
  • 02.该库优势分析
  • 03.该库如何使用
  • 04.降低非必要crash
  • 05.异常恢复原理
  • 06.后续的需求说明
  • 07.异常栈轨迹原理
  • 08.部分问题反馈
  • 09.其他内容说明

01.该库具有的功能

1.1 功能说明

  • 异常崩溃后思考的一些问题
    • 1.是否需要恢复activity栈，以及所在崩溃页面数据
    • 2.crash信息保存和异常捕获，是否和百度bug崩溃统计sdk等兼容。是否方便接入
    • 3.是否要回到栈顶部的那个activity(保存栈信息)
    • 4.崩溃后需要收集哪些信息。手机信息，app信息，崩溃堆栈，内存信息等
    • 5.异常崩溃如何友好退出，以及崩溃后调用重启app是否会出现数据异常
    • 6.针对native代码崩溃，如何记录日志写到文件中
  • 该库可以做一些什么
    • 1.在Android手机上显示闪退崩溃信息，并且崩溃详情信息可以保存，分享给开发
      • 主要是测试同学在测试中发现了崩溃，然后跑过去跟开发说，由于不容易复现导致开发童鞋不承认……有时候用的bug统计不是那么准！
    • 2.对于某些设备，比如做Kindle开发，可以设置崩溃重启app操作
    • 3.暴露了用户上传自己捕获的crash数据，以及崩溃重启的接口监听操作
    • 4.一个崩溃日志保存到一个文件中，文件命名规则【版本+日期+异常】：V1.0_2020-09-02_09:05:01_java.lang.NullPointerException.txt
    • 5.崩溃日志list可以获取，支持查看日志详情，并且可以分享，截图，以及复制崩溃信息
    • 6.收集崩溃日志包括，设备信息，进程信息，崩溃信息(Java崩溃、Native崩溃 or ANR)
    • 7.收集崩溃时的内存信息（OOM、ANR、虚拟内存耗尽等，很多崩溃都跟内存有直接关系），完善中

1.2 截图如下所示

image

image

image

image

1.3崩溃后日志记录

image

1.4 崩溃流程图

image

02.该库优势分析

  • 低入侵性接入该lib，不会影响你的其他业务。暴露崩溃重启，以及支持开发者自己捕获crash数据的接口！能够收集崩溃中的日志写入文件，记录包括设备信息，进程信息，崩溃信息(Java崩溃、Native崩溃 or ANR)，以及崩溃时内存信息到file文件中。支持用户获取崩溃列表，以及跳转崩溃日志详情页面，并且可以将崩溃日志分享，截长图，复制等操作。可以方便测试和产品给开发提出那种偶发性bug的定位日志，免得对于偶发行崩溃，开发总是不承认……开发总是不承认……

03.该库如何使用

  • 如何引入该库 
    implementation 'cn.yc:ToolLib:1.0.0'
//GitHub代码
https://github.com/yangchong211/YCAndroidTool
  • 初始化代码如下所示。建议在Application中初始化…… 
    CrashHandler.getInstance().init(this, new CrashListener() {
    /**
     * 重启app
     */
    @Override
    public void againStartApp() {
        CrashToolUtils.reStartApp1(App.this,1000);
        //CrashToolUtils.reStartApp2(App.this,1000, MainActivity.class);
        //CrashToolUtils.reStartApp3(AppManager.getAppManager().currentActivity());
    }

    /**
     * 自定义上传crash，支持开发者上传自己捕获的crash数据
     * @param ex                        ex
     */
    @Override
    public void recordException(Throwable ex) {
        //自定义上传crash，支持开发者上传自己捕获的crash数据
        //StatService.recordException(getApplication(), ex);
    }
});
  • 关于重启App的操作有三种方式api 
    //开启一个新的服务KillSelfService，用来重启本APP【使用handler延迟】
CrashToolUtils.reStartApp1(App.this,1000);
//用来重启本APP[使用闹钟，整体重启，临时数据清空（推荐）]
CrashToolUtils.reStartApp2(App.this,1000, MainActivity.class);
//检索获取项目中LauncherActivity，然后设置该activity的flag和component启动app【推荐】
CrashToolUtils.reStartApp3(AppManager.getAppManager().currentActivity());
  • 关于获取崩溃目录api 
    //崩溃文件存储路径：/storage/emulated/0/Android/data/你的包名/cache/crashLogs
//崩溃页面截图存储路径：/storage/emulated/0/Android/data/你的包名/cache/crashPics
String crashLogPath = ToolFileUtils.getCrashLogPath(this);
String crashPicPath = ToolFileUtils.getCrashPicPath(this);
  • 关于崩溃日志记录
    • 日志记录路径：/storage/emulated/0/Android/data/你的包名/cache/crashLogs
    • 日志文件命名：V1.0_2020-09-02_09:05:01_java.lang.NullPointerException.txt【版本+日期+异常】
  • 关于跳转错误日志list列表页面
    • 跳转日志列表页面如下所示，这里调用一行代码即可。点击该页面list条目即可进入详情
    CrashToolUtils.startCrashListActivity(this);
  • 那么如何获取所有崩溃日志的list呢。建议放到子线程中处理！！ 
    List<File> fileList = ToolFileUtils.getCrashFileList(this);

//如果是要自己拿到这些文件，建议根据时间来排个序
//排序
Collections.sort(fileList, new Comparator<File>() {
    @Override
    public int compare(File file01, File file02) {
        try {
            //根据修改时间排序
            long lastModified01 = file01.lastModified();
            long lastModified02 = file02.lastModified();
            if (lastModified01 > lastModified02) {
                return -1;
            } else {
                return 1;
            }
        } catch (Exception e) {
            return 1;
        }
    }
});
  • 如何删除单个文件操作 
    //返回true表示删除成功
boolean isDelete = ToolFileUtils.deleteFile(file.getPath());
  • 如何删除所有的文件。建议放到子线程中处理！！ 
    File fileCrash = new File(ToolFileUtils.getCrashLogPath(CrashListActivity.this));
ToolFileUtils.deleteAllFiles(fileCrash);
  • 如何获取崩溃文件中的内容 
    //获取内容
String crashContent = ToolFileUtils.readFile2String(filePath);
  • 还有一些关于其他的api，如下。这个主要是方便测试同学或者产品，避免开发不承认那种偶发性崩溃bug…… 
    //拷贝文件，两个参数分别是源文件，还有目标文件
boolean copy = ToolFileUtils.copyFile(srcFile, destFile);
//分享文件。这个是调用原生的分享
CrashLibUtils.shareFile(CrashDetailsActivity.this, destFile);
//截图崩溃然后保存到相册。截图---> 创建截图存储文件路径---> 保存图片【图片质量，缩放比还有采样率压缩】
final Bitmap bitmap = ScreenShotsUtils.measureSize(this,view);
String crashPicPath = ToolFileUtils.getCrashPicPath(CrashDetailsActivity.this) + "/crash_pic_" + System.currentTimeMillis() + ".jpg";
boolean saveBitmap = CrashLibUtils.saveBitmap(CrashDetailsActivity.this, bitmap, crashPicPath);

05.异常恢复原理

  • 第一种方式，开启一个新的服务KillSelfService，用来重启本APP。 
    CrashToolUtils.reStartApp1(App.this,1000);
  • 第二种方式，使用闹钟延时，然后重启app 
    CrashToolUtils.reStartApp2(App.this,1000, MainActivity.class);
  • 第三种方式，检索获取项目中LauncherActivity，然后设置该activity的flag和component启动app 
    CrashToolUtils.reStartApp3(AppManager.getAppManager().currentActivity());
  • 关于app启动方式详细介绍

06.后续的需求说明

  • 可能不兼容
    • 该库尚未通过多进程应用程序进行测试。如果您使用这种配置进行测试，请提供反馈！
    • 如果您的应用程序初始化监听或错误活动崩溃，则有可能进入无限重启循环（在大多数情况下，库会对此进行检查，但在极少数情况下可能会发生）。
    • 修复Android P反射限制导致的Activity生命周期异常无法finish Activity问题。某些机型还是不兼容……
  • App崩溃收集信息说明
    • 收集崩溃时的基本信息
      • 进程（前台进程还是后台进程）
      • 线程（是否是 UI 线程）
      • 崩溃堆栈（具体崩溃在系统的代码，还是我们自己的代码里面）
      • 崩溃堆栈类型（Java 崩溃、Native 崩溃 or ANR）
    • 收集崩溃时的系统信息
      • 机型、系统、厂商、CPU、ABI、Linux 版本等。（寻找共性）
      • Logcat。（包括应用、系统的运行日志，其中会记录 App 运行的一些基本情况）
    • 收集崩溃时的内存信息（OOM、ANR、虚拟内存耗尽等，很多崩溃都跟内存有直接关系）
      • 系统剩余内存。（系统可用内存很小 – 低于 MemTotal 的 10%时，OOM、大量 GC、系统频繁自杀拉起等问题都非常容易出现）
      • 虚拟内存（但是很多类似OOM、tgkill 等问题都是虚拟内存不足导致的）
      • 应用使用内存（得出应用本身内存的占用大小和分布）
      • 线程数
    • 收集崩溃时的应用信息
      • 崩溃场景（崩溃发生在哪个 Activity 或 Fragment，发生在哪个业务中）
      • 关键操作路径（记录关键的用户操作路径，这对我们复现崩溃会有比较大的帮助）
      • 其他自定义信息（不同应用关心的重点不一样。例如运行时间、是否加载了补丁、是否是全新安装或升级等）

07.异常栈轨迹原理

  • Android发生异常为何崩溃
    • 一旦线程出现抛出异常，并且我们没有捕捉的情况下，JVM将调用Thread中的dispatchUncaughtException方法把异常传递给线程的未捕获异常处理器。发现最后会使用到Thread.getDefaultUncaughtExceptionHandler()
    • 既然Android遇到异常会发生崩溃，然后找一些哪里用到设置setDefaultUncaughtExceptionHandler，即可定位到RuntimeInit类。
    • 具体可以找到RuntimeInit类，然后在找到KillApplicationHandler类。首先看该类的入口main方法--->commonInit()--->，然后接着往下走，找到setDefaultUncaughtExceptionHandler代码。当出现异常是try-catch，并且在finally中直接kill杀死app操作。
    • 详细可以看：Android项目崩溃分析
  • 崩溃后异常堆栈链是如何形成的

08.部分问题反馈

  • 该异常捕获实效了是什么情况？
    • Thread.setDefaultUncaughtExceptionHandler(handler) 方法如果被多次调用的话，会以最后一次传递的 handler 为准，所以如果用了第三方的统计模块，可能会出现失灵的情况。对于这种情况，在设置默认 hander 之前，可以先通过 getDefaultUncaughtExceptionHandler() 方法获取并保留旧的 hander，然后在默认 handler 的uncaughtException 方法中调用其他 handler 的 uncaughtException 方法，保证都会收到异常信息。
  • 关于上传日志介绍
    • 设置该异常初始化后，在进入全局异常时系统就提示尽快收集信息，进程将被结束，因此不可以在此时做网络上传崩溃信息。可以在此时将错误日志写入到file文件或者sp中。
    • 比如：通过SharedPreferences将错误日志的路径写入配置文件中，在启动的时候先检测该配置文件是否有错误日志信息，如果有则读取文件，然后实现日志上传。上传完成后删除该sp文件……
  • 使用looper可以拦截崩溃和anr吗
    • 可以实现拦截UI线程的崩溃，耗时性能监控。但是也并不能够拦截所有的异常。如果在Activity的onCreate出现崩溃，导致Activity创建失败，那么就会显示黑屏。
    • fork出app进程后，在ActivityThread中，在main方法的最后调用了 Looper.loop()，在这个方法中处理主线程的任务调度，一旦执行完这个方法就意味着APP被退出了。
    • 果主线程发生了异常，就会退出循环，意味着APP崩溃，所以我们我们需要进行try-catch，避免APP退出，再启动一个 Looper.loop() 去执行主线程任务，就不会退出。
    • looper拦截崩溃或者anr，存在一个巨大的问题，就是按钮点不动或者无反应。有可能导致出现其他问题……这个需要慎重使用

09.其他内容说明

该开源库地址：https://github.com/yangchong211/YCAndroidTool

©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 206,968评论 6赞 482
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 88,601评论 2赞 382
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 153,220评论 0赞 344
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 55,416评论 1赞 279
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 64,425评论 5赞 374
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 49,144评论 1赞 285
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,432评论 3赞 401
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 37,088评论 0赞 261
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 43,586评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,028评论 2赞 325
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,137评论 1赞 334
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,783评论 4赞 324
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,343评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,333评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,559评论 1赞 262
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,595评论 2赞 355
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,901评论 2赞 345