關于Gradle配置的小結

使用 Android Studio 來開發 Android 工程的過程中，接觸 Gradle 是不可避免的，比如配置簽名、引入依賴等。那麼 Gradle 到底是什麼東西呢？ Gradle 是一個基于 Apache Ant 和 Apache Maven 概念的項目自動化建構工具。它使用一種基于 Groovy 的特定領域語言 (DSL) 來聲明項目設定，抛棄了基于 XML 的各種繁瑣配置。啰裡啰唆一堆，幸運的是，一般來說 Android 開發者隻要會配置 Gradle 就可以了，并不需要深入了解。那麼下面我們就來揭開 Gradle 的面紗吧。

Gradle 配置

與 Gradle 有關的檔案基本上分為四種：

app 下的 build.gradle (當然其他 module 下也有)；
根目錄下的 gradle 檔案夾；
根目錄下的build.gradle ；
根目錄下的 settings.gradle ；

也許有人會說根目錄下還有一個 config.gradle 檔案呢，其實這是我自定義的 gradle 檔案，自定義 Gradle 檔案會在下面中講解，這裡先擱置一下。好了，那麼我們一個一個地來看看他們的作用吧。

app 下的 build.gradle

apply plugin: 'com.android.application'
android {
    compileSdkVersion 23 // 編譯sdk版本
    buildToolsVersion "23.0.2" // 建構工具版本
    defaultConfig {
        applicationId "com.yuqirong.koku" // 應用包名
        minSdkVersion 15 // 最低适用sdk版本
        targetSdkVersion 23 // 目标sdk版本
        versionCode 1 // 版本号
        versionName "1.0" // 版本名稱
    }
    buildTypes {
        release {
            minifyEnabled true // 開啟混淆
            zipAlignEnabled true // 對齊zip
            shrinkResources false // 删除無用資源
            debuggable false // 是否debug
            versionNameSuffix "_release" // 版本命名字尾
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' // 混淆檔案
        }
debug {
            zipAlignEnabled false
            shrinkResources false
            minifyEnabled false
            versionNameSuffix "_debug"
            signingConfig signingConfigs.debug
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}
dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.2.1'
    compile 'com.android.support:design:23.2.1'
}

第一句 apply plugin: ‘com.android.application’ 主要用來申明這是一個 Android 程式。而 dependencies 用于引入依賴，這個相信大家都比較了解了。其他的配置比較簡單都有注釋，就不展開講了。

當然除了上面的配置之外，還有很多配置也常常寫入到 app/build.gradle 中。我們慢慢往下看。

簽名配置：

signingConfigs {
    
    release { // 正式版本的簽名
        storeFile file("../koku.jks") // 密鑰檔案位置
        storePassword "xxxxxxxxx" // 密鑰密碼
        keyAlias "koku" // 密鑰别名
        keyPassword "xxxxxxxxx" // 别名密碼
    }
    
    debug { // debug版本的簽名
        // no keystore
    }
}

使用時隻要在 buildTypes 的 release 中加一句 signingConfig signingConfigs.release 就好了。

如果你覺得把密鑰密碼和别名密碼放在 app/build.gradle 裡不安全，那麼可以把相關密碼放到不加入版本控制系統的 gradle.properties 檔案：

KEYSTORE_PASSWORD=xxxxxxxxxx
KEY_PASSWORD=xxxxxxxxx
對應的 signingConfigs 配置：

signingConfigs {
    release {
        try {
            storeFile file("../koku.jks")
            storePassword KEYSTORE_PASSWORD
            keyAlias "koku"
            keyPassword KEY_PASSWORD
        }
        catch (ex) {
            throw new InvalidUserDataException("You should define KEYSTORE_PASSWORD and KEY_PASSWORD in gradle.properties.")
        }
    }
}

Java 編譯版本配置：

compileOptions { // java 版本
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
}

這裡需要注意下，如果 Java 編譯版本為1.8的話，另外在 defaultConfig 裡要配置 Jack 編譯器：

jackOptions {
    enabled true
}

Lint 檢查配置：

lintOptions {
    abortOnError false // 是否忽略lint報錯
}

多管道資訊配置：

productFlavors {
    xiaomi {}
    googleplay {}
    wandoujia {}
}

整個 app/build.gradle 檔案配置如下所示：

apply plugin: 'com.android.application'

android {
    compileSdkVersion rootProject.ext.android.compileSdkVersion
    buildToolsVersion rootProject.ext.android.buildToolsVersion
    defaultConfig {
        applicationId "com.yuqirong.koku" // 應用包名
        minSdkVersion 15 // 最低适用sdk版本
        targetSdkVersion 23 // 目标sdk版本
        versionCode 1 // 版本号
        versionName "1.0" // 版本名稱
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
        // 預設是umeng的管道
        manifestPlaceholders = [UMENG_CHANNEL_VALUE: "umeng"]
        jackOptions {
            enabled true
        }
    }
    java 版本
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    signingConfigs {
        release {
            storeFile file("../koku.jks")
            storePassword "xxxxxx"
            keyAlias "koku"
            keyPassword "xxxxxx"
        }
        debug {
            // no keystore
        }
    }
    buildTypes {
        release {
            // 開啟混淆
            minifyEnabled true
            // 對齊zip
            zipAlignEnabled true
            // 删除無用資源
            shrinkResources false
            // 是否debug
            debuggable false
            // 命名字尾
            versionNameSuffix "_release"
            // 簽名
            signingConfig signingConfigs.release
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
            applicationVariants.all { variant ->
                variant.outputs.each { output ->
                    def outputFile = output.outputFile
                    if (outputFile != null && outputFile.name.endsWith('.apk')) {
                        // 輸出apk名稱為koku_v1.0_2015-01-15_wandoujia.apk
                        def fileName = "koku_v${defaultConfig.versionName}_${releaseTime()}_${variant.productFlavors[0].name}.apk"
                        output.outputFile = new File(outputFile.parent, fileName)
                    }
                }
            }
        }

        debug {
            zipAlignEnabled false
            shrinkResources false
            minifyEnabled false
            versionNameSuffix "_debug"
            signingConfig signingConfigs.debug
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
    lintOptions {
        abortOnError false
    }
    productFlavors {
        xiaomi {}
        googleplay {}
        wandoujia {}
    }
    //針對很多管道
    productFlavors.all {
        flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name]
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.2.1'
    compile 'com.android.support:design:23.2.1'
}

def releaseTime() {
    return new Date().format("yyyy-MM-dd", TimeZone.getTimeZone("UTC"))
}

再多嘴一句，有了以上的 build.gradle 配置之後，如果想使用 Gradle 多管道打包，需要在 AndroidManifest.xml 中申明：

<meta-data android:name="UMENG_CHANNEL" android:value="${UMENG_CHANNEL_VALUE}" />

最後使用指令 gradlew assembleRelease 打包即可。

根目錄下的 gradle 檔案夾

gradle 檔案夾中主要是 gradle-wrapper.properties 檔案比較重要，主要用來聲明 Gradle 目錄以及 Gradle 下載下傳路徑等：

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-2.14.1-all.zip

根目錄下的 build.gradle

根目錄下的 build.gradle 主要作用就是定義項目中公共屬性，比如有依賴倉庫、 Gradle 建構版本等：

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.2.1'
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
        mavenCentral()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

setting.gradle

setting.gradle 的作用就是一些子產品被包含後，會在這裡進行申明：

include ':app'

自定義 Gradle 檔案

在上面我們留了一個懸念，就是如何添加我們自定義的 Gradle 檔案。接下來我們就動手來實踐一下。在項目根目錄下建立檔案 config.gradle 。然後在根目錄下的 build.gradle 開頭添加一句

apply from: "config.gradle"

這句話就代表着把 config.gradle 添加進來了。然後我們可以在 config.gradle 中申明一些配置：

ext {

    android = [
            compileSdkVersion: 23,
            buildToolsVersion: "23.0.3",
            applicationId    : "com.yuqirong.koku",
            minSdkVersion    : 14,
            targetSdkVersion : 23,
            versionCode      : 3,
            versionName      : "1.4"
    ]

    dependencies = [
            "appcompat-v7"            : 'com.android.support:appcompat-v7:23.0.1',
            "recyclerview-v7"         : 'com.android.support:recyclerview-v7:24.2.1',
            "design"                  : 'com.android.support:design:23.0.1'
    ]
}

最後在 app/build.gradle 中去使用：

android {
    compileSdkVersion rootProject.ext.android.compileSdkVersion
    buildToolsVersion rootProject.ext.android.buildToolsVersion
    defaultConfig {
        applicationId rootProject.ext.android.applicationId
        minSdkVersion rootProject.ext.android.minSdkVersion
        targetSdkVersion rootProject.ext.android.targetSdkVersion
        versionCode rootProject.ext.android.versionCode
        versionName rootProject.ext.android.versionName

        jackOptions {
            enabled true
        }
    }
...
}


dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile rootProject.ext.dependencies["appcompat-v7"]
    compile rootProject.ext.dependencies["recyclerview-v7"]
    compile rootProject.ext.dependencies["design"]
}

從上面可以看到，我們把一些固定的配置“拎”出來放到 config.gradle 中，這樣以後直接更改 config.gradle 就行了，友善多人協作開發。

結束

關于 Gradle 的平時經常使用方法基本上就上面這些了。其他的一些比如 buildConfigField 之類的可以自行百度，相信聰明的你很快就會了。但是 Gradle 并沒有以上講得那麼簡單，還需要童鞋們繼續努力學習了。

關于Gradle配置的小結

Gradle 配置

app 下的 build.gradle

根目錄下的 gradle 檔案夾

根目錄下的 build.gradle

setting.gradle

繼續閱讀

Java小案例——随機數猜測随機數猜測

nginx location中斜線的位置的重要性

27 Best Free Eclipse Plug-ins for Java Developer to be ProductiveCode Quality PluginsText Editor PluginsDependency ManagementVersion Control Integration PluginsFramework Development Continuous Integration Related PluginsOther Utility Plugins

Java String.format方法的簡單使用

neo4j之cypher使用文檔

GitHub連夜封殺！這份阿裡 10W 字内部 Java 字面試手冊到底有多強？

spark/scala關于【資源檔案】加載方法概述外部檔案加載方案測試資源檔案打包入jar包中小結

mybatis_入門程式Mybatis入門

AOP程式設計_Android優雅權限架構(1)概念基礎，2021金三銀四前言正文大綱正文

Effective Java 8:通用程式設計

OOM三種類型

工廠模式-三種類型

【遞歸】高效率求2的n次幂

Android APK檔案反編譯Android APK檔案反編譯

win10本地scala和spark安裝安裝scala安裝spark

scala (3) Function 和 Method