環(huán)境
OSX
AndroidStudio 1.0
多渠道設(shè)置
渠道號(hào)
以友盟SDK為例,打包多渠道:GooglePlay纯露,小米,友盟代芜,360埠褪,豌豆莢,應(yīng)用寶挤庇。
在AndroidManifest.xml
中加入渠道區(qū)分標(biāo)識(shí)
<meta-data
android:name="UMENG_CHANNEL"
android:value="${UMENG_CHANNEL_VALUE}" />
然后在build.gradle(Module: app)
中加入渠道打包替換對應(yīng)的UMENG_CHANNEL_VALUE
代碼
// 渠道Flavors钞速,配置不同的渠道
productFlavors {
GooglePlay {}
xiaomi {}
umeng {}
qihu360 {}
wandoujia {}
yingyongbao {}
//其他...
}
// 批量配置渠道
productFlavors.all {
flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name]
}
apk名字
我們還可以指定不同渠道號(hào)生成的apk的名字,這樣方便打包出來區(qū)別哪個(gè)apk是對應(yīng)哪個(gè)渠道的嫡秕。以下的例子生成的命名格式 app_v(版本號(hào))_打包時(shí)間_渠道號(hào).apk
android{
applicationVariants.all { variant ->
variant.outputs.each { output ->
def outputFile = output.outputFile
if (outputFile != null && outputFile.name.endsWith('.apk')) {
File outputDirectory = new File(outputFile.parent);
def fileName
if (variant.buildType.name == "release") {
fileName = "app_v${defaultConfig.versionName}_${packageTime()}_${variant.productFlavors[0].name}.apk"
} else {
fileName = "app_v${defaultConfig.versionName}_${packageTime()}_beta.apk"
}
output.outputFile = new File(outputDirectory, fileName)
}
}
}
}
打包
簽名文件
生成簽名文件可用命令行生成渴语,也可以直接用AndroidStudio的Build -> Generate signed apk -> create new
生成新證書即可。然后為了方便昆咽,這里我把證書放到 項(xiàng)目 -> app
目錄下驾凶。
簽名配置
gradle支持直接簽名打包,只需要設(shè)置一下證書的路徑和對應(yīng)密碼一鍵打包出正式可以發(fā)布的apk掷酗。
在signingConfigs
里面寫上對應(yīng)的storeFile
调违,storePassword
,keyAlias
泻轰,keyPassword
一般地技肩,為了保護(hù)簽名文件,這些信息不應(yīng)該寫入到版本庫中浮声,我這里把它們寫在local.properties
中然后在版本庫中排除這個(gè)文件虚婿。
//獲取local.properties的內(nèi)容
//這里是讀取local.properties文件殖告,提供給下方代碼用來提取keystroe_storeFile等key的值
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
signingConfigs {
release {
// relase簽名
storeFile file(properties.getProperty("keystroe_storeFile"))
storePassword properties.getProperty("keystroe_storePassword")
keyAlias properties.getProperty("keystroe_keyAlias")
keyPassword properties.getProperty("keystroe_keyPassword")
}
}
在local.properties
文件中加入
keystroe_storeFile=keystore.jks //對應(yīng)自己實(shí)際的證書路徑和名字,因?yàn)槲疑厦嫣岬?把證書放在 項(xiàng)目的app目錄下雳锋,所以不用寫絕對路徑黄绩。
keystroe_storePassword=123456
keystroe_keyAlias=alias
keystroe_keyPassword=123456
打包apk
在終端窗口,或者可以使用AndroidStudio工具欄下面提供的終端 Terminal 玷过,cd 到 項(xiàng)目根目錄下執(zhí)行:
// 打包出上面所有渠道apk
./gradlew build
// 下面這行例子是單獨(dú)打包wandoujia渠道的apk
// ./gradlew assembleWandoujia
對應(yīng)渠道的apk就會(huì)自動(dòng)在 項(xiàng)目/app/build/outputs/apk/
目錄下按照上面指定的命名格式生成了爽丹。
產(chǎn)品定制
ApplicationId,版本號(hào)
Android 應(yīng)用都有自己的包名辛蚊。包名是設(shè)備上每個(gè)應(yīng)用程序的唯一標(biāo)識(shí)粤蝎,同樣也是在各個(gè)下載平臺(tái)的唯一標(biāo)識(shí)。就是說袋马,假如你已經(jīng)使用某個(gè)包名來發(fā)布應(yīng)用初澎,就不能再去改變應(yīng)用的包名,因?yàn)檫@樣做會(huì)導(dǎo)致你的應(yīng)用被視為一個(gè)全新的應(yīng)用虑凛,你現(xiàn)有的用戶也不會(huì)收到應(yīng)用的更新通知碑宴。
有時(shí)候我們需要發(fā)布不同的版本,例如 pro桑谍,hd 版本延柠,支持用戶可以下載安裝不同的版本。那么我們需要設(shè)置不同的ApplicationId和對應(yīng)的版本號(hào)锣披, 同時(shí)要與 PackageName 解耦合贞间。
代碼中引用的 R 類要保持不變;
在構(gòu)建不同版本的應(yīng)用時(shí)雹仿,對應(yīng)的(引用了 R 的) .java 源文件也不能改動(dòng)增热。
那么我們只需要在productFlavors
對應(yīng)的渠道中指定applicationId
和versionCode,versionName
胧辽,例我們指定GooglePlay的applicationId
:
productFlavors {
GooglePlay {
//指定這個(gè)渠道的版本號(hào)
versionCode 2
versionName "2.0"
//指定區(qū)別于其他渠道的 applicationId
applicationId "com.bigkoo.gradledemo.hd"
}
xiaomi {}
umeng {}
qihu360 {}
wandoujia {}
yingyongbao {}
//其他...
}
BuildConfig
Gradle會(huì)在generateSources階段為flavor生成一個(gè)BuildConfig.java
文件峻仇。BuildConfig類默認(rèn)提供了一些常量字段,比如應(yīng)用的版本名(VERSION_NAME
)票顾,應(yīng)用的包名(PACKAGE_NAME
)等础浮。更強(qiáng)大的是帆调,開發(fā)者還可以添加自定義的一些字段奠骄。下面的示例假設(shè)debug
版開啟LOG
功能,使用test的api
番刊,而發(fā)布版則使用不開啟LOG
和使用發(fā)布時(shí)的api
:
buildTypes {
debug {
// debug模式下含鳞,顯示log
buildConfigField("boolean", "LOG_DEBUG", "true")
buildConfigField ("String", "API_HOST", "\"http://api.test.com\"")//API Host
}
release {
// release模式下,不顯示log
buildConfigField("boolean", "LOG_DEBUG", "false")
buildConfigField("String", "API_HOST", "\"http://api.release.com\"")//API Host
}
}
那么代碼中就可以使用 BuildConfig.LOG_DEBUG 和 BuildConfig.API_HOST 了芹务。
甚至可以在productFlavors
對應(yīng)的渠道號(hào)進(jìn)行區(qū)別蝉绷,例如豌豆莢版默認(rèn)禁止版本自動(dòng)更新:
android {
defaultConfig {
buildConfigField "boolean", "AUTO_UPDATES", "true"
}
productFlavors {
wandoujia {
buildConfigField "boolean", "AUTO_UPDATES", "false"
}
}
}
資源
通常對于不同渠道鸭廷,我們會(huì)區(qū)別不同的資源。例如我們一款應(yīng)用需要在360發(fā)布熔吗,而應(yīng)用圖標(biāo)和歡迎界面要一個(gè)360標(biāo)志的圖辆床,那么這個(gè)時(shí)候就需要按渠道打包對應(yīng)的應(yīng)用圖標(biāo)和歡迎圖片了。Gradle在構(gòu)建應(yīng)用時(shí)桅狠,會(huì)優(yōu)先使用flavor
所屬dataSet
中的同名資源讼载。所以,在flavor
的dataSet
中添加同名的字符串資源中跌,以覆蓋默認(rèn)的資源咨堤。
上面我們已經(jīng)有針對360的渠道了,就是qihu360
漩符,我們只需要在 app/src/
目錄下添加渠道對應(yīng)的文件夾qihu360
一喘,然后覆蓋對應(yīng)要覆蓋的內(nèi)容。下面是定制應(yīng)用圖標(biāo)的步驟:
添加qihu360文件夾嗜暴,那么在
app/src/
目錄下面就有 main , androidTest , qihu360 這三個(gè)文件夾了凸克。main 目錄是通用正常渠道包目錄,qihu360是我們需要定制資源的渠道包目錄闷沥。仿main的目錄触徐,添加
res/drawable/ic_launcher.png
圖片以覆蓋對應(yīng)在 main里面的res/drawable/ic_launcher.png
通過以上例子,舉一反三狐赡。定制其他資源撞鹉,包括strings.xml
, styles.xml
甚至AndroidManifest.xml
也都是可以的颖侄。
第三方庫
有些渠道需要加入廣告鸟雏,應(yīng)用墻推薦,而有些則不上廣告览祖,我們常常也會(huì)遇到這樣的問題吧孝鹊。那么現(xiàn)在來說說怎么對于第三方庫進(jìn)行渠道區(qū)分打包。
這里以我的開源項(xiàng)目 為例展蒂,其他庫或廣告SDK同理:
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
compile 'com.android.support:appcompat-v7:21.0.3'
//參與編譯but不參與打包
provided 'com.bigkoo:alertview:1.0.1'
//指定qihu360這個(gè)渠道可以打包這個(gè)庫
qihu360Compile 'com.bigkoo:alertview:1.0.1'
}
然后在代碼中進(jìn)行反射判斷是否有這個(gè)庫存在又活,如果有就使用,沒有就不使用锰悼。(或者用上面提及的BuildConfig方式設(shè)置一個(gè)渠道常量來判斷也可以)
public class MainActivity extends Activity {
private boolean useAlertView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
try {
Class.forName("com.bigkoo.alertview.AlertView");
useAlertView = true;
} catch (ClassNotFoundException ignored) {
}
}
public void showAlertView(View view) {
if(useAlertView) {
new AlertView("標(biāo)題", "內(nèi)容", null, new String[]{"確定"}, null, this, AlertView.Style.Alert, null).show();
}
}
}
總結(jié)
常用的多渠道打包方式已經(jīng)介紹完了柳骄,基本能滿足日常大部分多渠道打包開發(fā)使用。如果你想更深入了解箕般,請看Groovy耐薯,自己來定制一些任務(wù)。
本文參考
Gradle
美團(tuán)Android自動(dòng)化之旅—適配渠道包
安卓集成發(fā)布詳解(二)
源碼
本文例子的源碼放在我的Github上了,地址:GradleDemo (PS:例子為了提供完整的演示曲初,沒有在.gitigonore
里面加入 /local.properties
排除体谒,實(shí)際是要加入的,另外簽名文件也一并附上了臼婆,也實(shí)際是需要排除的抒痒。)