理解基本的Gradle

如果你想創(chuàng)建一個Android project基于gradle,那么你必須寫一個構建腳本，這個文件通常稱之為build.grade,你可能已經(jīng)覺察到了，當我們查看這一腳本，gradle會為我們提供很多默認的配置以及通常的默認值，而這極大的簡化了我們的工作，例如ant和maven,使用他們的時候，我們需要編寫大量的配置文件，而這很惡心。而gradle得默認配置，如果你需要使用自己的配置，完全可以簡單的去重寫他們就好。

Gradle腳本不是像傳統(tǒng)的xml文件那樣，而是一種基于Groovy的動態(tài)DSL，而Groovy語言是一種基于jvm的動態(tài)語言。

你完全不用擔心，你在使用gradle的時候，還需要去學習Groovy語言，該語言很容易閱讀，并且如果你已經(jīng)學習過java的話，學習Groovy將不會是難事，如果你想開始創(chuàng)建自己的tasks和插件，那么你最好對Groovy有一個較深的理解，然而由于其基于jvm,所以你完全可能通過純正的java代碼或者其他任何基于jvm的語言去開發(fā)你自己的插件，關于插件開發(fā)，我們后續(xù)將會有相關介紹。

Project和tasks

在grade中的兩大重要的概念，分別是project和tasks。每一次構建都是有至少一個project來完成，所以Android studio中的project和Gradle中的project不是一個概念。每個project有至少一個tasks。每一個build.grade文件代表著一個project。tasks在build.gradle中定義。當初始化構建進程，gradle會基于build文件，集合所有的project和tasks,一個tasks包含了一系列動作，然后它們將會按照順序執(zhí)行，一個動作就是一段被執(zhí)行的代碼，很像Java中的方法。

構建的生命周期

一旦一個tasks被執(zhí)行，那么它不會再次執(zhí)行了，不包含依賴的Tasks總是優(yōu)先執(zhí)行，一次構建將會經(jīng)歷下列三個階段：

初始化階段：project實例在這兒創(chuàng)建，如果有多個模塊，即有多個build.gradle文件，多個project將會被創(chuàng)建。

配置階段：在該階段，build.gradle腳本將會執(zhí)行，為每個project創(chuàng)建和配置所有的tasks。

執(zhí)行階段：這一階段，gradle會決定哪一個tasks會被執(zhí)行，哪一個tasks會被執(zhí)行完全依賴開始構建時傳入的參數(shù)和當前所在的文件夾位置有關。

build.gradle的配置文件

基于grade構建的項目通常至少有一個build.gradle，那么我們來看看Android的build.gradle：

buildscript {

repositories {

jcenter()

}

dependencies {

classpath 'com.android.tools.build:gradle:1.2.3'

}

}

這個就是實際構建開始的地方，在倉庫地址中，我們使用了JCenter，JCenter類似maven庫，不需要任何額外的配置，grade還支持其他幾個倉庫，不論是遠程還是本地倉庫。

構建腳本也定義了一個Android構建工具，這個就是Android plugin的來源之處。Android plugin提供了所有需要去構建和測試的應用。每個Android應用都需要這么一個插件：

apply plugin: 'com.android.application'

插件用于擴展gradle腳本的能力，在一個項目中使用插件，這樣該項目的構建腳本就可以定義該插件定義好的屬性和使用它的tasks。

注意：當你在開發(fā)一個依賴庫，那么你應該使用'com.android.library'，并且你不能同時使用他們2個，這將導致構建失敗，一個模塊要么使用Android application或者Android library插件，而不是二者。

當使用Android 插件的時候，Android標簽將可以被使用，如下所示：

android {

compileSdkVersion 22

buildToolsVersion "22.0.1"

}

更多的屬性我們將在第二章中進行討論。

項目結構

和eclipse對比來看，Android studio構建的結構有很大的不同：

MyApp

├── build.gradle

├── settings.gradle

└── app

├── build.gradle

├── build

├── libs

└── src

└── main

├── java

│? └── com.package.myapp

└── res

├── drawable

