多渠道打包VasDolly接入指南

之前多渠道打包一直用的360加固宝,今年三月份360开始收费了;所以用了VasDolly做多渠道的替代方案; GitHub地址 https://github.com/Tencent/VasDolly

一:使用VasDolly的必备条件;

1:build:gradle:4.2.0以上,也就是说你需要升级高版本的AndroidStudio;

二:接入流程

添加对VasDolly Plugin的依赖

在根工程的build.gradle中，添加对打包Plugin的依赖：

dependencies {
        classpath 'com.android.tools.build:gradle:4.2.2'
        classpath 'com.tencent.vasdolly:plugin:3.0.6'
}

在主App工程的build.gradle中，添加对VasDolly Plugin的引用：

apply plugin: 'com.tencent.vasdolly'

app的build.gradle顶部

在主App工程的build.gradle中，添加读取渠道信息的helper类库依赖：

dependencies {
    api 'com.tencent.vasdolly:helper:3.0.6'
}

三:配置渠道列表

1:在gradle.properties文件指定渠道文件名称，该渠道文件必须位于根工程目录下，一行一个渠道信息。

channel_file=app_channel.txt

2:在channel或者rebuildChannel属性中通过channelFile属性指定渠道文件，一行一个渠道信息。

channel{
    //指定渠道文件
   channelFile = file("app_channel.txt")
}
rebuildChannel{
    //指定渠道文件
   channelFile = file("app_channel.txt")
}

在app的build.gradle中配置(跟buildTypes同级)

    //VasDolly插件配置
//gradle channelDebug/channelRelease 编译生成apk后，再根据生成的Apk生成渠道包
    channel{
        channelFile = file("app_channel.txt")
        //多渠道包的输出目录，默认为new File(project.buildDir,"channel")
        outputDir = new File(project.buildDir,"channels")
        //多渠道包的命名规则，默认为：${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
    }

    // gradle rebuildChannel 配置此任务用于不希望重新构建apk，直接根据指定的apk生成渠道包
    rebuildChannel {
        channelFile = file("app_channel.txt")
        //指定的apk生成渠道包,文件名中如果有base将被替换为渠道名，否则渠道名将作为前缀
        baseApk = new File(project.buildDir, "outputs/apk/debug/app-debug.apk")
        //默认为new File(project.buildDir, "rebuildChannel")
        outputDir = new File(project.buildDir, "rebuildChannels")
        //快速模式：生成渠道包时不进行校验（速度可以提升10倍以上，默认为false）
        fastMode = false
        //低内存模式（仅针对V2签名，默认为false）：只把签名块、中央目录和EOCD读取到内存，不把最大头的内容块读取到内存，在手机上合成APK时，可以使用该模式
        lowMemory = false
    }

四:读取渠道信息

String channel = ChannelReaderUtil.getChannel(getApplicationContext());

五:gradle命令:

两种方式生成渠道包
1:直接生成
通过gradle channelDebug、gradle channelRelease命令分别生成Debug和Release的多渠道包。
2:根据已有包生成
通过gradle rebuildChannel命令生成多渠道包。

---

示例:

第一步 第二步 第三步,需要输入命令

六:碰到的问题;

项目中使用了productFlavors

productFlavors

会跟gradle channelDebug、gradle channelRelease产生冲突;
GitHub的issues

issues

经过测试是可以使用根据已有包生成多渠道包的;只需要先正常打一个包,在调用gradle rebuildChannel命令生成多渠道包。注意baseApk 的地址要填写正确;