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
baidu

2. 在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源码解析

Android之VasDolly多渠道打包

猜你喜欢