├── layout

└── etc.

grade項目通常在根文件夾中包含一個build.gradle，使用的代碼在app這個文件夾中，這個文件夾也可以使用其他名字，而不必要定義為app,例如當你利用Android studio創(chuàng)建一個project針對一個手機應用和一個Android wear應用的時候，模塊將被默認叫做application和wearable。

gradle使用了一個叫做source set的概念，官方解釋：一個source set就是一系列資源文件，其將會被編譯和執(zhí)行。對于Android項目，main就是一個source set，其包含了所有的資源代碼。當你開始編寫測試用例的時候，你一般會把代碼放在一個單獨的source set，叫做androidTest，這個文件夾只包含測試。

開始使用Gradle Wrapper

grade只是一個構建工具，而新版本總是在更迭，所以使用Gradle Wrapper將會是一個好的選擇去避免由于gradle版本更新導致的問題。Gradle Wrapper提供了一個windows的batch文件和其他系統(tǒng)的shell文件，當你使用這些腳本的時候，當前gradle版本將會被下載，并且會被自動用在項目的構建，所以每個開發(fā)者在構建自己app的時候只需要使用Wrapper。所以開發(fā)者不需要為你的電腦安裝任何gradle版本，在mac上你只需要運行gradlew，而在windows上你只需要運行gradlew.bat。

你也可以利用命令行./gradlew -v來查看當前gradle版本。下列是wrapper的文件夾：

myapp/

├── gradlew

├── gradlew.bat

└── gradle/wrapper/

├── gradle-wrapper.jar

└── gradle-wrapper.properties

可以看到一個bat文件針對windows系統(tǒng)，一個shell腳本針對mac系統(tǒng)，一個jar文件，一個配置文件。配置文件包含以下信息：

#Sat May 30 17:41:49 CEST 2015

distributionBase=GRADLE_USER_HOME

distributionPath=wrapper/dists

zipStoreBase=GRADLE_USER_HOME

zipStorePath=wrapper/dists

distributionUrl=https\://services.gradle.org/distributions/

gradle-2.4-all.zip

你可以改變該url來改變你的gradle版本。

使用基本的構建命令

使用你的命令行，導航到你的項目，然后輸入：

$ gradlew tasks

這一命令將會列出所以可運行的tasks,你也可以添加--all參數(shù)，來查看所有的task。當你在開發(fā)的時候，構建項目，你需要運行assemble task通過debug配置：

$ gradlew assembleDebug

該任務將會創(chuàng)建一個debug版本的app,同時Android插件會將其保存在MyApp/app/build/ outputs/apk目錄下。

除了assemble，還有三個基本的命令：

check 運行所以的checks,這意味著運行所有的tests在已連的設備或模擬器上。

build 是check和assemble的集合體。

clean 清楚項目的output文件。

保持舊的eclipse文件結構

關于如何將eclipse項目導入Android studio本文不再介紹。

android {

sourceSets {

main {

manifest.srcFile 'AndroidManifest.xml'

java.srcDirs = ['src']

resources.srcDirs = ['src']

aidl.srcDirs = ['src']

renderscript.srcDirs = ['src']

res.srcDirs = ['res']

assets.srcDirs = ['assets']

}

androidTest.setRoot('tests')

}

}

在grade文件中配置，將會保存eclipse目錄結構，當然，如果你有任何依賴的jar包，你需要告訴gradle它在哪兒，假設jar包會在一個叫做libs的文件夾內(nèi)，那么你應該這么配置：

dependencies {

compile fileTree(dir: 'libs', include: ['*.jar'])

}

該行意為：將libs文件夾中所有的jar文件視為依賴包。

總結

通過本文，我們可以學習到gradle的優(yōu)勢，以及為什么要使用gradle,我們簡單的看了看Android studio，以及其是如何幫助我們生成build文件。

同時我們學習了Gradle Wrapper，其讓我們維護以及分享項目變得更加簡單，我們知道了如何創(chuàng)建一個新的項目在Android studio中，以及如何從eclispe遷移到Android studio并且保持目錄結構。