看完這篇你學(xué)到什么:
- 熟悉gradle的構(gòu)建配置
- 熟悉代碼構(gòu)建環(huán)境的目錄結(jié)構(gòu)铡恕,你知道的不僅僅是只有src/main
- 開(kāi)發(fā)铁材、生成環(huán)境等等環(huán)境可以任意切換打包
- 多渠道打包
- APK輸出文件配置
需求
一般我們開(kāi)發(fā)的環(huán)境分為:debug 和 release问慎,但是你想再分內(nèi)測(cè)1環(huán)境型雳、內(nèi)測(cè)2環(huán)境等等怎么辦呢骂删?
這就需要依賴(lài)強(qiáng)大的gradle 來(lái)配置了。
相關(guān)的配置也可以參考谷歌官方文檔四啰。
配置構(gòu)建類(lèi)型 buildTypes
名詞解析:我們通常會(huì)分不同的編譯環(huán)境進(jìn)行打包宁玫,比如有debug、release柑晒、beta等環(huán)境參數(shù)欧瘪,像這種我們就稱(chēng)之為buildTypes.
您可以在模塊級(jí) build.gradle 文件的 android {} 代碼塊內(nèi)部創(chuàng)建和配置構(gòu)建類(lèi)型。當(dāng)您創(chuàng)建新模塊時(shí)匙赞,Android Studio 會(huì)自動(dòng)為您創(chuàng)建調(diào)試和發(fā)布這兩種構(gòu)建類(lèi)型佛掖。盡管調(diào)試構(gòu)建類(lèi)型不會(huì)出現(xiàn)在構(gòu)建配置文件中,Android Studio 會(huì)將其配置為 debuggable true涌庭。這樣芥被,您可以在安全的 Android 設(shè)備上調(diào)試應(yīng)用并使用通用調(diào)試密鑰庫(kù)配置 APK 簽署。
如果您希望添加或更改特定設(shè)置坐榆,您可以將調(diào)試構(gòu)建類(lèi)型添加到您的配置中拴魄。以下示例為調(diào)試構(gòu)建類(lèi)型指定了 applicationIdSuffix,并配置了一個(gè)使用調(diào)試構(gòu)建類(lèi)型中的設(shè)置進(jìn)行初始化的jnidebug構(gòu)建類(lèi)型席镀。
applicationIdSuffix: 字段表示匹中,在不改變你默認(rèn)的程序ID(包名)的情況下,為其添加后綴豪诲。比如你的包名是com.rae.app顶捷,但你想?yún)^(qū)分測(cè)試包和正式包的情況,這個(gè)時(shí)候?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)建類(lèi)型(比如debug葵蒂、release)區(qū)分不同的源文件,這樣對(duì)應(yīng)建立的文件夾就是一個(gè)不同的構(gòu)建源重虑。打個(gè)比方刹勃,debug的構(gòu)建源為src/debug,release的構(gòu)建源為src/release嚎尤,而在src/main定義的為公共資源荔仁,最后在構(gòu)建的時(shí)候會(huì)進(jìn)行合并操作。
Android Studio 按邏輯關(guān)系將每個(gè)模塊的源代碼和資源分組為源集芽死。模塊的 main/ 源集包括其所有構(gòu)建變體共用的代碼和資源乏梁。其他源集目錄為可選項(xiàng),在您配置新的構(gòu)建變體時(shí)关贵,Android Studio 不會(huì)自動(dòng)為您創(chuàng)建這些目錄遇骑。不過(guò),創(chuàng)建類(lèi)似于 main/ 的源集有助于讓 Gradle 只應(yīng)在構(gòu)建特定應(yīng)用版本時(shí)使用的文件和資源井然有序:
構(gòu)建源的命名規(guī)則如下:
productFlavor 表示渠道包揖曾,可以看下面的多渠道打包
- src/main/ 此源集包括所有構(gòu)建變體共用的代碼和資源落萎。
- src/<buildType>/ 創(chuàng)建此源集可加入特定構(gòu)建類(lèi)型專(zhuān)用的代碼和資源。示例:src/jnidebug
- src/<productFlavor>/ 創(chuàng)建此源集可加入特定產(chǎn)品風(fēng)味專(zhuān)用的代碼和資源炭剪。比如百度渠道包:src/baidu
- src/<productFlavorBuildType>/ 創(chuàng)建此源集可加入特定構(gòu)建變體專(zhuān)用的代碼和資源练链。
例如,要生成應(yīng)用的“完全調(diào)試”版本奴拦,構(gòu)建系統(tǒng)需要合并來(lái)自以下源集的代碼媒鼓、設(shè)置和資源。比如:百度的開(kāi)發(fā)環(huán)境包:src/baiduDebug
構(gòu)建類(lèi)型的依賴(lài)配置
很多時(shí)候我們會(huì)把sdk或者api接口單獨(dú)做成一個(gè)庫(kù)错妖,一般會(huì)有生產(chǎn)環(huán)境和測(cè)試環(huán)境之分绿鸣,但在依賴(lài)的時(shí)候往往我們會(huì)像這樣去引用:compile project(':sdk'),這樣依賴(lài)的環(huán)境就是release暂氯,在開(kāi)發(fā)調(diào)試的時(shí)候測(cè)試環(huán)境的時(shí)候就不行了潮模。我們得換另外一種方式:
<buildType>Compile project()
這樣會(huì)根據(jù)不同的構(gòu)建類(lèi)型去依賴(lài)不同的包,比如我們測(cè)試環(huán)境的依賴(lài)包:debugCompile project(':sdk')痴施,再比如上面的jnidebug:jnidebugCompile project(':sdk')
那么問(wèn)題來(lái)了擎厢,我當(dāng)前的構(gòu)建類(lèi)型怎么對(duì)應(yīng)到其他的module去呢?比如你的app要依賴(lài)sdk module 的debug 環(huán)境晾剖,那么你可以這么做:
configuration:目標(biāo)module的<buildType>锉矢,比如你sdk 中<buildType>的debug構(gòu)建類(lèi)型
debugCompile project(path: ':sdk', configuration: 'debug')
綜合示例
- 先看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)建類(lèi)型,名字隨便取齿尽,一定要有意義
raedebug {
initWith debug
applicationIdSuffix '.raedebug'
}
}
}
dependencies {
// 生成環(huán)境依賴(lài)
releaseCompile project(path: ':sdk', configuration: 'release')
// 測(cè)試環(huán)境依賴(lài)
debugCompile project(path: ':sdk', configuration: 'debug')
// 自定義構(gòu)建類(lèi)型依賴(lài)
raedebugCompile project(path: ':sdk', configuration: 'uutest')
}
- 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'
}
// 注意這里,跟第一點(diǎn)的 raedebugCompile project的configuration要匹配灯节。
uutest {
initWith debug
}
}
}
渠道打包 productFlavors
先看看build.gradle配置你就懂了
android{
// 渠道包定義循头,默認(rèn)定義的名稱(chēng)就是渠道名稱(chēng)
productFlavors {
dev {} // 測(cè)試
baidu {} // 百度手機(jī)助手
yinyongbao {} // 應(yīng)用寶
m360 {} // 360手機(jī)助手
pp {} // PP助手
anzhi{} // 安智市場(chǎng)
xiaomi {} // 小米商店
letv {} // 樂(lè)視商店
huawei {} // 華為商店
lenovomm {} // 聯(lián)想樂(lè)商店
other {} // 其他市場(chǎng)
official{} // 官方版本
}
// 批量渠道包值替換
productFlavors.all { flavor ->
// 友盟绵估、極光推送渠道包, UMENG_CHANNEL 是根據(jù)你AndroidManifest.xml來(lái)配置的卡骂,請(qǐng)看下面国裳。
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">
<!--變量采用${變量名}這樣來(lái)替換,不僅限與<meta-data /> 標(biāo)簽全跨,任何你想替換的都行缝左。-->
<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 面板也相對(duì)應(yīng)多了這些構(gòu)建類(lèi)型浓若。
APK輸出配置
在結(jié)合到多渠道打包后渺杉,運(yùn)營(yíng)的那邊希望我們給的渠道包是這種格式的app-{版本號(hào)}-{渠道名稱(chēng)}.apk,那我們來(lái)看看怎么來(lái)滿(mǎn)足這個(gè)多渠道打包輸出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"
// 比如不想這么麻煩是越,直接在后面加上版本號(hào)也行:
// def fileName = outputFile.name.replace(".apk", "-${defaultConfig.versionName}.apk")
output.outputFile = new File(dirName, fileName)
}
}
}
}
上面介紹的多渠道打包是采用gralde默認(rèn)的配置,但有個(gè)弊端是每個(gè)渠道包都會(huì)重新編譯一次碌上,編譯速度慢倚评。