Android 多渠道打包配置

看完這篇你學(xué)到什么:

  • 熟悉gradle的構(gòu)建配置
  • 熟悉代碼構(gòu)建環(huán)境的目錄結(jié)構(gòu),你知道的不僅僅是只有src/main
  • 開發(fā)、生成環(huán)境等等環(huán)境可以任意切換打包
  • 多渠道打包
  • APK輸出文件配置

需求

一般我們開發(fā)的環(huán)境分為:debug 和 release,但是你想再分內(nèi)測1環(huán)境、內(nèi)測2環(huán)境等等怎么辦呢?

這就需要依賴強大的gradle 來配置了。

相關(guān)的配置也可以參考谷歌官方文檔。

配置構(gòu)建類型 buildTypes

名詞解析我們通常會分不同的編譯環(huán)境進行打包,比如有debug、release、beta等環(huán)境參數(shù),像這種我們就稱之為buildTypes.

您可以在模塊級 build.gradle 文件的 android {} 代碼塊內(nèi)部創(chuàng)建和配置構(gòu)建類型。當您創(chuàng)建新模塊時,Android Studio 會自動為您創(chuàng)建調(diào)試和發(fā)布這兩種構(gòu)建類型。盡管調(diào)試構(gòu)建類型不會出現(xiàn)在構(gòu)建配置文件中,Android Studio 會將其配置為 debuggable true。這樣,您可以在安全的 Android 設(shè)備上調(diào)試應(yīng)用并使用通用調(diào)試密鑰庫配置 APK 簽署。

如果您希望添加或更改特定設(shè)置,您可以將調(diào)試構(gòu)建類型添加到您的配置中。以下示例為調(diào)試構(gòu)建類型指定了 applicationIdSuffix,并配置了一個使用調(diào)試構(gòu)建類型中的設(shè)置進行初始化的jnidebug構(gòu)建類型。

applicationIdSuffix: 字段表示,在不改變你默認的程序ID(包名)的情況下,為其添加后綴。比如你的包名是com.rae.app,但你想?yún)^(qū)分測試包和正式包的情況,這個時候?qū)pplicationIdSuffix設(shè)置為.debug,那么你的應(yīng)用程序?qū)?yīng)的包名就變成了com.rae.app.debug

android {
    ...
    defaultConfig {...}
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }

        debug {
            applicationIdSuffix ".debug"
        }

        /**
         * The 'initWith' property allows you to copy configurations from other build types,
         * so you don't have to configure one from the beginning. You can then configure
         * just the settings you want to change. The following line initializes
         * 'jnidebug' using the debug build type, and changes only the
         * applicationIdSuffix and versionNameSuffix settings.
         */

        jnidebug {

            // This copies the debuggable attribute and debug signing configurations.
            initWith debug

            applicationIdSuffix ".jnidebug"
            jniDebuggable true
        }
    }
}

構(gòu)建源集

名詞解析: 通常源代碼是放在src/main 文件夾下的,但你想可以根據(jù)不同的構(gòu)建類型(比如debug、release)區(qū)分不同的源文件,這樣對應(yīng)建立的文件夾就是一個不同的構(gòu)建源。打個比方,debug的構(gòu)建源為src/debug,release的構(gòu)建源為src/release,而在src/main定義的為公共資源,最后在構(gòu)建的時候會進行合并操作。

Android Studio 按邏輯關(guān)系將每個模塊的源代碼和資源分組為源集。模塊的 main/ 源集包括其所有構(gòu)建變體共用的代碼和資源。其他源集目錄為可選項,在您配置新的構(gòu)建變體時,Android Studio 不會自動為您創(chuàng)建這些目錄。不過,創(chuàng)建類似于 main/ 的源集有助于讓 Gradle 只應(yīng)在構(gòu)建特定應(yīng)用版本時使用的文件和資源井然有序:

構(gòu)建源的命名規(guī)則如下:
productFlavor 表示渠道包,可以看下面的多渠道打包

  • src/main/ 此源集包括所有構(gòu)建變體共用的代碼和資源。
  • src/<buildType>/ 創(chuàng)建此源集可加入特定構(gòu)建類型專用的代碼和資源。示例:src/jnidebug
  • src/<productFlavor>/ 創(chuàng)建此源集可加入特定產(chǎn)品風(fēng)味專用的代碼和資源。比如百度渠道包:src/baidu
  • src/<productFlavorBuildType>/ 創(chuàng)建此源集可加入特定構(gòu)建變體專用的代碼和資源。

例如,要生成應(yīng)用的“完全調(diào)試”版本,構(gòu)建系統(tǒng)需要合并來自以下源集的代碼、設(shè)置和資源。比如:百度的開發(fā)環(huán)境包:src/baiduDebug

構(gòu)建類型的依賴配置

很多時候我們會把sdk或者api接口單獨做成一個庫,一般會有生產(chǎn)環(huán)境和測試環(huán)境之分,但在依賴的時候往往我們會像這樣去引用:compile project(':sdk'),這樣依賴的環(huán)境就是release,在開發(fā)調(diào)試的時候測試環(huán)境的時候就不行了。我們得換另外一種方式:

<buildType>Compile project()

這樣會根據(jù)不同的構(gòu)建類型去依賴不同的包,比如我們測試環(huán)境的依賴包:debugCompile project(':sdk'),再比如上面的jnidebug:jnidebugCompile project(':sdk')

