Android 美团Robust热更新 使用入门

Android热更新方案Robust

 

---

相信不少人都认识了解过 热修复、热更新、热补丁(对于这个技术也没有特别标准的一种叫法，下面我统一叫热更新)，以后的一年里，各类热更新方案如雨后春笋般出现，比较耳熟能详的就有Nuwa、Tinker、Andfix 和 Dexposed 等等，他们之间的区别以及优缺点就不在这里讨论了，鉴于它们的实际使用和局限性，美团的开发团队就脑洞大开了。

就去年 Google 高调发布了 Android Studio 2.0，其中最重要的新特性Instant Run，实现了对代码修改的实时生效（热插拔）。美团开发团队在了解 Instant Run 原理以后，实现了一个兼容性更强的热更新方案，这就是产品化的hotpatch框架—–Robust

对于 Robust 的原理咱们后面的文章再讨论，本篇只针对想快速上手的入门讲解，想先了解 Robust 的原理以及技术核心的同窗请移步到

Android热更新方案Robust

Android热更新方案Robust开源，新增自动化补丁工具

美团 Robust 的 github demo 地址

---

 

使用场景

 

先介绍一下 Robust 的适用场景，与以往你们认识的热更新同样，对线上事故很难有即时生效的解决方式，每次发版都如临深渊如履薄冰，毕竟就算再完善的开发测试流程也没法保证不会将 Bug 带到线上，特别是新 app 刚上线，一个bug不仅是影响到几个几十个用户，一些创业性app的崩溃或者bug可能直接致使用户卸载和永不使用。对于这种致命的又迫不得已的问题，Robust 就是时候该站出来摸摸你的头，轻声而又自信的说“别怕，你还有我”。

 

大概流程

 

1.集成了 Robust 后，生成 apk。保存期间的混淆文件 mapping.txt，以及 Robust 生成记录文件 methodMap.robust 
2.使用注解 @Modify 或者方法 RobustModify.modify() 标注须要修复的方法 
3.开启补丁插件，执行生成 apk 命令，得到补丁包 patch.jar 
4.经过推送或者接口的形式，通知 app 有补丁，须要修复 
5.加载补丁文件不须要从新启动应用

 

动手

 

首先远程依赖 Robust 的一些插件，用于辅助生成 patch.jar 的。此时咱们不须要深刻了解，只须要知道它是用来辅助的就好。在项目最外层的 build.gradle 添加两处插件

classpath ‘com.meituan.robust:gradle-plugin:0.3.3’ 
classpath ‘com.meituan.robust:auto-patch-plugin:0.3.3’

而后在项目的 build.gradle 添加

//apply plugin: ‘auto-patch-plugin’ 
apply plugin: ‘robust’

compile ‘com.meituan.robust:robust:0.3.3’

此时，还没完成第一步呢，别急，须要手动 copy 一份 robust.xml 的配置文件到app的目录下，该文件各个配置注释的很清楚，若没特殊要求，不须要修改 

好了，准备工做完成。有了这些东西，待咱们须要修复的时候就能够一键生成补丁 patch.jar 了。但别急，你还不知道怎么加载补丁呢…

先解释一下，如上图标注所说了，在生成 apk 的时候使用 apply plugin:’robust’，该插件会生成打补丁时须要的方法记录文件 methodMap.robust，该文件在打补丁的时候用来区别到底哪些方法须要被修复，因此有它才能打补丁。而上文所说的还有 mapping.txt 文件，该文件列出了原始的类，方法和字段名与混淆后代码间的映射。这个文件很重要，能够用它来翻译被混淆的代码。但也不是必须的，若是不须要混淆，能够不保留。这两个文件在生成apk后，分别在 
build/outputs/robust/methodsMap.robust，build/outputs/mapping/mapping.txt(须要开启混淆后才会出现)，咱们须要本身分别拷贝到 app/robust 下，在 app 目录新建个叫 robust 的文件夹，把这两个文件放进去就 ok 了。

此时，完成了第二步了。咱们获得了 apk ，mapping.txt，methodMap.robust ，有了它们咱们再继续生成补丁 patch.jar。然而我踩到过的坑是，没有签名文件同样能够完成上述步骤，但在安装apk的时候会被告知该 apk 已损坏，因此按普通签名那样加上签名文件就好了。

 

制做补丁并使用

 

咱们新建的工程很简单，只有2个button，一个用来加载补丁，一个用来跳转。如图，首页和没加载补丁时跳转的页面。刚才咱们说，要怎么使用补丁文件，看下面加载补丁的按钮事件里面，看到了没，就那么一句话就能实现加载补丁了。

 

new PatchExecutor(上下文我懂，xxx，callback我也懂).start()

中间的xxx是个什么东西啊，还须要本身写？带着这个疑问去思考一下，就不难发现，要加载补丁确定得知道 patch.jar 放在哪啊是吧，打开看一眼(不要惧怕只有不多代码)，为了方便展现，就把不过重要的三个方法缩起来了，copy 方法是普通文件拷贝的IO流，verifyPatch 方法原本是验证补丁有效性的，后来发现对普通使用者没有那么高要求，就改为了备份补丁的回调了，ensurePatchExist 方法就检测补丁存在与否，好了大概知道其它的方法就详细介绍下主要方法 fetchPatchList，回顾一下上面的xxx再联想到这里吧，既然咱们要加载补丁，那么咱们得知道补丁在哪啊，这个方法就是把补丁找出来给上面那个谁用的。因此说，补丁的位置你能够根据拉取下来保存的位置来找出来，把路径给 setLocalPath 就好。再有就 setPatchesInfoImplClassFullName 的包名须要和 robust.xml 配置的同样

咱们所须要作的跳转后效果是修改一下textview显示内容而已，那么在被修改的页面须要怎么标注被修改的方法呢，就像这样，先科普一下，在 robust 的注意事项里面已经提到过，修改方法和字段会有一些局限性，那是由于 android 自己ProGuard的内联、优化致使的。因此要绕过这个自己的问题，要必须遵循一些规律了…之后再介绍这个。修改完这些，咱们再去 build.gradle 修改一下，开启打补丁那个，关闭生成apk那个。以后再在终端执行一遍生成apk的命令行。直到终端那里出现 auto patch end successfully(最后 build failed 是正常的，别紧张孩子)。再而后就是要把patch.jar push 到手机目录路径下啦。那些本身推送下载的请自行调试更正，确保路径正确。还有记得给应用读写内存卡的权限

既然到了这里，咱们好像全部条件都具有了啊，那么就点 LOAD PATCH 按钮看看发生什么事吧，若是看到 apply result true 那么就大功告成了。

最后来个效果图

谢谢美团开发团队的开源和贡献，还要特别感谢Robust做者之一的张梦同窗，为 Robust 挖下的坑(开玩笑哈哈哈)，咱们努力排坑只但愿能让你们更简便的使用，之后的路还很长…你们有什么建议或意见，请到 github 上面去留言。