最近闲来无事 想要实践下 结果因为知识点不足遇到个坑
先说问题点: gradle channelRelease 不等同于 .\gradlew channelRelease
VasDolly 地址
https://github.com/Tencent/VasDolly
实现原理:
https://github.com/Tencent/VasDolly/wiki/VasDolly%E5%AE%9E%E7%8E%B0%E5%8E%9F%E7%90%86
简介
VasDolly是一种快速多渠道打包工具,同时支持基于V1签名和V2,V3签名进行多渠道打包。插件本身会自动检测Apk使用的签名类别,并选择合适的多渠道打包方式,对使用者来说完全透明。
目前Gradle Plugin 2.2以上默认开启V2签名,所以如果想关闭V2签名,可将下面的v2SigningEnabled设置为false。 关于应用签名说明:见官方文档
signingConfigs {
release {
...
v1SigningEnabled true
v2SigningEnabled false
}
debug {
...
v1SigningEnabled true
v2SigningEnabled false
}
}
接入流程
添加对VasDolly Plugin的依赖
在根工程的build.gradle
中,添加对打包Plugin的依赖:
dependencies {
classpath 'com.android.tools.build:gradle:7.0.3'
classpath 'com.tencent.vasdolly:plugin:3.0.5'
}
引用VasDolly Plugin
在主App工程的build.gradle
中,添加对VasDolly Plugin的引用:
apply plugin: 'com.tencent.vasdolly'
添加对VasDolly helper类库的依赖
在主App工程的build.gradle
中,添加读取渠道信息的helper类库依赖:
dependencies {
api 'com.tencent.vasdolly:helper:3.0.5'
}
配置渠道列表
目前有两种方式配置渠道列表,最终的渠道列表是两者的累加之和:
- 在
gradle.properties
文件指定渠道文件名称,该渠道文件必须位于根工程目录下,一行一个渠道信息。
channel_file=channel.txt
- 在
channel
或者rebuildChannel
属性中通过channelFile
属性指定渠道文件,一行一个渠道信息。
channel{
//指定渠道文件
channelFile = file("/Users/leon/Downloads/testChannel.txt")
}
rebuildChannel{
//指定渠道文件
channelFile = file("/Users/leon/Downloads/testReChannel.txt")
}
通过Gradle生成多渠道包
直接编译生成多渠道包
若是直接编译生成多渠道包,首先要配置渠道文件、渠道包的输出目录和渠道包的命名规则:
channel{
//指定渠道文件
channelFile = file("/Users/leon/Downloads/testChannel.txt")
//多渠道包的输出目录,默认为new File(project.buildDir,"channel")
outputDir = new File(project.buildDir,"xxx")
//多渠道包的命名规则,默认为:${appName}-${versionName}-${versionCode}-${flavorName}-${buildType}-${buildTime}
apkNameFormat ='${appName}-${versionName}-${versionCode}-${flavorName}-${buildType}'
//快速模式:生成渠道包时不进行校验(速度可以提升10倍以上,默认为false)
fastMode = 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("/Users/leon/Downloads/testReChannel.txt")
// 已有APK文件地址(必填),如new File(project.rootDir, "/baseApk/app_base.apk"),文件名中的base将被替换为渠道名
baseApk = 已有APK文件地址(必填)
//默认为new File(project.buildDir, "rebuildChannel")
outputDir = 渠道包输出目录
//快速模式:生成渠道包时不进行校验(速度可以提升10倍以上,默认为false)
fastMode = false
//低内存模式(仅针对V2签名,默认为false):只把签名块、中央目录和EOCD读取到内存,不把最大头的内容块读取到内存,在手机上合成APK时,可以使用该模式
lowMemory = false
}
然后,通过gradle rebuildChannel
命令生成多渠道包。
为了方便临时生成渠道包进行测试,我们从v2.0.0
开始支持添加渠道参数:gradle rebuildChannel -Pchannels=yingyongbao,gamecenter
,这里通过属性channels
指定的渠道列表拥有更高的优先级,且和原始的文件方式是互斥的。
通过命令行生成渠道包、读取渠道信息
从V1.0.5
版本开始支持命令行,具体使用文档可参考command
目录下的README。
读取渠道信息
通过helper类库中的ChannelReaderUtil
类读取渠道信息。
String channel = ChannelReaderUtil.getChannel(getApplicationContext());
如果没有渠道信息,那么这里返回null
,开发者需要自己判断。
app_channel.txt文件
内容:
qq
weixin
遇到问题
简单配置之后 运行 gradle channleRelease
出现问题 : 更改java 版本为11 , 严格按照文档gradle版本配置
gradle-wrapper.properties 为
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-7.0.2-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
继续出现问题:Minimum supported Gradle version is 7.0.2. Current version is 6.5
初步以为是更改没有生效 但是重启之后依旧无效。
最终发现问题 gradle 命令和 .\gradlew命令含义不同
.\gradlew 代表 gradle wrapper 也就是说 更改的gradle-wrapper.properties 只在.\gradlew命令下生效
gradle -version
.\gradlew -version
gradle 和 gradlew 啥区别
https://juejin.cn/post/7144558236643885092