上一篇文章讲到Tinker热修复框架的接入教程:Android热更新:微信Tinker框架的接入与测试
这一篇主要是带给大家,在使用Tinker热修复的时候,进行多渠道打包的一种解决方案。
相信大家看到标题就知道,这里要讲的就是美团带来的 新一代开源Android渠道包生成工具Walle
-
至于为什么选择Walle,我给大家看一张截图,如下:
Walle的选择 -
下面进入正题,以下截图和代码是基于上一篇文章的demo,看这里
一、接入Walle(文末有 Demo 的 Github 链接)
步骤一:项目的 build.gradle 文件
在 build.gradle 文件中添加Walle Gradle插件的依赖,classpath 'com.meituan.android.walle:plugin:1.1.2'
如下图:
步骤二:app的build.gradle 文件
1.在当前App的 build.gradle 文件中apply这个插件,并添加上用于读取渠道号的AAR;
apply plugin: 'walle'
dependencies {
compile 'com.meituan.android.walle:library:1.1.2'//walle
}
2.配置插件;
walle {
// 指定渠道包的输出路径
apkOutputFolder = new File("${project.buildDir}/outputs/channels");
// 定制渠道包的APK的文件名称
apkFileNameFormat = '${appName}-${packageName}-${channel}-${buildType}-v${versionName}-${versionCode}-${buildTime}.apk';
// 渠道配置文件
channelFile = new File("${project.getProjectDir()}/channel.txt")
}
配置项具体解释:
- apkOutputFolder:指定渠道包的输出路径, 默认值为
new File("${project.buildDir}/outputs/apk")
- apkFileNameFormat:定制渠道包的APK的文件名称, 默认值为
'${appName}-${buildType}-${channel}.apk'
可使用以下变量:
projectName - 项目名字
appName - App模块名字
packageName - applicationId (App包名packageName)
buildType - buildType (release/debug等)
channel - channel名称 (对应渠道打包中的渠道名字)
versionName - versionName (显示用的版本号)
versionCode - versionCode (内部版本号)
buildTime - buildTime (编译构建日期时间)
fileSHA1 - fileSHA1 (最终APK文件的SHA1哈希值)
flavorName - 编译构建 productFlavors 名
-
channelFile:包含渠道配置信息的文件路径。 具体内容格式详见下图,支持使用#号添加注释。
Demo这里需要打21个渠道包:
channel.txt
build.gradle 文件添加的内容,如下图:
App的build.gradle
步骤三:获取渠道信息
在需要渠道等信息时可以通过这行代码进行获取:
String channel = WalleChannelReader.getChannel(this.getApplicationContext());
如下图所示:
获取渠道信息
至此,Walle的接入工作基本完成,关于Walle的更多用法,可以移步到 这里参考
二、生成渠道包
生成渠道包的方式是和assemble${variantName}Channels
指令结合,渠道包的生成目录默认存放在 build/outputs/apk/
,也可以通过walle
闭包中的apkOutputFolder
参数来指定输出目录,下面截图带你回顾一下demo指定的输出目录:
生成渠道包
直接在Android Studio 下面的Terminal 窗口敲入如下命令,回车:
./gradlew clean assembleReleaseChannels
这里有一点需要注意,就是Terminal的当前目录是否是你的项目的根目录,如下图所示:
这里,在执行上面的命令之前,outputs文件夹的界面是如下的:
outputs
执行成功后,Terminal窗口会显示如下信息,签名耗时539毫秒,下面的19.181秒是包含了编译打包的总时间:
Terminal
最后我们可以在outputs文件夹里找到我们需要的21个渠道包,这里的渠道包就可以发布到各个应用平台上去,如下所示:
outputs
三、使用Tinker热修复各个渠道包
其实这里的操作跟上一篇文章Android热更新:微信Tinker框架的接入与测试介绍的第二步,测试Tinker的操作基本一样,相信读者通过我上一篇文章的介绍,可以轻而易举地打出补丁包。不过,为了方便,我还是带大家走一遍吧:
步骤一:修改基础包配置
通过上面步骤生成各个渠道包的同时,在build文件夹下,Tinker同样会给我们打出基础包,相信细心的读者在上一张截图里就会发现,bakApk文件夹里即是基础包相关的文件,同样,我们需要将这文件夹里的三个文件的名称填写到 app 的 build.gradle 类的 ext 这里,sync一下,(这里生成的基础安装包和 R文件以及release版本的mapping文件一定要自己保存好,因为每次打补丁包都需要用到这些文件作为基础文件,别弄丢了),如下图:
build.gradle步骤二:修复bug
修改项目的bug,demo这里只是增加一个textview控件作为热修复测试,如下图:
修复bug测试
步骤三:打补丁包
1.点开 Android Studio的Gradle 界面,如下,双击 tinkerPatchRelease ,如下:
Gradle Tinker
2.紧接着,Tinker 在build 文件夹下的 outputs 文件夹里面会生成我们需要的补丁文件,patch_signed_7zip.apk 就是我们所要的补丁包,如下:
patch_signed_7zip.apk
当然,如果你想了解更多关于输出文件的情况,可以点开Tinker Wiki 的 输出文件详解。
步骤四:将补丁包拷贝到手机sdcard中测试
将步骤三生成的 tinkerPatch 文件夹下面的 patch_signed_7zip.apk 文件,拷贝出来,改成你的 MainActivity中加载的文件名字,demo这里叫TinkerPatch,将其拷贝到手机的sdcard中的myTinkerDemo 文件夹下,没有这个文件夹你就自己手动新建一个,下图带你回顾一下 MainActivity 的设置:
注意此处,测试和发布版本的不同:发布版本的补丁文件一般是通过网络下载下来,存放到sdcard中,再加载。
MainActivity步骤五:加载补丁
点击主页的加载补丁按钮,没加载之前如下界面,里面显示了当前app的渠道信息:
发现新bug
点击加载补丁之后,锁屏或者杀死进程,再次进入demo,补丁已经加载出来,在渠道信息下面增加了一个文本,标识新bug已修复。如下:
新bug已修复
小结,我们只需要打一个补丁包出来,就可以热修复所有应用渠道上面的bug。
后续
感谢美团点评技术团队
Walle Github
关于微信Tinker框架的接入
参考这篇文章 Android热更新:微信Tinker框架的接入与测试
关于release版本的混淆
可以参考这篇文章 5分钟搞定android混淆
关于release版本的加固
先加固没签名的包,然后用buildtool中的apksigner签名(有同学反馈24不可以,25.0.0就可以了),然后用walle注入渠道。可以参考这里 支持Android7.0 Signature V2 Scheme 多渠道打包,并解决类似360加固后获取不到渠道信息 - 渠道统计失败的问题
Demo 源码下载
TinkerWithWalleDemo 的 Github 下载地址
网友评论
> old apk E:\TinkerWithWalleDemo\app\build\bakApk/app-release-0425-16-49-12.apk is not exist, you must set the correct old apk value!,运行你的demo,可以正常打包,但是打patch包的时候就出问题了,报了这个错