相信有很多像我一樣的朋友在使用Android Studio時，對 Gradle 和 Gradle Android 插件的版本號和作用不是很清楚，本篇文章的將對這些進行解釋，最后通過一個實際的項目工程來說明其中的配置塊的含義，并通過源代碼的角度去剖析腳本的結(jié)構(gòu)。

一.第一部分：Q&A

1.Gradle是什么？

Gradle 是一個JVM平臺上的自動化的構(gòu)建工具，支持多項目構(gòu)建,強有力依賴管理(本地或者遠程依賴)，構(gòu)建腳本使用Groovy語言編寫。

在Android Studio的 project 視圖下的 gradle/ wrapper/gradle-wrapper.properties 路徑下聲明了項目使用的Gradle版本號，這里使用的是 3.3版本

distributionUrl=https\://services.gradle.org/distributions/gradle-3.3-all.zip

2.Gradle Android Plugin 是什么？

在項目根目錄中的build.gradle文件中有如下設(shè)置：

dependencies {
    classpath 'com.android.tools.build:gradle:2.3.3'
  }

這里聲明的是項目對 Gradle Android Plugin 的依賴，其版本號為2.3.3。Gradle的Android插件提供了許多專為構(gòu)建Android的操作項。

classpath表明的是類路徑，該Android Plugin for Gradle 的對應(yīng)文件位置在Android Studio根目錄下的：gradle/m2repository/com/android/tools/build/gradle/對應(yīng)版本號/gradle-3.0.0.jar

附上我電腦上的路徑

可以看到，我們依賴的僅僅就是jar文件，build.gradle的腳本是使用Groovy語言編寫的，Groovy編寫的程序可以運行在JVM虛擬機中。而Android Plugin for Gradle是專門為構(gòu)建Android項目提供庫文件。

平時我們經(jīng)常使用的比如 buildToolsVersion、compileSdkVersion，buildTypes{ }、sourceSets { }、defaultConfig{ }等方法函數(shù)(是的，就是方法，這是Groovy語言中的閉包和函數(shù)調(diào)用時的特性，現(xiàn)在無需關(guān)心，后面第三部分有講到這個)，都是Gradle Android Plugin 這個庫提供的方法。可不要以為Gradle僅僅是用來構(gòu)建Android項目。

3.Android Studio中的compileSdkVersion、buildToolsVersion、minSdkVersion、targetSdkVersion這些配置項是什么？

1. compileSdkVersion 26 :編譯項目使用的Android SDK的版本號為26,可以使用對應(yīng)版本號提供的API進行編程
2. minSdkVersion 14 ：定義最小可以運行app的android系統(tǒng)版本號為14
3. targetSdkVersion 26 ：指定測試app的android系統(tǒng)版本號為26
4. buildToolsVersion "26.0.2" :指定Android Studio中 sdk 構(gòu)建工具的版本號、命令行工具等構(gòu)建工具，在使用Android plugin 3.0.0版本或以上時，該屬性可以不用設(shè)置，插件會提供默認版本號。

在導(dǎo)入github上面的工程時，如果該工程所需要的Gradle版本、Android Plugin版本、buildToolsVersion版本，SDK 版本與你本地不符合時，往往會卡死，所以在導(dǎo)入之前可以更改為你本地的版本，在進行導(dǎo)入即可。

4. Gradle Wrapper是什么？

The Gradle Wrapper allows you to execute Gradle builds on machines where Gradle is not installed. This is useful for example for some continuous integration servers. It is also useful for an open source project to keep the barrier low for building it. The wrapper is also very interesting for the enterprise. It is a zero administration approach for the client machines. It also enforces the usage of a particular Gradle version thus minimizing support issues.
Gradle Wrapper 可以在沒有安裝Gradle的機器上執(zhí)行Gradle 構(gòu)建，經(jīng)常在持續(xù)性構(gòu)建平臺上所使用，例如jenkis。同時對于客戶端機器來說零成本管理。

Gradle User Guide

第二部分. 關(guān)于Android Studio 工程項目你需要知道的一些東西

1. Android Studio項目工程包含一個Application module,包含若干個Library module。 Library module可以是Android library，也可以是java library。
2. Android Library : 包含Android項目中的源代碼、資源文件、manifest文件，被編譯為AAR文件。AAR文件可做為Android 應(yīng)用模塊的依賴。
3. java library : 僅包含java源文件，編譯的結(jié)果為JAR文件，可作為Android 應(yīng)用模塊的依賴或者java 項目的依賴。
4. 每個module都可以被單獨的構(gòu)建，測試與調(diào)試，同時moudle可用來作為其他工程使用的library。

第三部分 .實際工程分析

