Android热修复之微信Tinker使用初探

文章地址：Android热修复之微信Tinker使用初探

前几天，万众期待的微信团队的Android热修复框架tinker终于在GitHub上开源了。

地址：https://github.com/Tencent/tinker

官方介绍：https://my.oschina.net/shwenzhang/blog/751618

接入指南：https://github.com/Tencent/tinker/wiki/Tinker-%E6%8E%A5%E5%85%A5%E6%8C%87%E5%8D%97

今天拿下来集成使用了一下，发现md上对集成使用的过程介绍的比较精简(后来发现wiki上面倒是很详细，需要的同学可以自己去看)，这里记录一下我集成使用的过程。

一、集成

我这里直接使用的是他1.6.2版本（1.6.0-1.6.3集成与使用的应该都类似，但是1.7.0以及以后，修改比较大，配置与使用略有不同）自带的sample，导入到studio中。

二、初始化配置

首先我们需要在app/bulid.gradle中，设置tinkerId的值，很多人开始编译就报错，提示“tinkerId is not set!!!”，就是因为这个值没有设置。获取tinkerId走的

[java] view plain copy

1. def gitSha() {
2. return ‘git rev-parse --short HEAD‘.execute().text.trim()
3. }

这个方法，也就是获取git的版本号，所以要是你没有安装配置git，或者git没有加入到环境变量中，会得不到git的版本号了。知道了原理，那解决方式就自己想了，我这里就直接写死，上面这个方法直接返回固定字符串。

---------------------------------------------------------------------------

补充：关于获取Git提交版本号

[java] view plain copy

1. git rev-parse --short HEAD

这段代码主要是用来显示最近一次提交到HEAD上的记录编号（类似于“b03b0c4”的字符串。个人对git命令行了解不多，如果有知道的大神麻烦指教一下）。

所以前面说的，除了环境变量配置好git（可以在命令行输入 git --version ，显示出了版本号，便是配置成功），再把你的项目与git关联起来，并且保证有一次提交记录，才能获取到该字符串。

具体使用可以看我的另一篇文章：关于git命令“git rev-parse --short HEAD”在android studio中使用与配置的个人探究

我在使用sample时先直接写死了。正式应用到项目上时，可以根据自己的实际情况来配置该参数。

---------------------------------------------------------------------------------------------------

之后，我们会看到Manifest.xml中，SampleApplication.Java这个类报红找不到。这个并不影响，因为到时候我们在编译的时候，tinker会为我们生成SampleApplication.java这个类，而起作用的代码就是SampleApplicationLike.java类声明上面的

[java] view plain copy

1. @DefaultLifeCycle(application = "tinker.sample.android.app.SampleApplication",
2. flags = ShareConstants.TINKER_ENABLE_ALL,
3. loadVerifyFlag = false)

这段注解，我们也可以把这段注解注释了，

自定定义一个SampleApplication类继承 TinkerApplication类，然后加入无参构造方法，得到的类为：

[java] view plain copy

1. /**
2. * Created by anzyhui on 2016/9/26.
3. */
4. public class SampleApplication extends TinkerApplication {
5. public SampleApplication(){
6. super(
7. //tinkerFlags, which types is supported
8. //dex only, library only, all support
9. ShareConstants.TINKER_ENABLE_ALL,
10. // This is passed as a string so the shell application does not
11. // have a binary dependency on your ApplicationLifeCycle class.
12. "tinker.sample.android.app.SampleApplicationLike");
13. }
14. }

这些都是Tinker这边定好的规矩，咱们得照着来(第二个参数中的".app"不要忘了，也就是路径不要搞错了)，其中第一个参数表示支持修复的类型，有以下类型可以选：

[java] view plain copy

1. public static final int TINKER_DISABLE             = 0x00;
2. public static final int TINKER_DEX_MASK            = 0x01;
3. public static final int TINKER_NATIVE_LIBRARY_MASK = 0x02;
4. public static final int TINKER_RESOURCE_MASK       = 0x04;
5. public static final int TINKER_DEX_AND_LIBRARY     = TINKER_DEX_MASK | TINKER_NATIVE_LIBRARY_MASK;
6. public static final int TINKER_ENABLE_ALL          = TINKER_DEX_MASK | TINKER_NATIVE_LIBRARY_MASK | TINKER_RESOURCE_MASK;

从字面理解就知道什么意思了。

重新编译一下，一般也不会有问题，如果报类重复的异常的话，看看你是不是之前已经生成过了SampleApplication了，在\build\intermediates\classes\debug\tinker路径下对应的目录里，有的话，删掉再编译试下。

三、功能测试

（1）debug版本

先尝试debug版本

现在我们模拟打包一个出现bug的版本。

再activity_main.xml中加入俩控件：

[html] view plain copy

1. <TextView
2. android:id="@+id/tvMessage"
3. android:layout_width="wrap_content"
4. android:layout_height="wrap_content"
5. android:layout_below="@+id/showInfo"
6. android:text="一切正常"    />
7. <Button
8. android:id="@+id/btnBug"
9. android:layout_width="wrap_content"
10. android:layout_height="wrap_content"
11. android:layout_alignParentLeft="true"
12. android:layout_alignParentStart="true"
13. android:layout_below="@+id/tvMessage"
14. android:text="点击出现bug"/>

MainActivity中设置点击事件，点击btnBug时，tvMessage显示"出现bug了"文字。

打包生成apk

这时，在build/bakApk目录中，会生成一个apk和一个R.txt文件，R.txt的作用后面再讲。

apk运行至手机中，

