DexPatch使用示例

DexPatch是以动态部署技术方案为基础，以快速解决线上故障为唯一目的的动态化方案。

简单来说，动态部署是针对apk级别的动态升级，DexPatch是针对Bundle级别的动态修复(主dex可以认为是一个Bundle)

详细介绍参照 DexPatch介绍

DexPatch与动态部署异同

版本

打包

Dexpatch需要一个ap版本作为参照，和现在的代码比对做diff。假设当前版本为1.0.0 (gradle中配置)

发布版本

如果之前发布过ap版本，可以跳过此节。假设从未发布过ap，按照如下步骤，发布1.0.0的ap

1. 进入app目录下
2. 生成基线版本 ./gradlew clean assembleDebug
3. 发布ap到仓库中 `./gradlew publish

打patch

1. 基于ap所属的版本(1.0.0)，修改代码,以firstbundle为例，将"origin"修改为"dexpatch"

   

2. 修改依赖版本，将firbundle中grddle的verion改为version = '1.0.1'

   这里也可以修改firbundle依赖的某个aar的版本。一句话，你要通过版本号告诉编译器，我这个bundle的代码变了

3. 指定参照的版本，生成dexPatch包
   ./gradlew clean assembleDebug -DapVersion=1.0.0 -DversionName=1.0.0

PS:

这里要强调一下，代码的修改要内聚。
假设A依赖B,修改时，只改A或B自身的代码，不支持修改A与B之间的接口。

部署Patch

生成的patch文件在 app/build/outputs下，检查是否存在两个文件

• 1.0.0@1.0.0.tpatch
• dexpatch-1.0.0.json

清空 /sdcard/Android/data/com.taobao.demo/cache/，并将上述两个文件push到上述路径中

demo中测试入口

主界面点开侧边栏，点击dexpatch

重启应用,Toash显示 "dexpatch",成功~

产物说明

version@version.tpatch

当前代码和参考ap(1.0.0)diff的产物，是个zip文件，解压开就是diff的代码。

patchs.json

上述代码diff的配套json，描述了本次diff的结果:

• 改动模块信息
• 比对版本
• ...

dexpatch-xxx.json

说明

客户端可以识别的接口，对打包产物包装处理过的配置

客户端并不能直接识别打包产生的 path.json 文件，需要服务端做一些包装。

Demo说明

由于demo没有服务端，所以在app/dexPatchWraper.gradle中，对patch.json内容做了一个包装，简单模拟服务端的逻辑。

简单起见，只是每次都把dexPatchVersion+1，版本号缓存在根目录下的dexPatch.verion文件中。

字段解释

包装后的产物字端如下,大部分内容直接copy自patch.json,需要关心的只有几个字端

{
  "baseVersion": "1.0.0",
  "diffBundleDex": true,
  "patches": [
    {
      "bundles": [
        {
          "dependency": [
            "com.taobao.publicBundle"
          ],
          //重要
          "dexpatchVersion": "14",
          "isMainDex": false,
          "name": "com.taobao.firstbundle",
          "pkgName": "com.taobao.firstbundle",
          "dependency":[],
          //重要
          "reset": false,
          "srcUnitTag": "6b3973d9d6592d15601017edabc8b31b",
          "unitTag": "e857557cc924f503a7304218469733a2",
          "version": "1.0.1"
        }
      ],
      //重要
      "dexPatch": true,
      "fileName": "1.0.0@1.0.0.tpatch",
      "patchVersion": "1.0.0",
      "targetVersion": "1.0.0"
    }
  ]
}