Android多渠道打包之动态修改App名称，图标，applicationId，版本号，添加资源

同一套代码，打包N套APP，而且这些APP的名称、图标、applicationId、版本号，甚至主页都不一样。之前都是单次修改，单次打包，可随着需求越来越多，需要打的包也会越来越多，单次打包费时费力，很明显已经不再适合，于是借助Gradle的productFlavors实现所需功能，打包过程也变的更为简单。

Gradle是一个基于Apache Ant和Apache Maven概念的项目自动化建构工具。可以帮助我们轻松实现多渠道打包的功能。

build.gradle

apply plugin: 'com.android.application'

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

//获取local.properties的内容
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())

android {
    compileSdkVersion 25
    buildToolsVersion "25.0.3"

    // 使用签名文件进行签名的两种方式
//    //第一种：使用gradle直接签名打包
//    signingConfigs {
//        config {
//            storeFile file('keystore.jks')
//            storePassword '123456'
//            keyAlias 'HomeKey'
//            keyPassword '123456'
//        }
//    }
    //第二种：为了保护签名文件，将其放在local.properties中并在版本库中排除，不把这些信息写入到版本库中（注意，此种方式签名文件中不能有中文）
    signingConfigs {
        config {
            storeFile file(properties.getProperty("keystroe_storeFile"))
            storePassword properties.getProperty("keystroe_storePassword")
            keyAlias properties.getProperty("keystroe_keyAlias")
            keyPassword properties.getProperty("keystroe_keyPassword")
        }
    }

    // 默认配置
    defaultConfig {
        minSdkVersion 16
        targetSdkVersion 25
        versionCode 1
        versionName "1.0.1"
    }

    // 多渠道 的不同配置
    productFlavors {
         baidu {
            // 每个环境包名不同
            applicationId "cn.appblog.multichannel.baidu"
            // 动态添加 string.xml 字段；
            // 注意，这里是添加，在 string.xml 不能有这个字段，会重名！！！
            resValue "string", "app_name", "百度"
            resValue "bool", "auto_updates", 'false'
            // 动态修改 常量 字段
            buildConfigField "String", "ENVIRONMENT", '"我是百度首页"'
            // 修改 AndroidManifest.xml 里渠道变量
            manifestPlaceholders = [CHANNEL_VALUE: "baidu", app_icon: "@mipmap/logo_baidu"]
        }
        qq {
            applicationId "cn.appblog.multichannel.qq"

            resValue "string", "app_name", "腾讯"
            resValue "bool", "auto_updates", 'true'

            buildConfigField "String", "ENVIRONMENT", '"我是腾讯首页"'

            manifestPlaceholders = [CHANNEL_VALUE: "qq", app_icon: "@mipmap/icon_qq"]
        }
        xiaomi {
            applicationId "com.shi.androidstudio.multichannel.xiaomi"

            resValue "string", "app_name", "小米"
            resValue "bool", "auto_updates", 'true'
            resValue "drawable", "isrRank", 'true'

            buildConfigField "String", "ENVIRONMENT", '"我是小米首页"'

            manifestPlaceholders = [CHANNEL_VALUE: "xiaomi", app_icon: "@mipmap/icon_xiaomi"]
        }
    }

    //移除lint检测的error
    lintOptions {
        abortOnError false
    }

    buildTypes {
        debug {
            // debug模式下，显示log
            buildConfigField("boolean", "LOG_DEBUG", "true")
            //为已经存在的applicationId添加后缀
            applicationIdSuffix ".debug"
            // 为版本名添加后缀
            versionNameSuffix "-debug"
            // 不开启混淆
            minifyEnabled false
            // 不开启ZipAlign优化
            zipAlignEnabled false
            // 不移除无用的resource文件
            shrinkResources false
            // 使用config签名
            signingConfig signingConfigs.config

        }
        release {
            // release模式下，不显示log
            buildConfigField("boolean", "LOG_DEBUG", "false")
            // 为版本名添加后缀
            versionNameSuffix "-relase"
            // 不开启混淆
            minifyEnabled false
            // 开启ZipAlign优化
            zipAlignEnabled true
            // 移除无用的resource文件
            shrinkResources true
            // 使用config签名
            // signingConfig signingConfigs.config
            // 混淆文件位置
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'

            // 批量打包
            applicationVariants.all { variant ->
                variant.outputs.each { output ->
                    def outputFile = output.outputFile
                    if (outputFile != null && outputFile.name.endsWith('.apk')) {
                        //输出apk名称为：渠道名_版本名_时间.apk
                        def fileName = "${variant.productFlavors[0].name}_v${defaultConfig.versionName}_${releaseTime()}.apk"
                        output.outputFile = new File(outputFile.parent, fileName)
                    }
                }
            }

        }
    }
}

