Gradle實戰:Android多渠道打包方案彙總

枚杉發表於2016-09-19

原文地址: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 Studio系列教程六–Gradle多渠道打包
Android產品研發(五)–>多渠道打包
更便捷的 Android 多渠道打包方式
Android打包系列——多渠道快速打包

相關文章