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

愿君学长松,慎勿作桃李。这篇文章主要讲述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.    
  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按钮,显示:

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

文章图片

好,现在来修复这个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.    
  12. }   
然后,在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,

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

文章图片

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


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


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

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





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

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

文章图片
 

按钮已经替换了,这里我已经点击了按钮,所以上方文本内容也提示修复成功。
 
(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.            
  12. }   
开启了混淆的话,就要设置bug版本release包的mapping文件,以保证两次映射一致。 
 
同样,右侧gradle,点击tinkerPatchRelease。
我这次Gradle任务进行了好几分钟,当时还以为是出错了,后来看了一下下图,
Android热修复之微信Tinker使用初探

文章图片

因为我是第一次打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使用初探】 
 






    推荐阅读