//项目依赖
dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.3.0'
}

local.properties

## This file is automatically generated by Android Studio.
# Do not modify this file -- YOUR CHANGES WILL BE ERASED!
#
# This file should *NOT* be checked into Version Control Systems,
# as it contains information specific to your local configuration.
#
# Location of the SDK. This is only used by Gradle.
# For customization when using a Version Control System, please read the
# header note.

sdk.dir=E\:\\Android-Sdk

#对应自己实际的证书路径和名字，在这里由于签名文件是放在app目录下，没有写绝对路径
keystroe_storeFile=keystore.jks
keystroe_storePassword=123456
keystroe_keyAlias=HomeKey
keystroe_keyPassword=123456

注意事项

signingConfigs

signingConfigs中主要是为打包配置签名文件具体信息的，这里使用了两种方式

第一种方式把签名文件的位置、storePassword、keyAlias、keyPassword 等具体内容都直接写在其中，然后使用Gradle进行打包
第二种是通过使用local.properties文件间接加载签名文件的具体信息。

一般我们更倾向于第二种方法，这样有助于保护签名文件（在local.properties中不能有中文）

productFlavors

不同渠道的设置基本都是在 productFlavors 中设置的，在里面想要添加多少个渠道都可以。

修改app名称

resValue "string", "app_name", "腾讯"
resValue "bool", "auto_updates", 'true'

通过resValue 我们可以在 string.xml 里面添加一个新的字段app_name，由于是添加，所以原来的string.xml 文件中不能存在app_name字段，否则会报错。

当然我们还可以添加布尔类型，还可以为color.xml、dimen.xml添加一些我们需要的字段。

修改app图标

当我们在productFlavors 中添加了不同渠道环境名称之后，我们还可以在mian文件夹同层级中建立和baidu，qq，xiaomi名称对应的文件夹，并放入特定的图标文件，当然我们还可以放入其他资源文件，甚至AndroidManifest.xml都可以放入，Gradle在构建应用时，会优先使用flavor所属dataSet中的同名资源。所以，在flavor的dataSet中添加同名的资源文件，会覆盖默认的资源文件，这样就能达到不同环境不同软件图标的功能。

不同环境，修改 AndroidManifest.xml 里渠道变量

① 在 AndroidManifest.xml 里添加渠道变量

<application
    android:icon="${app_icon}"
    android:label="@string/app_name"
    android:theme="@style/AppTheme">
    ...
    <meta-data
        android:name="CHANNEL"
        android:value="${CHANNEL_VALUE}" />
    ...
</application>

② 在 build.gradle 设置 productFlavors

productFlavors {
    baidu {
        manifestPlaceholders = [CHANNEL_VALUE: "baidu", app_icon: "@mipmap/logo_baidu"]
    }
    qq {
        manifestPlaceholders = [CHANNEL_VALUE: "qq", app_icon: "@mipmap/icon_qq"]]
    }
    xiaomi {
        manifestPlaceholders = [CHANNEL_VALUE: "xiaomi", app_icon: "@mipmap/icon_xiaomi"]]
    }
}

这样我们可以在不同环境使用不同的 key 值。