前言
其实本文大部分资料都来自github和google,如何有兴趣的读者,可以直接阅读官方文档~
什么是Gradle
Android 构建系统编译应用资源和源代码,然后将它们打包成可供您测试、部署、签署和分发的 APK。 Android Studio 使用 Gradle 这一高级构建工具包来自动执行和管理构建流程,同时也允许您定义灵活的自定义构建配置。
每个构建配置均可自行定义一组代码和资源,同时对所有应用版本共有的部分加以重复利用。 Android Plugin for Gradle 与这个构建工具包协作,共同提供专用于构建和测试 Android 应用的流程和可配置设置。
Gradle 和 Android 插件独立于 Android Studio 运行。 这意味着,您可以在 Android Studio 内、计算机上的命令行或未安装 Android Studio 的计算机(例如持续性集成服务器)上构建 Android 应用。
如果您不使用 Android Studio,可以学习如何从命令行构建和运行您的应用。 无论您是从命令行、在远程计算机上还是使用 Android Studio 构建项目,构建的输出都相同。
注:由于 Gradle 和 Android 插件独立于 Android Studio 运行,您需要单独更新构建工具。
请阅读版本说明,了解如何更新 Gradle 和 Android 插件。Android 构建系统非常灵活,让您能够在不修改应用核心源文件的情况下执行自定义构建配置。
什么是VasDolly (github 传送门)
VasDolly是腾讯开源的一个高效的打包工具。腾讯作为国内的技术大厂,在技术层面上还是很牛逼and可靠的。而且开发团队在github上也是相对的活跃,对issue也解决也是很积极的。
VasDolly是一种快速多渠道打包工具,同时支持基于V1签名和V2签名进行多渠道打包。插件本身会自动检测Apk使用的签名类别,并选择合适的多渠道打包方式,对使用者来说完全透明。
VasDolly 是腾讯推出的新一代打包工具,相对于传统的打包工具,即AS自带的打包工具,速度有了非一般的提升。
Gradle Plugin本身提供了多渠道的打包策略: 首先,在AndroidManifest.xml中添加渠道信息占位符:
<meta-data android:name="InstallChannel" android:value="${InstallChannel}" />
然后,通过Gradle Plugin提供的productFlavors标签,添加渠道信息:
productFlavors{
"YingYongBao"{ manifestPlaceholders = [InstallChannel : "YingYongBao"] }
"360"{ manifestPlaceholders = [InstallChannel : "360"] }
}
这样,Gradle编译生成多渠道包时,会用不同的渠道信息替换AndroidManifest.xml中的占位符。我们在代码中,也就可以直接读取AndroidManifest.xml中的渠道信息了。
但是,这种方式存在一些缺点:
每生成一个渠道包,都要重新执行一遍构建流程,效率太低,只适用于渠道较少的场景。
Gradle会为每个渠道包生成一个不同的BuildConfig.java类,记录渠道信息,导致每个渠道包的DEX的CRC值都不同。一般情况下,这是没有影响的。但是如果你使用了微信的Tinker热补丁方案,那么就需要为不同的渠道包打不同的补丁,这完全是不可以接受的。(因为Tinker是通过对比基础包APK和新包APK生成差分补丁,然后再把补丁和基础包APK一起合成新包APK。这就要求用于生成差分补丁的基础包DEX和用于合成新包的基础包DEX是完全一致的,即:每一个基础渠道包的DEX文件是完全一致的,不然就会合成失败)
那有没有一种方案:可以在添加渠道信息后,不需要重新签名?
答案就是:VasDolly 。
背景
Android在国内的市场极度的碎片化,各大应用市场乐此不疲,OEM厂商也都自立山头。而作为一个成熟的、商业化的App,必然是要在各个应用市场占坑霸榜的。所以运营的同事一般都会要求Android小哥哥提供几个甚至十几个不同渠道的渠道包。而传统的打包工具的打包速度大家都心知肚明的,尽管Google不断的优化,但还是差强人意。因此一个快速,高效的打包工具就很必要了,可以节省开发小哥哥大量的工作时间。
使用VasDolly
在根工程的build.gradle中,添加对打包Plugin的依赖:
dependencies {
classpath'com.android.tools.build:gradle:3.0.0'classpath'com.leon.channel:plugin:2.0.3'
}
在主App工程的build.gradle中,添加对VasDolly Plugin的引用:
applyplugin:'channel'
添加对VasDolly helper类库的依赖
在主App工程的build.gradle中,添加读取渠道信息的helper类库依赖:
dependencies { api'com.leon.channel:helper:2.0.3'}
配置渠道列表
目前有两种方式配置渠道列表,最终的渠道列表是两者的累加之和:
在gradle.properties文件指定渠道文件名称,该渠道文件必须位于根工程目录下,一行一个渠道信息。
channel_file=channelFile.txt
在channel或者rebuildChannel属性中通过channelFile属性指定渠道文件,一行一个渠道信息。
channel{
//指定渠道文件
channelFile = file("../channelFile.txt")
}
rebuildChannel{
//指定渠道文件
channelFile = file("../channelFile.txt")
}
channelFile.txt 为了方便经常git版本管理,我放在了项目的根目录下
channelFile.txt 中的内容是每一个渠道都单独成行
直接编译生成多渠道包
若是直接编译生成多渠道包,首先要配置渠道文件、渠道包的输出目录和渠道包的命名规则:
channel{
//指定渠道文件
channelFile=file("../channelFile.txt")
//多渠道包的输出目录,默认为new File(project.buildDir,"channel")
baseOutputDir = new File("${project.buildDir}/channelRoot/test")
//多渠道包的命名规则,默认为${appName}-${versionName}-${versionCode}-${flavorName}-${buildType}
apkNameFormat='${appName}-${versionName}-${versionCode}-${flavorName}-${buildType}'
//快速模式:生成渠道包时不进行校验(速度可以提升10倍以上,默认为false)
isFastMode=true
//buildTime的时间格式,默认格式:yyyyMMdd-HHmmss
buildTimeDateFormat='yyyyMMdd-HH:mm:ss'
//低内存模式(仅针对V2签名,默认为false):只把签名块、中央目录和EOCD读取到内存,不把最大头的内容块读取到内存,在手机上合成APK时,可以使用该模式
lowMemory=false
}
其中,多渠道包的命名规则中,可使用以下字段:
appName : 当前project的name
versionName : 当前Variant的versionName
versionCode : 当前Variant的versionCode
buildType : 当前Variant的buildType,即debug or release
flavorName : 当前的渠道名称
appId : 当前Variant的applicationId
buildTime : 当前编译构建日期时间,时间格式可以自定义,默认格式:yyyyMMdd-HHmmss
然后,通过gradle channelDebug、gradle channelRelease命令分别生成Debug和Release的多渠道包。
为了方便临时生成渠道包进行测试,我们从v2.0.0开始支持添加渠道参数:gradle channelDebug(channelRelease) -Pchannels=yingyongbao,gamecenter,这里通过属性channels指定的渠道列表拥有更高的优先级,且和原始的文件方式是互斥的。
选择使用V1 还是V2签名
目前Gradle Plugin 2.2以上默认开启V2签名,所以如果想关闭V2签名,可将下面的v2SigningEnabled设置为false。
signingConfigs {
release {
...
v1SigningEnabledtruev2SigningEnabledfalse
}
debug {
...
v1SigningEnabledtruev2SigningEnabledfalse
}
}
如图
读取渠道信息
通过helper类库中的ChannelReaderUtil类读取渠道信息。
Stringchannel=ChannelReaderUtil.getChannel(getApplicationContext());
如果没有渠道信息,那么这里返回null,开发者需要自己判断。
调用Gradle Task 一键生成多个release版本渠道包,或者debug渠道包
在集成成功之后,重新rebuild项目,VasDolly就会自动在项目的Gradle Task中生成对应的Task ,在需要发布正式版的时候只要选择对应的task即可
完成打包之后,就可以在直接配置的输出目录中看到生成的应用安装包了
使用命令行生成渠道包
为了方便临时生成渠道包进行测试,VasDolly从v2.0.0开始支持添加渠道参数:gradle channelDebug(channelRelease) -Pchannels=yingyongbao,gamecenter,这里通过属性channels指定的渠道列表拥有更高的优先级,且和原始的文件方式是互斥的。
效果等同于上一种使用方式
Demo参考
详细的接入范式,可参考Demo
或者参考我自己写的Demo