首页 > 代码库 > Android热修复之微信Tinker使用初探

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

2024-08-28 17:35:42   223人阅读

 

文章地址：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.   
  6.   
  7.     public SampleApplication(){  
  8.         super(  
  9.                 //tinkerFlags, which types is supported  
  10.                 //dex only, library only, all support  
  11.                 ShareConstants.TINKER_ENABLE_ALL,  
  12.                 // This is passed as a string so the shell application does not  
  13.                 // have a binary dependency on your ApplicationLifeCycle class.  
  14.                 "tinker.sample.android.app.SampleApplicationLike");  
  15.     }  
  16. }  
这些都是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. 

  2.     //for some reason, you may want to ignore tinkerBuild, such as instant run debug build?  
    3. 

  3.     tinkerEnabled = true  
    4. 

  4.     //you should bak the following files  
    5. 

  5.     //old apk file to build patch apk  
    6. 

  6.     tinkerOldApkPath = "${bakPath}/app-debug-0927-11-47-21.apk"  //这个是你出现bug的apk完整名称，app/build/bakApk目录下  
    7. 

  7.     //proguard mapping file to build patch apk  
    8. 

  8.     tinkerApplyMappingPath = "${bakPath}/"  //暂未开启混淆，不用管  
    9. 

  9.     //resource R.txt to build patch apk, must input if there is resource changed  
    10. 

  10.     tinkerApplyResourcePath = "${bakPath}/app-debug-0927-11-47-21-R.txt"  //如果你修复了res文件，需要指定你bug版本的R.txt文件  
    11. 

  11.   
    12. 

  12. }  
    13. 



然后，在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. 

  2.             @Override  
    3. 

  3.             public void onClick(View v) {  
    4. 

  4.                 TinkerInstaller.onReceiveUpgradePatch(getApplicationContext(), Environment.getExternalStorageDirectory().getAbsolutePath() + "/patch_signed_7zip.apk");  
    5. 

  5.             }  
    6. 

  6.         });  
    7. 



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

技术分享



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




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




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


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










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

技术分享

 



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


 


（2）release版本+混淆


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


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


 


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


 






[plain] view plain copy

 








    

  1. /**  
    2. 

  2.  * task type, you want to bak  
    3. 

  3.  */  
    4. 

  4.     //def taskName = "debug"  
    5. 

  5.     def taskName = "release"  
    6. 





tastName为release，minifyEnabled设置为true，

 


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


 


之后的打包是一样的。


 


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


 






[plain] view plain copy

 








    

  1. ext {  
    2. 

  2.     //for some reason, you may want to ignore tinkerBuild, such as instant run debug build?  
    3. 

  3.     tinkerEnabled = true  
    4. 

  4.     //you should bak the following files  
    5. 

  5.     //old apk file to build patch apk  
    6. 

  6.     tinkerOldApkPath = "${bakPath}/app-release-0929-11-28-36.apk"  
    7. 

  7.     //proguard mapping file to build patch apk  
    8. 

  8.     tinkerApplyMappingPath = "${bakPath}/app-release-0929-11-28-36-mapping.txt"  
    9. 

  9.     //resource R.txt to build patch apk, must input if there is resource changed  
    10. 

  10.     tinkerApplyResourcePath = "${bakPath}/app-release-0929-11-28-36-R.txt"  
    11. 

  11.       
    12. 

  12. }  
    13. 




开启了混淆的话，就要设置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热修复之微信Tinker使用初探






























        

            
                
                  
                
                

                    联系

                    我们