快速了解Android Studio的Gradle

前言在閱讀本文章之前，期望你已經了解了這些內容：

• gradle是什么，它有哪些基本特性

• gradle task的基本概念和寫法

本人使用的環境：LUbuntu 14.04，AndroidStudio 1.3.2，其自帶Gradle 2.4

Gradle Scripts

使用AndroidStudio新建一個Android項目，一直默認直到創建完成，然后點開AndroidStudio左邊的Project面板，可以看到如下工程組織：

先簡單粗暴的來看看這些文件是什么鬼。

• build.gradle (Project: MyApplication)這是Android項目根目錄下的build.gradle，此文件名是一個約定名字，gradle將依賴它來構建項目。一個項目可以包括多個工程，gradle可以構建多個工程，每個工程子目錄都可以有build.gradle文件，如同make構建工具與Makefile文件的關系。我們做的大部分工作，也就是編寫和組織build.gradle文件。

• build.gradle (Module: app)這是Android項目根目錄/app/build.gradle，app是一個gradle工程，這里的build.gradle文件就是用來描述如何構建app工程，gradle可以支持構建多個工程，并設置工程之間的依賴關系。

• gradle-wrapper.properties

  Gradle Wrapper 是Android對gradle的使用進行一些必要的封裝而成的腳本——gradlew（位于項目根目錄下，用于命令行使用，在集成環境中非常有用），它會自動檢測當前項目指定的gradle版本是否存在，如果不存在則自己下載（保存在~/.gradle/wrapper/）。所以每一個Android項目下都有自己的gradle軟件包，官方建議把這些包也提交進源碼管理系統中，這樣編譯此項目的系統（如持續集成服務器）不需要事先（手動）安裝gradle。 gradle-wrapper.properties里的配置影響Gradle Wrapper的運作，其中distributionUrl屬性指定從哪里下載gradle，當然，如果我們不想讓它自己下載，可以用distributionPath指定手工下載的本地的gradle包。（進階：具它wrapper相關的設置參見： Wrapper API ）

  另外，Android默認創建了一個叫wrapper的gralde task，通過使用這個task，就可以在工程的build.gradle里面訪問和修改wrapper屬性。

• proguard-rules.proproguard是一個用來混淆java代碼的開源項目，Android項目把它集成了進來，先不管。

• gradle.properties因為gradle是java程序，它將在JVM環境中運行，此文件用來指定gradle如何運行（或叫構建環境），包括：

  1. 開啟gradle的daemon并行構建模式，設置JVM內存參數，加速構建。

  2. 可以自定義屬性（key和value），這些屬性可以傳遞給gradle的java程序，也可以被build.grade訪問。

• 1. 設置代理。

     現在此文件默認什么都沒配置，先不管。

• settings.gradle

  這個文件也是gradle約定命名的，默認只有一行代碼 include ':app' ，表示當前項目只有一個模塊（我們習慣叫工程，gradle習慣叫模塊），app是目錄名，同時也作為工程名。當有多個工程的時候，可以在此添加。

• local.properties默認內容是Android SDK和NDK的配置路徑，這是我之前在AndroidStudio配置過的，此文件不需要我們修改，在IDE的設置會自動覆蓋此文件的設置，此文件不應該commit到源碼管理系統中，因為它是個人環境的配置。

好，下面我們具體來看build.gradle文件。

根目錄的build.gradle

// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.3.0'
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}
allprojects {
    repositories {
        jcenter()
    }
}  

app工程下的build.gradle

apply plugin: 'com.android.application'
android {
    compileSdkVersion 21
    buildToolsVersion "22.0.1"
    defaultConfig {
        applicationId "example.jk.myapplication"
        minSdkVersion 19
        targetSdkVersion 21
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}
dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:22.2.0'
}  

• compileSdkVersion 指定構建時使用的Android SDK版本

• buildToolsVersion 指定構建工具的版本，構建工具可以使用Android SDK Manager來安裝，可以安裝多個版本，如圖：

  

defaultConfig元素里的配置對應AndroidManifest.xml文件，優先級比AndroidManifest.xml文件里的配置高。gradle支持對一個項目構建多種版本，比如試用版 、商業版，每個版本可以有自己的defaultConfig。

buildTypes元素默認定義了debug和release兩種構建，debug構建出來的APK將包含調試符號，并且以debug key進行簽名，而release類型的默認是沒有簽名的。minifyEnabled為true表示啟用自動清除無用代碼，用于軟件包瘦身。proguardFiles指定了代碼混淆使用的相關文件。

工程依賴

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

至此，我們已經大概了解了AndroidStudio默認工程有關gradle的腳本。其實AndroidStudio IDE提供了很多設置，這些設置修改后，AndroidStudio會自動更新相關的build.gradle和*.properties文件。如果我們手工編輯build.gradle文件，AndroidStudio將提示我們進行sync（同步）操作，以便這些配置反映到IDE界面上。

參考鏈接：

• 《Gradle Plugin User Guide》 http://tools.android.com/tech-docs/new-build-system/user-guide

• 《Gradle User Guide》 https://docs.gradle.org/current/userguide/userguide_single.html

• 《Build configuration Basics》 https://developer.android.com/tools/building/configuring-gradle.html

• 《project對象》 https://docs.gradle.org/current/dsl/org.gradle.api.Project.html#org.gradle.api.Project:dependencies(groovy.lang.Closure) )