多渠道打包概述

什么是多渠道包
渠道包就是要在安装包中添加渠道信息,也就是channel,对应不同的渠道,例如:小米市场、360市场、应用宝市场等
产品在不同的应用市场可能有不同的统计需求,需要为每个应用市场的Android包设定一个可以区分应用市场的标识,这个为Android包设定应用市场标识的过程就是多渠道打包。

为什么要提供多渠道包
国内存在着有众多的应用市场,产品在不同的渠道可能有不同的统计需求,为此Android开发人员需要为每个应用市场发布一个安装包,这里就引出了Android的多渠道打包。
在安装包中添加不同的标识,应用在请求网络的时候携带渠道信息,方便后台做运营统计。

通过配置gradle脚本实现多渠道打包
这种打包方式是使用Android Studio的编译工具gradle配合使用的,其核心原理就是通过脚本修改AndroidManifest.xml中的mate-date内容,执行N次打包签名操作实现多渠道打包的需求。然后就可以在java中通过API获取对应的数据。

 

多渠道打包实现步骤(友盟为例)

打包配置

  1. 按照umeng的要求,manifest文件中需要有(在application下,和activity是并列关系):
<meta-data
     android:name="UMENG_CHANNEL"
     android:value="${UMENG_CHANNEL_VALUE}">

这段配置,value那里就是渠道名称,但是我们在这里不会去写渠道名,写的是一个占位符,后面gradle编译的时候会动态的替换掉它。

  1. 在module(一般也就是app)的build.gradle的android{}中添加配置渠道:
// productFlavors是需要打包的纬度名称,下方的脚本是将配置文件中的占位符替换成渠道名称
    productFlavors{
        xiaomi {
            dimension "versionCode"
        }
        baidu {
            dimension "versionCode"
        }
        vivo {
            dimension "versionCode"
        }
        _360 {
            dimension "versionCode"
        }
    }
    // 纬度信息
    flavorDimensions("versionCode")

    productFlavors.all {flavor ->
        flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name]

    }

AS3.0以后需要将你原来所有的flavor进行统一管理,用属性名flavor dimension进行配置,即使你只有一维属性也需要这样做,否则你就会得到错误。Error:All flavors must now belong to a named flavor dimension. Learn more at https://d.android.com/r/tools/flavorDimensions-missing-error-message.html #85

  1. 如果没有错误的情况下我们会在Android studio的BuildVariant看到对应的渠道,如下图所示:
  2. 获取渠道
@Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        String channel=getChannel();
        Toast.makeText(MainActivity.this, "channel==" + channel, Toast.LENGTH_SHORT).show();
    }

    private String getChannel() {
        try {
            PackageManager pm = getPackageManager();
            ApplicationInfo appInfo = pm.getApplicationInfo(getPackageName(), PackageManager.GET_META_DATA);
            return appInfo.metaData.getString("UMENG_CHANNEL");
        } catch (PackageManager.NameNotFoundException ignored) {
        }
        return "";
    }
  1. 配置buildTypes信息以及Apk自定义名称
buildTypes {
        debug {
            // debug 使用release的签名信息,也可以不配置
            // 自动签名打包时要用到签名配置
            signingConfig signingConfigs.release
        }
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
            // 自动签名打包时要用到签名配置
            signingConfig signingConfigs.release
            // 修改生成的 apk 文件名,输出 apk 名称:MyApp_v1.0.0_2017-11-10_debug.apk;MyApp是app的名称
            android.applicationVariants.all { variant ->
                def suffix
                if (variant.buildType.name == 'release') {
                    suffix = 'release'
                } else {
                    suffix = 'debug'
                }
                  // AS3.0之前这样重命名
//                variant.outputs.each { output ->
//                    def outputFile = output.outputFile
//                    if (outputFile != null && outputFile.name.endsWith('.apk')) {
//                        def fileName = "MyApp_v${defaultConfig.versionName}_${releaseTime()}_${suffix}.apk"
//                        output.outputFile = new File(outputFile.parent, fileName)
//                    }
//                }
                // AS3.0之后这样重命名
                variant.outputs.all {
                    outputFileName = "WanAndroid_v${defaultConfig.versionName}_${releaseTime()}_" +
                            "${variant.productFlavors[0].name}_${suffix}.apk"
                }
            }
        }
    }

releaseTime()是获取当前时间的方法,配置在build文件的根节点

// 定义打包时间
static def releaseTime() {
    return new Date().format("yyyy-MM-dd", TimeZone.getTimeZone("UTC"))
}

签名信息

// 签名配置
    signingConfigs {
        release {
            storeFile file('/Users/zly/Downloads/DemoProject/WanAndroid/wanAlias.jks')
            storePassword '123456'
            keyAlias = 'wanAndroid'
            keyPassword '123456'
        }
    }

打包

根据签名方式可分为两种打包方式

  1. 手动签名打包
  1. (build -> Generrate Signed Bundle/Apk)选择已有的签名文件或者新建
  2. 选择打包已经配置过的渠道(选择release版本)
  1. 自动签名打包
  1. 打开Project Stucture图形化界面,选择已有的签名文件

点击ok之后就会生成signingConfigs

在Terminal中使用./gradlew assembleRelease  或者 gradle assembleRelease  可进行所有渠道打包。

也可以单独打包一个渠道,例如 ./gradlew assembleVivoRelease得到Vivo的包

PS:使用gradle命令的前提是配置gradle环境

 

参考资料:

Android的多渠道打包

Android多渠道打包方案汇总