Android Gradle實(shí)用技巧(三) | 批量控制生成的APK文件名

Android Gradle必備使用技巧,未完待續(xù),歡迎關(guān)注公眾號(hào)flysnow_org,第一時(shí)間看后續(xù)技巧。

在講批量修改APK文件名之前,我們講一下關(guān)于Android Gradle插件集成的Task任務(wù)問(wèn)題。普通的Java工程比較簡(jiǎn)單,因?yàn)樗幸粋€(gè)有限的任務(wù)集合,而且它的屬性或者方法都是Java Gradle插件添加的,比較固定,而且我們?cè)L問(wèn)任務(wù)以及任務(wù)里的方法和屬性都比較方便,比如classes這個(gè)編譯Java源代碼的任務(wù),我們通過(guò)project.tasks.classes就可以訪問(wèn)它,非??旖?。

但是對(duì)于Android工程,就不行了,Android工程相對(duì)與Java工程來(lái)說(shuō),要復(fù)雜的多,因?yàn)樗泻芏嘞嗤娜蝿?wù),這些任務(wù)的名字都是通過(guò)Build Types和Product Flavors 生成的,是動(dòng)態(tài)的創(chuàng)建和生成的,而且時(shí)機(jī)比較靠后,如果你還像原來(lái)一樣在某個(gè)閉包里通過(guò)project.tasks獲取一個(gè)任務(wù),會(huì)提示找不到該任務(wù),因?yàn)檫€沒有生成。

既然要修改生成的Apk文件名,那么我們就要修改Android Gradle打包的輸出,為了解決上面提到的問(wèn)題(不限于此),android對(duì)象為我們提供了2個(gè)屬性:

  • applicationVariants (僅僅適用于Android應(yīng)用Gradle插件)
  • libraryVariants (僅僅適用于Android庫(kù)Gradle插件)
  • testVariants (以上兩種Gradle插件都使用)

以上三個(gè)屬性返回的都是DomainObjectSet對(duì)象集合,里面元素分別是ApplicationVariant、LibraryVariant和TestVariant。這三個(gè)元素直譯來(lái)看是變體,通俗的講他們就是Android構(gòu)建的產(chǎn)物,比如ApplicationVariant可以代表google渠道的release包,也可以代表dev開發(fā)用的debug包,我們上面提到了,他們基于Build Types和Product Flavors生成的產(chǎn)物。

特別注意的是,訪問(wèn)以上這三種集合都會(huì)觸發(fā)創(chuàng)建所有的任務(wù),這意味著訪問(wèn)這些集合后無(wú)須重新配置就會(huì)產(chǎn)生,也就是說(shuō)假如我們通過(guò)訪問(wè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集合,我們可以通過(guò)all方法進(jìn)行遍歷,遍歷的每一個(gè)variant都是一個(gè)生成的產(chǎn)物,針對(duì)示例,共有g(shù)oogleRelease和googleDebug兩個(gè)產(chǎn)物,所以遍歷的variant共有g(shù)oogleRelease和googleDebug。

applicationVariants中的variant都是ApplicationVariant,通過(guò)查看源代碼,可以看到它有一個(gè)outputs作為它的輸出,每一個(gè)ApplicationVariant至少有一個(gè)輸出,也可以有多個(gè),所以這里的outputs屬性是一個(gè)List集合,我們?cè)俦闅v它,如果它的名字是以.apk結(jié)尾的話那么就是我們要修改的apk名字了,然后我們就可以根據(jù)需求,修改成我們想要的名字。

我這里修改的是以項(xiàng)目名_渠道名_v版本名稱_構(gòu)建日期.apk格式生成的文件名,這樣通過(guò)文件名就可以了解該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ù)技巧。

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

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

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