Gradle实战：Android多渠道打包方案汇总

原文地址：http://blog.csdn.net/u0108184...

Gradle实战系列文章：

《Gradle基本知识点与常用配置》
《Gradle实战：不同编译类型的包同设备共存》
《Gradle实战：发布aar包到maven仓库》
《Gradle实战：执行sql操作hive数据库》

---

本文将延续之前几篇博客的风格，先从基本概念入手，这有助于我们对后文的理解； 在后续的代码中如果忘了某个概念的具体意义，可以回顾头来重新查看概念的介绍。

文中先详细介绍了一般批量打包方案的实现原理，后介绍了美团批量打包的基本实现原理，并引用了几篇实现方案供大家参考

---

一、基本概念介绍

1. package

AndroidManifest文件中的包名

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.company.appname"
        android:versionCode="1"
        android:versionName="1.0" >

包名有两个作用：
一是设备上应用程序的唯一标识，也是在应用市场上的唯一标识；
二是被用来命名你的资源类的包（以及解析任何相关的Activity的类名），如com.company.appname.R

2. PlaceHolder

AndroidManifest文件中的变量表示，通过${PlaceHolder}表示PlaceHolder是可以被赋值的变量，如友盟统计中的渠道：

    <meta-data
        android:name="UMENG_CHANNEL"
        android:value="${UMENG_CHANNEL_VALUE}">
    </meta-data>

3. applicationId

对应于AndroidManifest中的package

    android {
        defaultConfig {
            applicationId "com.company.appname"
        }
    }

4. buildTypes

4.1 用于生成不同编译类型的包，如debug和release包

    android{
        buildTypes {
            debug {
                ...
            }
            release {
                ...
            }
        }
    }

debug和release是gradle默认自带的两个build type，在工程自动生成的BuildConfig中，其区别如下：

4.2 自定义不同的build type，如

      
    android{
        buildTypes {
            debug {
                ...
            }
            release {
                ...
            }
            beta {
                ...
            }
        }
    }

5. productFlavors

用于生成不同渠道的包

    android {  
        productFlavors {
            xiaomi {}
            baidu {}
            wandoujia {}
            _360 {}        // 或“"360"{}”，数字需下划线开头或加上双引号
        }
    }

执行./gradlew assembleRelease ，将会打出所有渠道的release包；
执行./gradlew assembleWandoujia，将会打出豌豆荚渠道的release和debug版的包；
执行./gradlew assembleWandoujiaRelease将生成豌豆荚的release包。

因此，可以结合buildType和productFlavor生成不同的Build Variants，即类型与渠道不同的组合

6. signingConfigs

签名配置，release编译类型的配置如：

    release {
        storeFile file("../yourapp.keystore") //签名证书文件
        storePassword "your password"         //签名证书密码
        keyAlias "your alias"                 //别名
        keyPassword "your password"           //别名密码
    }

当然，签名信息可以通过读配置文件（见上一篇文章）和配置文件ignore的形式来进行隐藏，本文不作详述。

7. META-INF文件

用于存储签名的一些相关信息，在META-INF目录内添加空文件，应用无需重新签名。

---

二、多渠道打包配置

1. 一般打包方案

    //生成打包时间
    def releaseTime() {
        return new Date().format("yyyy-MM-dd", TimeZone.getTimeZone("UTC"))
    }
    
    android {
        compileSdkVersion 23
        buildToolsVersion "23.0.3"
    
        defaultConfig {
            applicationId "com.company.appname"
            minSdkVersion 15
            targetSdkVersion 23
            versionCode 1
            versionName "1.0"
    
            //默认渠道为官网
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "official"]
        }
    
        lintOptions {
            checkReleaseBuilds false
            abortOnError false
        }
    
        //配置编译的jdk版本
        compileOptions {
            sourceCompatibility org.gradle.api.JavaVersion.VERSION_1_7
            targetCompatibility org.gradle.api.JavaVersion.VERSION_1_7
        }
    
        //签名配置
        signingConfigs {
            debug {
                // No debug config
                storeFile file("${rootDir}/keystores/xqsg_debug.jks") //debug证书
            }
    
            release {
                storeFile file("${rootDir}/keystores/xqsg.jks") //release证书
                storePassword "test"                            //签名证书密码
                keyAlias "test"                                 //别名
                keyPassword "test"                              //别名密码
            }
        }
    
        buildTypes {
            debug {
                buildConfigField("boolean", "LOG_ON", "true")//通过编译类型配置日志开关
                versionNameSuffix "-debug"                       //包名后缀为“-debug”
    
                minifyEnabled false                              //是否混淆
                zipAlignEnabled false                            //Zipalign优化
                shrinkResources false                            // 移除无用的resource文件
                signingConfig signingConfigs.debug               //使用debug证书签名
            }
    
            release {
                buildConfigField "boolean", "LOG_ON", "false" //不显示Log
    
                minifyEnabled true                               //开启混淆
                zipAlignEnabled true                             //开启Zipalign优化
                shrinkResources true                             //移除无用的resource文件，此项只有在开启混淆时才生效
                proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
                signingConfig signingConfigs.release             //使用release证书签名
    
                //多渠道打包配置
                applicationVariants.all { variant ->
                    variant.outputs.each { output ->
                        def outputFile = output.outputFile
                        if (outputFile != null && outputFile.name.endsWith('.apk')) {
                            // 输出apk名称为test_v1.0_2016-08-15_wandoujia.apk
                            def fileName = "test_v${defaultConfig.versionName}_${releaseTime()}_${variant.productFlavors[0].name}.apk"
                            output.outputFile = new File(outputFile.parent, fileName)
                        }
                    }
                }
            }
        }
    
        // 渠道配置
        productFlavors {
            wandoujia {}
            _360 {}
            baidu {}
            xiaomi {}
        }
    
        productFlavors.all { flavor ->
            flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name] //动态地修改AndroidManifest中的渠道名
        }
    }

注：上述日志开关，可以在java代码中获取该变量值，如：

if(BuildConfig.LOG_ON){
    Log.d("test","xxx");    
}

2. 美团打包方案

实现原理：Android应用安装包apk文件是一个压缩文件，可以将其后缀改为zip直接解压。解压后会发现根目录下有一个META-INF目录。如果在META-INF目录内添加空文件，应用无需重新签名。因此，通过为不同渠道的应用添加不同的空文件，可以唯一标识一个渠道。

采用这种方式，每打一个渠道包只需复制一个apk，在META－INF中添加一个使用渠道号命名的空文件即可。

• 美团Android自动化之旅—生成渠道包

• 美团Android自动化之旅—适配渠道包

• 实现参考1

• 实现参考2

---

深入学习

Android Studio系列教程六--Gradle多渠道打包
Android产品研发（五）-->多渠道打包
更便捷的 Android 多渠道打包方式
Android打包系列——多渠道快速打包