那么問題來了,我當前的構(gòu)建類型怎么對應(yīng)到其他的module去呢?比如你的app要依賴sdk module 的debug 環(huán)境,那么你可以這么做:

configuration:目標module的<buildType>,比如你sdk 中<buildType>的debug構(gòu)建類型

debugCompile project(path: ':sdk', configuration: 'debug')

綜合示例

  1. 先看app這邊的build.gradle配置:
apply plugin: 'com.android.application'

android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        debug {
            applicationIdSuffix '.debug'
            minifyEnabled false
        }
        
        // 自定義的構(gòu)建類型,名字隨便取,一定要有意義
        raedebug {
            initWith debug
            applicationIdSuffix '.raedebug'
        }
    }
}

dependencies {
    // 生成環(huán)境依賴
    releaseCompile project(path: ':sdk', configuration: 'release')
    // 測試環(huán)境依賴
    debugCompile project(path: ':sdk', configuration: 'debug')
    // 自定義構(gòu)建類型依賴
    raedebugCompile project(path: ':sdk', configuration: 'uutest')
}

  1. sdk module的build.gradle配置:
apply plugin: 'com.android.library'

android {
       buildTypes {
        debug {
            debuggable true
            minifyEnabled false
        }
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        
        // 注意這里,跟第一點的 raedebugCompile project的configuration要匹配。
        uutest {
            initWith debug
        }
    }
}


渠道打包 productFlavors

先看看build.gradle配置你就懂了

android{

    // 渠道包定義,默認定義的名稱就是渠道名稱
    productFlavors {
 
        dev {} // 測試
        baidu {}        // 百度手機助手
        yinyongbao {}   // 應(yīng)用寶
        m360 {}         // 360手機助手
        pp {}           // PP助手
        anzhi{}         // 安智市場
        xiaomi {}       // 小米商店
        letv {}         // 樂視商店
        huawei {}       // 華為商店
        lenovomm {}     // 聯(lián)想樂商店
        other {}        // 其他市場
        official{}      // 官方版本
 
    }
 
    // 批量渠道包值替換
    productFlavors.all { flavor ->
        // 友盟、極光推送渠道包, UMENG_CHANNEL 是根據(jù)你AndroidManifest.xml來配置的,請看下面。
        flavor.manifestPlaceholders = [UMENG_CHANNEL: name, JPUSH_CHANNEL: name]
    }
}

AndroidManifest.xml 配置:


<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.rae.demo">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
       
       <!--變量采用${變量名}這樣來替換,不僅限與<meta-data /> 標簽,任何你想替換的都行。-->
         <meta-data
            android:name="UMENG_APPKEY"
            android:value="${UMENG_APPKEY}"/>
        
        <meta-data
            android:name="UMENG_CHANNEL"
            android:value="${UMENG_CHANNEL}"/>
        
        <!--${變量隨變換}-->   
        <activity
            android:name=".DemoActivity"
            android:label="${變量隨變換}"/>
            
    </application>

</manifest>

sync gradle之后看看gradle projects 面板列表就多出了好到渠道的任務(wù)了,Build Variants 面板也相對應(yīng)多了這些構(gòu)建類型。

APK輸出配置

在結(jié)合到多渠道打包后,運營的那邊希望我們給的渠道包是這種格式的app-{版本號}-{渠道名稱}.apk,那我們來看看怎么來滿足這個多渠道打包輸出apk文件名修改的。

android{

    // 輸出文件配置
   applicationVariants.all { variant ->
        variant.outputs.each { output ->
            def outputFile = output.outputFile
            if (outputFile != null && outputFile.name.endsWith('.apk')) {
                def dirName = outputFile.parent // 輸出文件夾所在的位置
            
                // 文件名修改
                def fileName = "app-${output.processResources.variantName}-${defaultConfig.versionName}-${variant.flavorName}.apk"
                
                // 比如不想這么麻煩,直接在后面加上版本號也行:
                // def fileName = outputFile.name.replace(".apk", "-${defaultConfig.versionName}.apk")
                
                
                output.outputFile = new File(dirName, fileName)
            }
        }
    }
}

上面介紹的多渠道打包是采用gralde默認的配置,但有個弊端是每個渠道包都會重新編譯一次,編譯速度慢。

喜歡請點擊+關(guān)注哦

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • 1.介紹 如果你正在查閱build.gradle文件的所有可選項,請點擊這里進行查閱:DSL參考 1.1新構(gòu)建系統(tǒng)...
    Chuckiefan閱讀 12,355評論 8 72
  • 版權(quán)聲明:本文為博主原創(chuàng)文章,未經(jīng)博主允許不得轉(zhuǎn)載。 https://blog.csdn.net/zhaoyanj...
    勤奮的pangdunhu閱讀 2,226評論 0 1
  • 文章來源:Google 此頁面以配置構(gòu)建概覽為基礎(chǔ),向您介紹如何配置構(gòu)建變體,以便從同一個項目中創(chuàng)建應(yīng)用的不同版本...
    文文太遠了閱讀 855評論 0 1
  • 這一章主要針對項目中可以用到的一些實用功能來介紹Android Gradle,比如如何隱藏我們的證書文件,降低風(fēng)險...
    acc8226閱讀 7,960評論 3 25
  • 又到學(xué)期末,又是離別時。 “老師,9月份你還教我們嗎?”這是今天上午散學(xué)典禮后孩子們圍著我問得最多的問題。 “這是...
    鹿鳴閣主閱讀 231評論 1 1

友情鏈接更多精彩內(nèi)容