Android之VasDolly多渠道打包
东方旭东
上一篇：Android之Apk打包原理之后，今天记录一下多渠道打包。
首先，说明一下多渠道打包的意义：
- 在安装包中添加不同的标识，应用在请求网络的时候携带渠道信息，方便后台做运营统计。
经过亲测，总结一下VasDolly实现多渠道打包步骤及常见的问题，具体还请移步官方介绍。
首先是Github上：腾讯VasDolly链接
-
添加对VasDolly Plugin的依赖
在根工程的build.gradle中，添加对打包Plugin的依赖：
dependencies {
classpath 'com.android.tools.build:gradle:3.0.0'
classpath 'com.leon.channel:plugin:2.0.2'
}-
引用VasDolly Plugin
在主App工程的build.gradle中，添加读取渠道信息的helper类库依赖：
apply plugin: 'com.android.application'
apply plugin: 'channel'- 添加对VasDolly helper类库的依赖
dependencies {
api 'com.leon.channel:helper:2.0.2'
}-
配置渠道列表
1.在工程根目录下，新建渠道文件（channel.txt），一行一个渠道信息：
alibaba
xiaomi
googlePlay
official
yingyongbao
huawei
qh360
baidu2. 在gradle.properties文件指定渠道文件名称：
channel_file=channel.txt-
通过Gradle生成多渠道包
直接编译生成多渠道包，首先要配置渠道文件、渠道包的输出目录和渠道包的命名规则：
//直接编译生成多渠道包
//命令行操作打包，gradlew channelDebug、gradlew channelRelease
channel{
//指定渠道文件
//channelFile = new File(project.rootDir, "channel.txt")
//多渠道包的输出目录，默认为new File(project.buildDir,"channel")
baseOutputDir = new File(project.rootProject.buildDir,"channel")
//多渠道包的命名规则，默认为：
//${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
- 集成友盟统计需要注意
在Application 下的 onCreate() 方法中去加代码：
private void initUmeng() {
//获取渠道标识
String channel = ChannelReaderUtil.getChannel(getApplicationContext());
MobclickAgent.setDebugMode(true);
// SDK在统计Fragment时，需要关闭Activity自带的页面统计，
// 然后在每个页面中重新集成页面统计的代码(包括调用了 onResume 和 onPause 的Activity)。
MobclickAgent.openActivityDurationTrack(false);
//普通统计场景类型
MobclickAgent.setScenarioType(this, MobclickAgent.EScenarioType.E_UM_NORMAL);
MobclickAgent. startWithConfigure(new MobclickAgent.UMAnalyticsConfig(this,
"你的友盟AppKey", channel, MobclickAgent.EScenarioType.E_UM_NORMAL,true));
}- 使用命令生成Debug和Release的多渠道包（Terminal中运行）
gradle channelDebug
gradle channelRelease因为遇到了问题，一直无法成功，需要配置自定义签名。
下面是我自己项目的配置文件：
apply plugin: 'com.android.application'
apply plugin: 'channel'
android {
compileSdkVersion 26
buildToolsVersion '28.0.3'
defaultConfig {
applicationId "com.***.***"
minSdkVersion 19
targetSdkVersion 26
versionCode 1
versionName "1.0.1"
}
// 定义APK的签名信息
signingConfigs {
debug {
keyAlias '**'
keyPassword '***'
storeFile file('D:/keystore/***.jks')
storePassword '***'
}
release {
keyAlias '**'
keyPassword '***'
storeFile file('D:/keystore/***.jks')
storePassword '***'
}
}
buildTypes {
release {
// 开启混淆（防止反编译）
minifyEnabled true
// 移除无用的resource文件
shrinkResources false
debuggable false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
signingConfig signingConfigs.release
}
debug {
debuggable true
minifyEnabled false
signingConfig signingConfigs.debug
}
}
//直接编译生成多渠道包
//命令行操作打包，gradlew channelDebug、gradlew channelRelease
channel{
//指定渠道文件
//channelFile = new File(project.rootDir, "channel.txt")
//多渠道包的输出目录，默认为new File(project.buildDir,"channel")
baseOutputDir = new File(project.rootProject.buildDir,"channel")
//多渠道包的命名规则，默认为：${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
}
}
dependencies {
//多渠道打包
api 'com.leon.channel:helper:2.0.2'
}
其他的高级技巧和问题，可以参考官方文档。关于其原理可以查看：鸿洋大神VasDolly源码解析
类似资料：