在使用Android Studio創(chuàng)建工程時(shí)，會(huì)在根目錄創(chuàng)建類似如下的build.gradle。本文將從初學(xué)者的角度來解釋每一行的意思，具體的細(xì)節(jié)還需查看gradle的API文檔。

如果要學(xué)習(xí)gradle，推薦一篇寫得很好的blog深入理解Android之Gradle。個(gè)人認(rèn)為最重要的一點(diǎn)是不要把build.gradle簡單地看作配置文件，而是要把它看作一種編程框架，使用其API或者Groovy編程語言來完成編譯、打包、測試等工作。

以下的注釋為每一行代碼的意思，希望對(duì)理解build.gradle有所幫助。

// Top-level build file where you can add configuration options common to all sub-projects/modules.
// Gradle中可以使用“//”或“/**/”來添加注釋，與Java類似。
// 根目錄下的build.gradle用于添加子工程或模塊共用的配置項(xiàng)。

// "buildscript"的類型為script block，而且是最上層的script block，用于配置Gradle的Project實(shí)例。其API文檔為https://docs.gradle.org/current/dsl/org.gradle.api.Project.html#org.gradle.api.Project:buildscript(groovy.lang.Closure)
// 其余的根script block有"allprojects", "dependencies", "configurations"等，更多的可見https://docs.gradle.org/current/dsl/的“Build script structure”一節(jié)。
// Script Block是一種method的調(diào)用，傳入的參數(shù)為configuration closure。執(zhí)行后會(huì)對(duì)Project的屬性進(jìn)行配置。
// 此處的"buildscript"用于配置Project的build script的classpath。
buildscript {
    // 如果需要的話，從https://jcenter.bintray.com/下載code reposities。
    repositories {
        jcenter()
    }
    // 定義classpath，gradle會(huì)從“repositories”中下載對(duì)應(yīng)版本的Gradle。如果使用gradle wrapper的話，感覺這個(gè)配置會(huì)被忽略。Wrapper會(huì)自己去下載所使用的gradle版本。
    dependencies {
        classpath 'com.android.tools.build:gradle:2.1.3'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

// 該配置會(huì)被應(yīng)用到所有的子工程。
allprojects {
    repositories {
        jcenter()
    }
}

// 運(yùn)行g(shù)radle clean時(shí)，執(zhí)行此處定義的task。
// 該任務(wù)繼承自Delete，刪除根目錄中的build目錄。
// 相當(dāng)于執(zhí)行Delete.delete(rootProject.buildDir)。
// gradle使用groovy語言，調(diào)用method時(shí)可以不用加（）。
task clean(type: Delete) {
    delete rootProject.buildDir
}

另外，根目錄下還有一個(gè)settings.gradle文件， 內(nèi)容如下。

// 調(diào)用include函數(shù)，將子工程app（目錄名為app）導(dǎo)入進(jìn)來。
// ':'表示app是一個(gè)相對(duì)路徑，跟路徑為該工程的根目錄。
include ':app'

settings.gradle的作用就是導(dǎo)入子工程。它支持導(dǎo)入多個(gè)子工程，使整個(gè)工程支持multi-project的編譯。

當(dāng)有多個(gè)子工程時(shí)，gradle既可以在根目錄下執(zhí)行任務(wù)（比如：gradle tasks會(huì)顯示在根目錄下可以執(zhí)行的任務(wù)），又可以在相應(yīng)的子工程下執(zhí)行任務(wù)（比如：gradle :app:tasks會(huì)顯示在子工程app下可以執(zhí)行的任務(wù)）。

如果有的app之間有依賴關(guān)系，或者app依賴需本地編譯的庫，使用multi-project編譯會(huì)增加編譯的靈活性，因?yàn)樵赽uild.gradle中可以指定或修改任務(wù)之間的依賴關(guān)系。