mPaas-Android DexPatch介绍以及常见问题排查

本文涉及的产品
日志服务 SLS,月写入数据量 50GB 1个月
mPaaS订阅基础套餐,标准版 3个月
简介: 为了解决Native模块上线后的问题,mPaas 提供了热修复功能,实现不发布客户端apk场景下的热修复。目前Android端热修复主要包括andfix和dexpatch,考虑到andfix的版本兼容性,目前主要推荐使用DexPatch。DexPatch修复原理比较简单,就是在启动后通过RPC拉取当前需要下发的jar包地址,然后通过独立进程去下载jar包文件,下载完成后保存。在二次启动的时候hook系统的classLoader,修改DexPathList, 在其数组的最前面加入一个有修改过的class的dex文件,使其拦截住数组后面的dex文件中同名的class的加载。


一 方案介绍

为了解决Native模块上线后的问题,mPaas 提供了热修复功能,实现不发布客户端apk场景下的热修复。目前Android端热修复主要包括andfix和dexpatch,考虑到andfix的版本兼容性,目前主要推荐使用DexPatch。

DexPatch修复原理比较简单,就是在启动后通过RPC拉取当前需要下发的jar包地址,然后通过独立进程去下载jar包文件,下载完成后保存。在二次启动的时候hook系统的classLoader,修改DexPathList, 在其数组的最前面加入一个有修改过的class的dex文件,使其拦截住数组后面的dex文件中同名的class的加载。如下图所示,classloader就会优先加载Patch.dex中的Ding.class,而忽略Classes.dex中的Ding.class, 达到了替换的效果。

基于这样的原理,DexPatch具有以下特征:

  1. 支持范围上:是基于类级别的替换,所以只支持Java模块的patch,不支持非Java模块的patch,比如so模块
  2. 兼容性上:由于是代理了系统的ClassLoader,使用的黑科技较少,所以整体方案兼容性较好
  3. 生效时效性上:只能在下载patch后重启后才能生效,不支持实时生效
  4. 成功率上:由于下载是使用的独立进程,减少了启动阶段主进程闪退对patch下载的影响,提升了下载的成功比例

二 使用介绍

以下介绍下在mPaas下使用DexPatch模块的主要步骤以及问题排查思路,方便开发者日常开发。

1. 触发patch拉取

启动阶段调用MPHotpatch.init(), 主要触发Patch信息的RPC请求,如果命中发布Patch发布规则,RPC会返回Patch的jar包下载地址,客户端去触发下载,下载后保存在客户端私有目录/data/user/0/包名/dexpatch/patch/ 下。

2. 代码操作演示

以组件化模式接入为例,介绍下Patch发布的主要流程。

1. 代码改动前

需要保存改动前的构建产物,方便后续做Patch生成,地址在:build/intermediates/bundle/xxxx-raw.jar


2. 代码改动后

重新编译,保存构建产物,产物地址:build/intermediates/bundle/xxxx-raw.jar


3. 生成白名单配置

主要用于热修复包时用于指定修复的类,配置文件为 .txt 格式,该配置文件应包含并按顺序包含以下信息:

需要 Patch 的类。以 L 开头,后跟以混淆后真实类名。如果多个类,每行只可写一个。 示例:Lxxx.xxx.clazzX 设置 Patch 类型。为 dexpatch。 示例:PatchType: dexpatch

设置是否是静态 Bundle。默认为 false,如果是静态链接的 Bundle,需要显式设置为 true。 示例:HostDex: true。目前mPaas客户端的模块一般都在静态链接里,一般写true。


4. 查看签名

生成patch需要用到项目的打包秘钥,需要提前准备好,可以在打包脚步下找到对应的配置


5. 生成patch

① 通过mPaas自带的ide工具,点击热修复,进入修复页面。


② 按照页面提示,填入之前准备的修复前和修复后的jar包地址,还有白名单配置文件,勾选dexPatch,进入到下一步


③ 下一步主要选择打包的配置文件,最近点击完成生成patch文件


6. 生成patch产物

生成patch产物如下:


查看产物,可以使用dex2jar工具反解diff.dex文件,用jd-gui文件查看反解产物是否符合预期


反解后可以看到修改的模块:


7. 上传发布

① 选择上一步的产物jar包进行上传

② 上传后可以通过白名单进行发布,验证patch的稳定性


8. 验证下载

白名单发布后,启动客户端,搜索关键字:DynamicRelease,可以看到在tool进程有触发下载的日志打出。这里需要说明的是,这里触发patch的下载是在tool进程,不在主进程的主要原因是怕由于主进程由于启动导致重复闪退,导致patch不能下载成功,单独在tool进程实现下载,尽量提高patch的下载成功比例。


然后去下载目录查看,是否下载保存成功,下载目录在:/data/user/0/包名/dexpatch/patch/20201023110012@20201023110012.jar


9. 杀进程启动

确认下载保存成功后,杀掉App,重启查看是否生效,重启可以搜索关键字:DexPatchManager,查看patch生效的日志,日志会打印当前是否存在patch以及patch是否加载的日志。

同时我们也可以就实际业务场景进行验证,查看是否生效。


三 常见问题

1. aar模式集成后patch没生效

aar模式集成的时候,需要继承框架的QuinoxlessApplication,指定Application为框架的实现类才能实现dexpatch的加载。QuinoxlessApplication内主要封装了dexpatch模块的初始化和加载。

2. 使用加固后不生效

