15 Star 43 Fork 7

egg90 / QuickPatch

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.md 4.97 KB
一键复制 编辑 原始数据 按行查看 历史

QuickPatch

项目介绍

年轻人的第一个Android插桩热修复框架

基于函数插桩,兼容性好(Android版本升级不需要做修改),支持热更新无需重启app,参考了美团的Robust插桩热修复框架,精简了很多实现细节,代码可读性高

一句话原理

简单地讲,就是通过编译时在每个函数的头部插入一个if判断和一个proxy代理,就可以在运行时动态替换实现,无需重启。代码如下:

protected void onCreate(Bundle savedInstanceState) {
    if (_QPatchStub != null) {
        // _QPatchStub.proxy() will check method existance and call it
        MethodProxyResult proxyResult = _QPatchStub.proxy(this, "onCreate", "(Landroid/os/Bundle;)V", new Object[]{savedInstanceState});
        if (proxyResult.isPatched) {
            return;
        }
    }
    // origin implementation below
    super.onCreate(savedInstanceState);
    // ...
}

设计思路

  • QuickPatch和美团Robust的区别是,Robust的编译和dex阶段分别使用ASM和Smali做了处理,QuickPatch仅在gradle编译java到class阶段使用Javassist处理,逻辑简单
  • 不支持自动生成dex补丁(复杂度高,代码可读性差),所以需要手动生成补丁,但是提供了补丁类模版,写起来很方便
  • 对于super的处理使用native调用CallNonVirtual##TYPE##Method()系列方法实现
  • 计划支持构造函数和增加成员函数的热修复
  • 可能计划支持非Android的纯Java代码的热修复

DEMO

demo

使用说明

  • 打开app/build.gradle中的一行apply plugin: 'quickpatch.gradleplugin'
  • 然后使用AndroidStudio或者./gradlew执行下面任务:
./gradlew gradleplugin:uploadArchives # 编译插桩插件
./gradlew app:installDebug # 使用插件编译app代码并插桩
  • 为了方便点击app内的Enable Patch按钮可以模拟补丁加载效果,实际上是使用原本的ClassLoader加载了apk内打包好的的QPatch类
  • 同包名下后缀是_QPatch的类是补丁类,如MainActivity类的补丁类对应名字是MainActivity_QPatch
  • 接下来框架代码会使用一个新的ClassLoader加载dex,然后反射识别并查找相应的函数是否存在,如果存在则新的函数里面的逻辑会被调用
  • 补丁文件名一般是patch.dex, 生成dex需要手动使用命令,比如dx --dex --output=patch.dex MainActivity_QPatch.class
  • 补丁文件需要手动放置到sd卡下,比如adb push patch.dex /sdcard/
  • 然后点击app内的Enable Patch按钮即可实时加载补丁,看到pid不会有变化

性能优化思路

  1. 减少没有patch的时候所有函数调用损耗
  2. 减少有patch时,但没有走到patch涉及到的类时的损耗
  3. 减少有patch时,走到patch类,但是没走到patch函数时的损耗
  4. 减少有patch时,走到patch类,并走到patch函数时的损耗
  5. 优化patch函数内不包含反射,和包含native反射或java反射的这三种情况

Task list

  • 使用ASM或Javassist插桩哪个更方便?分场景使用gradle或者脚本执行 -- 使用Javassist,暂时使用gradle插件
  • 是整个apk范围使用还是只有jar类库范围,两种使用场景 -- 暂时apk范围,在class时候全部搞定
  • 桌面jvm动态加载class文件、dalvik动态加载dex文件 -- 暂时只考虑Android App
  • super的处理问题 -- 暂时使用native的CallNonVirtualMethod()系列方法
  • multidex问题 -- 估计没问题
  • ClassLoader的preverify问题 -- 插桩热修复 没这个问题了
  • ClassLoader类加载和类卸载问题,是否存在OOM?-- 插桩热修复 没这个问题了
  • 需要热修复的部分代码的Annotation标记 -- 暂时不实现,为了简单手动编写QPatch类的相应代码
  • 构造函数支持热修复
  • 支持增加成员变量
  • 支持static函数热修复 -- TODO
  • 支持增加函数 -- 直接在QPatch里手动调用新的函数即可
  • 基类和子类是均需要增加Object[]作为成员变量的问题 -- 需要,而且均为public标志的可以同名
  • 混淆可能带来的name mapping问题 -- TODO: 混淆前就确定类名/函数名/函数签名,但是调用的时候需要考虑用反射
  • 类的动态加载带来的安全问题 -- TODO
  • apk/jar原始代码的完整性问题,版本控制问题 -- TODO
  • 热修复包的来源验证问题 -- TODO
  • method id, return value, 反射性能问题 -- TODO优化
  • 是否支持热启动并动态替换? -- 支持
  • 是否支持多进程? -- TODO
  • 其他安全问题(版本号对应补丁、hash校验、补丁加载的安全问题)?— TODO
  • 多android、多机型的兼容性和如何测试的问题 -- TODO 需要找办法测试
  • 崩溃率和修复率如何统计 -- TODO
  • lambda的语法糖问题?内部类支持? -- TODO
  • 使用application做初始化,或者用static块确保加载(block住启动,是否影响性能)--
  • 范型问题,需要测试 -- TODO
Android
1
https://gitee.com/egg90/QuickPatch.git
git@gitee.com:egg90/QuickPatch.git
egg90
QuickPatch
QuickPatch
master

搜索帮助