点击点击btnBug按钮，显示：

好，现在来修复这个bug。

我们在activity_main.xml中删除该“点击出现bug”按钮，增加“点击修复bug”按钮：

（PS:也就是修改了res文件）

当然了MainActivity中的代码中，也修改了点击事件，删除了“点击出现bug”按钮的点击事件，增加了“点击修复bug”按钮的点击事件。

点击按钮后，上方文本要显示“bug已经修复了”。

代码改好后，我们需要配置一下前面提到了R.txt文件，这里面保存了每次编译得到的每个res文件的id值。

具体配置就是，在app/build.gradle的ext部分，添加oldApk（也就是出现bug的那个apk）的信息：

[java] view plain copy

1. ext {
2. //for some reason, you may want to ignore tinkerBuild, such as instant run debug build?
3. tinkerEnabled = true
4. //you should bak the following files
5. //old apk file to build patch apk
6. tinkerOldApkPath = "${bakPath}/app-debug-0927-11-47-21.apk"  //这个是你出现bug的apk完整名称，app/build/bakApk目录下
7. //proguard mapping file to build patch apk
8. tinkerApplyMappingPath = "${bakPath}/"  //暂未开启混淆，不用管
9. //resource R.txt to build patch apk, must input if there is resource changed
10. tinkerApplyResourcePath = "${bakPath}/app-debug-0927-11-47-21-R.txt"  //如果你修复了res文件，需要指定你bug版本的R.txt文件
11. }

然后，在studio的右上角，打开gradle，找到tinkerPatchDebug(我一直用的是debug签名，这个根据自己实际情况来)这个task，点击运行。就会在output目录下生成一个tinkerpatch目录，

在里面找到patch_signed_7zip.apk和patch_signed.apk，这就是我们的差分包。

因为代码中指定的差分包路径为：

[java] view plain copy

1. loadPatchButton.setOnClickListener(new View.OnClickListener() {
2. @Override
3. public void onClick(View v) {
4. TinkerInstaller.onReceiveUpgradePatch(getApplicationContext(), Environment.getExternalStorageDirectory().getAbsolutePath() + "/patch_signed_7zip.apk");
5. }
6. });

我们就直接使用patch_signed_7zip.apk，放到我们的手机根目录，再打开app，点击LOAD PATCH，

提示我们补丁加载成功，重启后生效。

这里，我们需要杀掉本进程，再进入app,才能应用补丁包修复成功。

有朋友评论说自己也加载成功但没法修复，是不是按得返回键退出（返回键退出时是activity销毁，进程还在）。

杀进程后再进入 ，应该就可以修复成功了，如果不成功，把补丁包逆向一下，看看自己修复的部分有没有在里面。

重启后，注意看界面上的按钮是不是已经被替换，

按钮已经替换了，这里我已经点击了按钮，所以上方文本内容也提示修复成功。

（2）release版本+混淆

release版本总体使用方式与的bug版本类似，

每次打出正式包时，我们应该备份好。

在打包前，修改app/build.gradle里的

[plain] view plain copy

1. /**
2. * task type, you want to bak
3. */
4. //def taskName = "debug"
5. def taskName = "release"

tastName为release，minifyEnabled设置为true，

这样release打包时才会在bakApk下生成对应的apk，R.txt以及mapping文件。

之后的打包是一样的。

打差分包（补丁）的时候，我们要做的，同样是，替换里面的属性：

[plain] view plain copy

1. ext {
2. //for some reason, you may want to ignore tinkerBuild, such as instant run debug build?
3. tinkerEnabled = true
4. //you should bak the following files
5. //old apk file to build patch apk
6. tinkerOldApkPath = "${bakPath}/app-release-0929-11-28-36.apk"
7. //proguard mapping file to build patch apk
8. tinkerApplyMappingPath = "${bakPath}/app-release-0929-11-28-36-mapping.txt"
9. //resource R.txt to build patch apk, must input if there is resource changed
10. tinkerApplyResourcePath = "${bakPath}/app-release-0929-11-28-36-R.txt"
11. }

开启了混淆的话，就要设置bug版本release包的mapping文件，以保证两次映射一致。

同样，右侧gradle，点击tinkerPatchRelease。

我这次Gradle任务进行了好几分钟，当时还以为是出错了，后来看了一下下图，

因为我是第一次打release包，所以在下载必要的jar包。

有运行慢的可以点进这里看看，是不是一样的情况。

差分包打包成功后，跟之前一样的操作，我这边测试成功没问题呢。

四、总结

之前研究过AndFix，主要是使用native方法，来修改出现bug的方法，虽然支持的系统版本也很广（2.3~7.0），但是具有一定的局限性，只能修改方法的内部实现，不支持新增方法，新增、修改成员变量等；而基于ClassLoader的各种实现，由于采用在字节码中在构造方法注入一段代码，防止被打上CLASS_ISPREVERIFIED标记，在dalvik中比较影响性能，而且支持系统也不全面，所以都不是特别的完美。而且他们都有一个缺点，不能修改资源文件。

这次Tinker的发布，打破了原有的性能问题，功能局限，实现了，支持对library、java类、res文件的修复，并且除了小部分版本的设备（wiki上说是部分三星api19版本），其他基本都可以覆盖到（yunOS另说）。相信在wx几位大神的维护下，tinker会越来越好。官方Tinker热补丁技术交流群：377388954

• 上一篇Android热修复AndFix混淆后热修复失败，无效
• 下一篇关于git命令“git rev-parse --short HEAD”在android studio中使用与配置的个人探究