通過github上的timber項目分析各模塊下的build.gradle配件文件的含義?？梢灾苯拥絞ithub上搜索找到該項目。

1.Timber項目結(jié)構(gòu)

根目錄的setting.gradle文件，告訴Gradle需要構(gòu)建的模塊包括那些

include ':timber',include ':timber-lint',include ':timber-sample'

a.其中timber-sample是Application 模塊，對應(yīng)聲明為

apply plugin: 'com.android.application'

b.timber是android library 模塊,對應(yīng)聲明為

apply plugin: 'com.android.library'

c.timber-lint是java library模塊，對應(yīng)聲明為

apply plugin: 'java-library'

2. build.gradle 文件中結(jié)構(gòu)解釋, 大招來了 :）

下面我將通過簡單易懂的方式去讓使用者理解build腳本文件的結(jié)構(gòu)。

常見的模塊下build.gradle文件格式如下：

apply plugin: 'com.android.application'

android {
  compileSdkVersion 25
  buildToolsVersion "26.0.1"
  defaultConfig {
   
  }
  buildTypes {

  }
}

dependencies {

}

2.1： “apply plugin: 'com.android.application'” 語句解釋：

Gradle是使用Groovy所寫，這里是調(diào)用了 apply方法，Groovy中方法調(diào)用時可以省略括號，在你按住Control + 左鍵（mac為command+左鍵）時，可以進入到對應(yīng)的類中，之前上文也提到過，Android Plugin 僅僅是Jar文件，讓我們進入看看其中的對應(yīng)方法是什么？

public interface PluginAware {
  void apply(Map<String, ?> options);
}

在Grovvy中 a.b() 這種格式可以寫為a b

所以呢 compileSdkVersion ,apply 等語句都是在調(diào)用對應(yīng)的函數(shù)

2.2 xxx { } 格式到底是什么？

def debugClosure(int num, String str, Closure closure){ 
   //dosomething 
} 

debugClosure(1, "groovy", { 
 println"hello groovy!" 
})

首先"{ }" 在Groovy語言中是“閉包”,簡單講閉包就是用“{ }”擴起來的一段代碼段 ，在Groovy中有調(diào)用方法的時候有這樣一條規(guī)定：“在調(diào)用方法的時候，如果方法僅有一個參數(shù)是Closure類型(也就是閉包)，調(diào)用的時候，可以把閉包中的執(zhí)行的代碼寫到括號中，為xxx({ })，當(dāng)把括號省略之后就變成了 xxx{ } 格式”。

最前面代碼中的"android{ }"語句函數(shù)定義在Project類中，函數(shù)定義為：

AppExtension android(Closure configuration);

結(jié)論：build.gradle腳本文件在運行的其實就是在執(zhí)行一系列的函數(shù)

3. 根目錄下build.gradle文件分析

該文件定義的是整個項目的構(gòu)建配置，該配置同樣生效于其他module

3.1 extra 屬性

我們可以在項目頂級build.gradle中聲明ext 塊，在其中定義的屬性可以在其他各個模塊中去使用，通過這種方式可以一次性更改項目的各個模塊的構(gòu)建配置。

ext {
  compileSdkVersion = 26、
  supportLibVersion = "26.1.0"
}

使用：在其他模塊通過rootProject.ext.compileSdkVersion去使用該屬性。

3.2 buildScript 塊

buildscript {
 repositories {
  jcenter()
  google()
 }

 dependencies {
  classpath deps.androidPlugin
  classpath 'com.github.ben-manes:gradle-versions-plugin:0.17.0'
 }
}

其中repositories中聲明的是遠程倉庫的類別，平時我們在dependencies塊中使用的類似compile 'io.reactivex:rxjava:1.0.0'語句，它在jcenter倉庫中都是唯一存在，在構(gòu)建的時候，本地如果沒有的話，會到j(luò)center中去進行下載對應(yīng)的版本。

4. 模塊下的build.gradle文件分析

1、defaultConfig 塊：定義的是APK各種構(gòu)建版本的默認設(shè)置，這里面的一些屬性可在AndroidManifest.xml文件中重載配置

  applicationId 'com.example.myapp'
  minSdkVersion 15
  targetSdkVersion 26
  versionCode 1
  versionName "1.0"
 }

productFlavors 塊： 可以配置多種產(chǎn)品類型，比如可以一個是free，另外一種類型是免費

productFlavors {
  free {
   applicationId 'com.example.myapp.free'
  }

  paid {
   applicationId 'com.example.myapp.paid'
  }
 }

buildTypes 塊：可以配置多種構(gòu)建類型的相應(yīng)的配置項，比如debug、relase版本。

buildTypes {
  release {
    minifyEnabled true 
    proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
  }
 }

以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。