Android Gradle必備使用技巧健霹，未完待續(xù)速警，歡迎關(guān)注公眾號(hào)
flysnow_org，第一時(shí)間看后續(xù)技巧强霎。
在講批量修改APK文件名之前忿项，我們講一下關(guān)于Android Gradle插件集成的Task任務(wù)問題。普通的Java工程比較簡單脆栋，因?yàn)樗幸粋€(gè)有限的任務(wù)集合倦卖，而且它的屬性或者方法都是Java Gradle插件添加的，比較固定椿争，而且我們?cè)L問任務(wù)以及任務(wù)里的方法和屬性都比較方便怕膛，比如classes這個(gè)編譯Java源代碼的任務(wù)，我們通過project.tasks.classes就可以訪問它秦踪，非澈帜恚快捷。
但是對(duì)于Android工程椅邓，就不行了柠逞，Android工程相對(duì)與Java工程來說，要復(fù)雜的多景馁，因?yàn)樗泻芏嘞嗤娜蝿?wù)板壮，這些任務(wù)的名字都是通過Build Types和Product Flavors 生成的，是動(dòng)態(tài)的創(chuàng)建和生成的合住，而且時(shí)機(jī)比較靠后绰精，如果你還像原來一樣在某個(gè)閉包里通過project.tasks獲取一個(gè)任務(wù)，會(huì)提示找不到該任務(wù)透葛，因?yàn)檫€沒有生成笨使。
既然要修改生成的Apk文件名，那么我們就要修改Android Gradle打包的輸出僚害，為了解決上面提到的問題（不限于此）硫椰，android對(duì)象為我們提供了2個(gè)屬性：
- applicationVariants (僅僅適用于Android應(yīng)用Gradle插件)
- libraryVariants (僅僅適用于Android庫Gradle插件)
- testVariants (以上兩種Gradle插件都使用)
以上三個(gè)屬性返回的都是DomainObjectSet對(duì)象集合，里面元素分別是ApplicationVariant萨蚕、LibraryVariant和TestVariant靶草。這三個(gè)元素直譯來看是變體，通俗的講他們就是Android構(gòu)建的產(chǎn)物门岔，比如ApplicationVariant可以代表google渠道的release包爱致，也可以代表dev開發(fā)用的debug包，我們上面提到了寒随，他們基于Build Types和Product Flavors生成的產(chǎn)物糠悯。
特別注意的是帮坚，訪問以上這三種集合都會(huì)觸發(fā)創(chuàng)建所有的任務(wù)，這意味著訪問這些集合后無須重新配置就會(huì)產(chǎn)生互艾，也就是說假如我們通過訪問這些集合试和，修改生成Apk的輸出文件名，那么就會(huì)自動(dòng)的觸發(fā)創(chuàng)建所有任務(wù)纫普，此時(shí)我們修改后的新的Apk文件名就會(huì)起作用阅悍，達(dá)到可我們修改Apk文件名的目的，因?yàn)檫@些是一個(gè)集合昨稼，包含我們所有生成的產(chǎn)物节视，所以我們只需要進(jìn)行迭代，就可以達(dá)到我們批量修改Apk文件名的目的假栓。
com.android.build.gradle.AppExtension中的getApplicationVariants方法
/**
* Returns the list of Application variants. Since the collections is built after evaluation, it
* should be used with Gradle's <code>all</code> iterator to process future items.
*/
public DomainObjectSet<ApplicationVariant> getApplicationVariants() {
return applicationVariantList;
}
下面我們給出一個(gè)批量修改Apk文件名的例子
android {
compileSdkVersion 23
buildToolsVersion "23.0.1"
defaultConfig {
applicationId "org.flysnow.app"
minSdkVersion 14
targetSdkVersion 23
versionCode 1
versionName "1.0"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
zipAlignEnabled true
}
}
productFlavors {
google {
}
}
applicationVariants.all { variant ->
variant.outputs.each { output ->
if (output.outputFile != null && output.outputFile.name.endsWith('.apk')
&&'release'.equals(variant.buildType.name)) {
def flavorName = variant.flavorName.startsWith("_") ? variant.flavorName.substring(1) : variant.flavorName
def apkFile = new File(
output.outputFile.getParent(),
"App_${flavorName}_v${variant.versionName}_${buildTime()}.apk")
output.outputFile = apkFile
}
}
}
}
def buildTime() {
def date = new Date()
def formattedDate = date.format('yyyyMMdd')
return formattedDate
}
applicationVariants是一個(gè)DomainObjectCollection集合寻行，我們可以通過all方法進(jìn)行遍歷，遍歷的每一個(gè)variant都是一個(gè)生成的產(chǎn)物匾荆，針對(duì)示例拌蜘，共有g(shù)oogleRelease和googleDebug兩個(gè)產(chǎn)物，所以遍歷的variant共有g(shù)oogleRelease和googleDebug牙丽。
applicationVariants中的variant都是ApplicationVariant简卧，通過查看源代碼，可以看到它有一個(gè)outputs作為它的輸出烤芦，每一個(gè)ApplicationVariant至少有一個(gè)輸出举娩，也可以有多個(gè)，所以這里的outputs屬性是一個(gè)List集合构罗，我們?cè)俦闅v它晓铆，如果它的名字是以.apk結(jié)尾的話那么就是我們要修改的apk名字了，然后我們就可以根據(jù)需求绰播，修改成我們想要的名字。
我這里修改的是以項(xiàng)目名_渠道名_v版本名稱_構(gòu)建日期.apk格式生成的文件名尚困，這樣通過文件名就可以了解該apk的基本信息蠢箩，比如什么渠道，什么版本事甜，什么時(shí)候構(gòu)建的等等谬泌，最后生成的示例apk名字為App_google_v1.0_20170217.apk，大家可以運(yùn)行測(cè)試一下逻谦，注意buildTime這個(gè)我們自定義的返回日期格式的方法掌实。
Android Gradle必備使用技巧，未完待續(xù)邦马，歡迎關(guān)注公眾號(hào)flysnow_org贱鼻，第一時(shí)間看后續(xù)技巧宴卖。
