热修复框架 Tinker 最完整讲解（02）——加入 Walle 多渠道打包

发布日期: 2017-07-09

作者: wildma

文章字数: 1.5k

阅读时长: 5 分

阅读次数:

前言

上一篇文章热修复框架Tinker最完整讲解（01）——集成之路已经介绍我们的项目渠道包有20个，并且我们多渠道打包是采用productFlavors实现的。但是这种多渠道打包会造成20个渠道包的热更新就需要20个补丁，这样肯定是不合理的。那怎样才能实现20个渠道包只需要一个补丁包呢？Tinker官方也说了，推荐我们多渠道打包使用Walle，这样就能实现多个渠道包只使用一个补丁包了！

一、什么是Walle？

Walle（瓦力）：Android Signature V2 Scheme签名下的新一代渠道包打包神器。
瓦力通过在Apk中的APK Signature Block区块添加自定义的渠道信息来生成渠道包，从而提高了渠道包生成效率，可以作为单机工具来使用，也可以部署在HTTP服务器上来实时处理渠道包Apk的升级网络请求。
——介绍来自Walle

二、集成

为了方便大家的使用，Walle提供了2种使用方式：（这里主要讲常用的第一种方式）

Gradle插件方式，方便快速集成
命令行方式，最大化满足各种自定义需求

配置build.gradle：

（1）在项目的build.gradle 文件中添加Walle Gradle插件的依赖，如下：

buildscript {
    dependencies {
        classpath 'com.meituan.android.walle:plugin:1.1.4'
    }
}

（2）在app的 build.gradle 文件中apply这个插件，并添加上用于读取渠道号的AAR，如下：

apply plugin: 'walle'

dependencies {
    compile 'com.meituan.android.walle:library:1.1.4'
}

（3）在app的 build.gradle 文件中配置插件，如下：

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")
}

配置项具体解释：

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：包含渠道配置信息的文件路径：

在app目录下新建名为channel的文件，如图

在该文件里写上需要打包的渠道号（渠道号支持使用#号添加注释。具体内容格式详见下图，这里只测试2个渠道）

三、相关API和命令

获取渠道信息：
在需要渠道等信息时可以通过下面代码进行获取

String channel = WalleChannelReader.getChannel(this.getApplicationContext());

生成渠道包：
生成渠道包的方式是和assemble${variantName}Channels指令结合，渠道包的生成目录默认存放在 build/outputs/apk/，也可以通过walle闭包中的apkOutputFolder参数来指定输出目录

生成渠道包 ./gradlew clean assembleReleaseChannels

更多API和命令可参考更多用法

四、使用

在Android Studio的Terminal中输入命令gradlew clean assembleReleaseChannels进行多渠道打包,当运行完成会出现BUILD SUCCESSFUL, 如图：

并且会在channels文件夹中生成所有渠道的apk，如图：

一一对应关系为：

五、Tinker与Walle在真实项目中的使用流程

上一篇文章热修复框架Tinker最完整讲解（01）——集成之路主要修复的是单个渠道包，这里结合Walle修复多个渠道包。

5.1 发布版本流程

（1）我们在发布版本的时候都需要改版本号，因为我这里使用版本名称作为tinkerId，所以发布版本修改版本名称的时候，tinkerId也要跟着修改。(tinkerId主要作用是当前打出的补丁包是基于哪个版本的apk, tinkerId的选取见我下一篇文章热修复框架Tinker最完整讲解（03）——使用Tinker常见问题。