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

转载请注明出处:http://www.jianshu.com/p/8a850ddee403

前言

上一篇文章 热修复框架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的文件,如图

热修复框架Tinker最完整讲解(02)——加入Walle多渠道打包_第1张图片

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

热修复框架Tinker最完整讲解(02)——加入Walle多渠道打包_第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, 如图:

热修复框架Tinker最完整讲解(02)——加入Walle多渠道打包_第3张图片

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


热修复框架Tinker最完整讲解(02)——加入Walle多渠道打包_第4张图片

一一对应关系为:


热修复框架Tinker最完整讲解(02)——加入Walle多渠道打包_第5张图片

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

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

发布版本流程

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

热修复框架Tinker最完整讲解(02)——加入Walle多渠道打包_第6张图片

2, 检查app build中是否开启了热修复功能, 即tinkerEnabled需要设置为true。如图:


热修复框架Tinker最完整讲解(02)——加入Walle多渠道打包_第7张图片

3,打包前先建一个当前版本的分支!!!(热更新修复bug就在该分支上修改)

4,在AS的Terminal中输入命令gradlew clean assembleReleaseChannels进行多渠道打包
命令行运行完成会在channels文件夹中生成所有渠道的apk, 如图:


热修复框架Tinker最完整讲解(02)——加入Walle多渠道打包_第8张图片

5,同时会在bakApk文件中生成三个文件,如图: (这三个文件需要保存在本地,svn或者git服务器,每次发布补丁包的时候需要用到!)


热修复框架Tinker最完整讲解(02)——加入Walle多渠道打包_第9张图片

发补丁包流程

1,在新建的分支上修改bug

2,将发布版本第5步中的三个文件路径复制到app build中对应的位置,如图:


热修复框架Tinker最完整讲解(02)——加入Walle多渠道打包_第10张图片

3,修改bug

4,运行补丁命令获取补丁包。单击AS右侧顶部gradle,双击tinkerPatchRelease,如图:


热修复框架Tinker最完整讲解(02)——加入Walle多渠道打包_第11张图片

5,运行完成会在build->outputs->tinkerPatch->release文件夹中生成一个名为patch_signed_7zip.apk的补丁包,如图:


热修复框架Tinker最完整讲解(02)——加入Walle多渠道打包_第12张图片

6,将该补丁包重修修改名字后发给后台(注意:这里的一个补丁包就适用于各个渠道包!),关于补丁包的存放与后台设计请看下一篇文章热修复框架Tinker最完整讲解(03)——使用Tinker常见问题。

7,bug修改完成后将该分支合并到trunk主干上即可。这样能保证分支上修改了bug,trunk主干上也跟着更新了。

Tinker系列文章讲的已经非常详细了,有不足的地方希望指出。遇到不懂的问题都可以直接在博客下评论问我,只要我遇到过并且能回答出来的都会乐意回答。

Demo下载地址:https://github.com/wildma/WildmaTinker
如果对你有帮助请点赞,star支持下哈~

热修复Tinker系列文章

热修复框架Tinker最完整讲解(01)——集成之路

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

热修复框架Tinker最完整讲解(03)——使用Tinker常见问题

你可能感兴趣的:(热修复框架Tinker最完整讲解(02)——加入Walle多渠道打包)