本文是SDKHotfix相关的SDK热更系列文章中的一篇,以下为项目及系列文章相关链接:
SDKHotfix整体介绍:https://blog.bihe0832.com/sdk_hotfix_project.html
SDKHotfix对应github地址:https://github.com/bihe0832/SDKHoxFix
这篇文章主要介绍一下SDK热更中的gradle插件,该插件实现了自动在代码中插桩以及生成补丁包。文中提到所有代码地址:SDKHotfix中插桩及补丁生成对应gradle插件的github地址:https://github.com/bihe0832/SDKHoxFix/tree/master/BuildPatch
该插件是一个基于groovy开发的gradle的插件,为了方便理解整个项目没有把他集成到SDK的构建中,而是通过shell脚本一步一步完成插桩和生成补丁。开发者可以根据个人兴趣整合到项目gradle中或者保持隔离。已经对插件代码填了一部分注释因此不会专门详细介绍具体实现,这里重点介绍一下插件定义的几个变量。
HashSet
项目中所有不可以被热更的类列表,可以是具体类名,也可以是包名
int oldSDKVersion
被热更的SDK的版本号,或者说有问题的SDK的版本号,在生成补丁时通过该版本号可以获取到老版本SDK所有文件的md5值
int newSDKVersion
热更后SDK的版本号,也就是SDK在热更以后升级到的版本
String patchCoreClass
SDK热更中保存SDK的版本、热更测试函数的核心类,这个类在生成补丁包时一定会保留
String patchPileClass
SDK插桩使用的类的类名,这个类在生成SDK或者补丁的时候一定会被删除
在SDK所有需要热更的代码中插桩是所有使用mutlidex的热更方案的基本原理。通过代码插桩的方式可以解决应用启动dex预检验时因补丁类不在相同dex的报错。详细的原理内容可以参照Qzone的原理介绍文章:安卓App热补丁动态修复技术介绍
在SDK的源码中保留插桩类com.bihe0832.hotfix.Fix
,保证SDK工程正常使用不出错
自动构建时完成对所有需要插桩类的默认构造函数插桩
自动构建完成对所有需要插桩的类插桩后删除插桩类com.bihe0832.hotfix.Fix
自动构建的过程中计算生成所有该版本对应每个class文件的md5,例如3_hash.txt
自动构建相关代码(具体代码参考根目录build.sh):
cd $localPath/MD5 && ./gradlew processJarAndGetJarHash
插件相关代码
BuildPatch
项目BuildPatchPlugin.groovy
中taskprocessJarAndGetJarHash
对应的内容。
自动构建完成所有代码的插桩以及对应文件及其md5
根据版本号获取到历史版本保存对应版本所有文件及其hash值的文件
获取自动构建目录下所有的文件列表,逐个文件与历史版本中的文件对比md5,如果一致则删除,不一致则保留
所有文件对比完成以后,清除空目录,将剩余文件打包为jar,并转为dex
由于补丁信息类com.bihe0832.hotfix.FixInfo
中保存了SDK的补丁的版本号等信息,因此该文件一定保留不会删除
自动构建相关代码(具体代码参考根目录build.sh):
cd $localPath/MD5 && ./gradlew buildPatch
deleteempty
jar cvf $localPath/MD5/bin/temp/jar/bihe0832_patch.jar *
cp -r $localPath/MD5/bin/temp/jar/bihe0832_patch.jar $localPath/MD5/bin/bihe0832_patch.jar
$ANDROID_HOME/build-tools/23.0.2/dx --dex --output=$localPath/MD5/bin/bihe0832_patch_dex.jar $localPath/MD5/bin/temp/jar/bihe0832_patch.jar
插件相关代码
BuildPatch
项目BuildPatchPlugin.groovy
中taskbuildPatch
对应的内容。