需要使用加固前的apk生成patch,不能用加固后的包生成patch。 然后还需要验证在不同加固厂商下的兼容表现。

3. 使用热修复后,和 RPC 有关的调用发生 apache http 相关的 crash。

现象:使用patch后, rpcService获取为空。

请使用 Android 官网上的方式引入 apache http client,禁止使用导入 jar 包或者 gradle implementation/compile 的方式导入 http client,否则会引起 classloader 加载类混乱。

建议方式:

<uses-library android:name="org.apache.http.legacy" android:required="false"/>


如果直接引入会导致apache 相关的类进入到 apk 里面去,热修复的时候 classloader 加载的时候因为有和系统重复的类,所以出问题了。

目录
相关文章
|
6月前
|
JavaScript Java Maven
云效产品使用常见问题之android sdk 构建出aar后,上传到私有maven仓库失败如何解决
云效作为一款全面覆盖研发全生命周期管理的云端效能平台,致力于帮助企业实现高效协同、敏捷研发和持续交付。本合集收集整理了用户在使用云效过程中遇到的常见问题,问题涉及项目创建与管理、需求规划与迭代、代码托管与版本控制、自动化测试、持续集成与发布等方面。
|
6月前
|
敏捷开发 Java 机器人
云效产品使用常见问题之打包后的Android应用获取下载地址失败如何解决
云效作为一款全面覆盖研发全生命周期管理的云端效能平台,致力于帮助企业实现高效协同、敏捷研发和持续交付。本合集收集整理了用户在使用云效过程中遇到的常见问题,问题涉及项目创建与管理、需求规划与迭代、代码托管与版本控制、自动化测试、持续集成与发布等方面。
|
6月前
|
移动开发 监控 测试技术
mPaas常见问题之针对某个机器做强制升级如何解决
mPaaS(移动平台即服务,Mobile Platform as a Service)是阿里巴巴集团提供的一套移动开发解决方案,它包含了一系列移动开发、测试、监控和运营的工具和服务。以下是mPaaS常见问题的汇总,旨在帮助开发者和企业用户解决在使用mPaaS产品过程中遇到的各种挑战
107 0
|
6月前
|
XML 移动开发 监控
mPaaS常见问题之这边真机调试和真机预览都会报 {"stats"如何解决
mPaaS(移动平台即服务,Mobile Platform as a Service)是阿里巴巴集团提供的一套移动开发解决方案,它包含了一系列移动开发、测试、监控和运营的工具和服务。以下是mPaaS常见问题的汇总,旨在帮助开发者和企业用户解决在使用mPaaS产品过程中遇到的各种挑战
123 0
|
6月前
|
移动开发 前端开发 Android开发
mPaaS 常见问题之移动开发平台 mpaas的H5 前端 Kylin 框架引入vant后包特别大如何解决
mPaaS(移动平台即服务,Mobile Platform as a Service)是阿里巴巴集团提供的一套移动开发解决方案,它包含了一系列移动开发、测试、监控和运营的工具和服务。以下是mPaaS常见问题的汇总,旨在帮助开发者和企业用户解决在使用mPaaS产品过程中遇到的各种挑战
244 0
|
6月前
|
Web App开发 移动开发 小程序
mPaaS常见问题之安装之后SDK管理器中是空的如何解决
mPaaS(移动平台即服务,Mobile Platform as a Service)是阿里巴巴集团提供的一套移动开发解决方案,它包含了一系列移动开发、测试、监控和运营的工具和服务。以下是mPaaS常见问题的汇总,旨在帮助开发者和企业用户解决在使用mPaaS产品过程中遇到的各种挑战
|
6月前
|
移动开发 监控 安全
mPaaS常见问题之Android集成dexPatch热修复运行时候无法正常进行热更新如何解决
mPaaS(移动平台即服务,Mobile Platform as a Service)是阿里巴巴集团提供的一套移动开发解决方案,它包含了一系列移动开发、测试、监控和运营的工具和服务。以下是mPaaS常见问题的汇总,旨在帮助开发者和企业用户解决在使用mPaaS产品过程中遇到的各种挑战
109 0
|
6月前
|
Web App开发 移动开发 小程序
mPaaS常见问题之音视频通话使多人视频如何解决
mPaaS(移动平台即服务,Mobile Platform as a Service)是阿里巴巴集团提供的一套移动开发解决方案,它包含了一系列移动开发、测试、监控和运营的工具和服务。以下是mPaaS常见问题的汇总,旨在帮助开发者和企业用户解决在使用mPaaS产品过程中遇到的各种挑战
|
6月前
|
移动开发 监控 小程序
mPaaS常见问题之消息推送mps 私有化如何解决
mPaaS(移动平台即服务,Mobile Platform as a Service)是阿里巴巴集团提供的一套移动开发解决方案,它包含了一系列移动开发、测试、监控和运营的工具和服务。以下是mPaaS常见问题的汇总,旨在帮助开发者和企业用户解决在使用mPaaS产品过程中遇到的各种挑战
103 0
|
6月前
|
存储 移动开发 AndFix
mPaaS常见问题之pushWindow打开url白屏过一会提示网络超时如何解决
mPaaS(移动平台即服务,Mobile Platform as a Service)是阿里巴巴集团提供的一套移动开发解决方案,它包含了一系列移动开发、测试、监控和运营的工具和服务。以下是mPaaS常见问题的汇总,旨在帮助开发者和企业用户解决在使用mPaaS产品过程中遇到的各种挑战
111 0
下一篇
无影云桌面