为什么要多渠道打包 解决了哪些痛点
Android渠道非常之多,每个应用市场都要上传对应的渠道包,如果手动打包会耗费大量的时间和精力,多渠道打包就是为了开发者更省心省力省时。
优点
打包速度快,只需要编译一次。
对比其他工具
接入流程
添加依赖
在根工程的build.gradle中,添加对打包Plugin的依赖:
dependencies {
classpath 'com.android.tools.build:gradle:3.0.0'
classpath 'com.leon.channel:plugin:2.0.3'
}
引用VasDolly Plugin
在主App工程的build.gradle中,添加对VasDolly Plugin的引用:
apply plugin: 'channel'
添加对VasDolly helper类库的依赖
在主App工程的build.gradle中,添加读取渠道信息的helper类库依赖:
dependencies {
api 'com.leon.channel:helper:2.0.3'
}
创建渠道列表文件channel.txt 放在根工程下
huawei
yingyongbao
baidu
kuan
nearme
360
魅族
锤子
联想
豌豆荚
91助手
安智市场
安卓市场
天翼空间
oppo软件商店
vivo开发者平台
木蚂蚁
优亿市场
UC+
阿里应用分发开发平台
小米应用商店
Google Play
酷安网
sougou
jinli
配置渠道列表
在gradle.properties文件中加上
channel_file=channel.txt
直接编译生成多渠道包
若是直接编译生成多渠道包,首先要配置渠道文件、渠道包的输出目录和渠道包的命名规则:
channel{
//指定渠道文件
channelFile = file("channel.txt")
//多渠道包的输出目录,默认为new File(project.buildDir,"channel")
baseOutputDir = new File(project.buildDir,"xxx")
//多渠道包的命名规则,默认为:${appName}-${versionName}-${versionCode}-${flavorName}-${buildType}
apkNameFormat ='${appName}-${versionName}-${versionCode}-${flavorName}-${buildType}'
//快速模式:生成渠道包时不进行校验(速度可以提升10倍以上,默认为false)
isFastMode = false
//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指定的渠道列表拥有更高的优先级,且和原始的文件方式是互斥的。
根据已有基础包重新生成多渠道包
rebuildChannel {
//指定渠道文件
channelFile = file("channel.txt")
baseDebugApk = 已有Debug APK
baseReleaseApk = 已有Release APK
//默认为new File(project.buildDir, "rebuildChannel/debug")
debugOutputDir = Debug渠道包输出目录
//默认为new File(project.buildDir, "rebuildChannel/release")
releaseOutputDir = Release渠道包输出目录
//快速模式:生成渠道包时不进行校验(速度可以提升10倍以上,默认为false)
isFastMode = false
//低内存模式(仅针对V2签名,默认为false):只把签名块、中央目录和EOCD读取到内存,不把最大头的内容块读取到内存,在手机上合成APK时,可以使用该模式
lowMemory = false
}
然后,通过gradle rebuildChannel命令生成多渠道包。
为了方便临时生成渠道包进行测试,我们从v2.0.0开始支持添加渠道参数:gradle rebuildChannel -Pchannels=yingyongbao,gamecenter,这里通过属性channels指定的渠道列表拥有更高的优先级,且和原始的文件方式是互斥的。
在Terminal执行命令gradlew channalRelease
打包成功后在app/build/channel/release目录下会看到生成的apk文件
参考资料
VasDolly官方文档
借腾讯开源 VasDolly,谈谈 Android 签名和多渠道打包的原理!
ISSUE
OutOfMemory
AS内存不足导致 打开Settings找到Memory Settings把IDE max heap
size调大