rabbit 是一个Android APM框架(工具), 它不仅可以让开发者很方便的在本地对App做性能监控, 也提供了完整的数据上报系统。目前包含的主要功能如下图:

本文将对rabbit的功能做一个简单的介绍,详细的使用文档地址: 使用文档

多图警告⚠️⚠️⚠️

功能介绍

应用测速

通过编译时代码插桩, rabbit可以非常方便的统计应用的冷启动时间与页面渲染时间。测速统计的关键时间点定义如下图:

应用启动耗时统计

在对应用主页进行配置后,rabbit可以统计出如下图所示的冷启动耗时:

页面渲染与网络请求耗时统计

与网络请求耗时结合后，rabbit可以统计出一个页面的完全渲染耗时。这里的完全渲染耗时是指:从页面create到页面拿到请求结果并刷新页面所用的时间。核心思想参考自:Android自动化页面测速在美团的实践,最终统计的页面耗时如下图所示:

慢函数检测

基于编译时代码插桩, rabbit可以准确的统计每一个函数的耗时，并筛选出慢函数。

慢函数定义为: 在主线程消耗时间超过一定阈值的函数(rabbit也支持配置检测其他线程的慢函数)。

rabbit支持分包检测慢函数:

支持查看每一个包下的慢函数列表以及每一个慢函数的堆栈:

代码扫描

通过提供给rabbit一份代码扫描列表,rabbit可以在编译时扫描出这些代码调用的位置。默认会扫描一些阻塞代码, 比如下面这种:

SharePreferences$Editor.commit()

最终扫描结果会展示如下:

点击右上角导出按钮可以把扫描结果以json的形式导出到SD卡中。

网络日志监控

rabbit可以记录网络请求日志并方便的查看返回的json数据:

卡顿日志监控

rabbit通过Choreographer来检测主线程的运行情况,并异步采集主线程堆栈来还原卡顿现场。

对于下面代码:

Thread.sleep(2000)

rabbit会获得如下的卡顿采集结果:

FPS分析

rabbit会在主线程looper运行时计算主线程FPS并实时的显示出来:

rabbit支持分页面分析FPS:

内存分析

功能类似于FPS分析,rabbit支持实时显示内存使用情况并分页面分析内存占用情况:

分页面内存统计:

异常捕获

通过设置Thread.setDefaultUncaughtExceptionHandler,rabbit可以捕获java层异常并展示出来:

内存泄漏捕获

rabbit集成了leakcanary 2.0。

apk包分析

rabbit提供了一个可执行的jar包, 它可以准确的分析出apk中的大图、重复文件、apk包大小与内容组成。核心思路参考自Matrix APK包分析。

运行方式为:

java -jar apk-analyzer.jar apk-analyzer-config.json

apk-analyzer-config.json用来配置待分析的apk路径以及mapping文件位置等信息:

{
    "apkPath":"xxxx/app-Release.apk",
    "methodGroup":[{
        "name":"xxx",
        "package":"com.xxx.xx"
    }],
    "classMappingFilePath":"xxx/xxx.txt",
    "maxImageSizeKB":30
}

最终分析结果会输出到一个json文件中:

apk-analyzer-result.json

{
    "AppInfo": {
        "versionCode": "1004000",
        "versionName": "1.4.0",
        "appSize": "21.51 MB"
    },
    "BigImageRes": [
        {
            "name": "assets/flutter_assets/images/icons/xxLogo.png",
            "size": "76.73 KB"
        }
        ...
        ...
    ],
    "ApkCompose": [
        {
            "type": "so",
            "totalSizeStr": "8.05 MB"
        },
        {
            "type": "dex",
            "totalSizeStr": "6.54 MB"
        }
        ...
        ...
    ],
    "DuplicatedFile": [
        {
            "files": [
                "res/drawable-xxhdpi-v4/bg_home_water_ripple.webp",
                "res/drawable-xxhdpi-v4/bg_keyboard_shadow_line.webp"
            ],
            "fileSize": "",
            "md5Value": "d41d8cd98f00b204e9800998ecf8427e"
        }
        ....
    ],
    "MethodCount": {
        "total-count": 127732,
        "com.xxx.xx": 14800,
        "other-pkg": 112932
    }
}

上报APK分析结果

需要在apk-analyzer-config.json中配置上报路径:

{
    "apkPath":"xxxx/app-Release.apk",
    ...
    "uploadPath":"xxxxxx/upload"
}

上报的数据格式与rabbit的基本上报数据格式保证一致:

数据上报

rabbit目前支持上报大部分检测数据。通过一些简单的配置就可以把检测数据上报到后台。rabbit数据上报的基本格式如下:

{
    "device_info_str": "{....}",
    "info_str": "{...}",
    "time": 1577775888933,
    "type": "fps_info",
    "use_time": 19
}

type : 上报的数据类型
device_info_str : 设备信息, 格式json字符串
info_str: 该类型的数据的具体内容, 格式为json字符串
use_time: 应用当前使用时长

rabbit提供了上报回调,可以通过这个回调很方便的来实现自定义的上报逻辑:

rabbitConfig.reportConfig.dataReportListener = object :RabbitReportConfig.DataReportListener{
    override fun onPrepareReportData(data: Any, currentUseTime: Long) {
        //接入自己的上报逻辑
    }
}