理解基本的Gradle
如果你想創(chuàng)建一個Android project基于gradle,那么你必須寫一個構(gòu)建腳本,這個文件通常稱之為build.grade,你可能已經(jīng)覺察到了,當(dāng)我們查看這一腳本,gradle會為我們提供很多默認(rèn)的配置以及通常的默認(rèn)值,而這極大的簡化了我們的工作,例如ant和maven,使用他們的時候,我們需要編寫大量的配置文件,而這很惡心。而gradle得默認(rèn)配置,如果你需要使用自己的配置,完全可以簡單的去重寫他們就好。
Gradle腳本不是像傳統(tǒng)的xml文件那樣,而是一種基于Groovy的動態(tài)DSL,而Groovy語言是一種基于jvm的動態(tài)語言。
你完全不用擔(dān)心,你在使用gradle的時候,還需要去學(xué)習(xí)Groovy語言,該語言很容易閱讀,并且如果你已經(jīng)學(xué)習(xí)過java的話,學(xué)習(xí)Groovy將不會是難事,如果你想開始創(chuàng)建自己的tasks和插件,那么你最好對Groovy有一個較深的理解,然而由于其基于jvm,所以你完全可能通過純正的java代碼或者其他任何基于jvm的語言去開發(fā)你自己的插件,關(guān)于插件開發(fā),我們后續(xù)將會有相關(guān)介紹。
Project和tasks
在grade中的兩大重要的概念,分別是project和tasks。每一次構(gòu)建都是有至少一個project來完成,所以Android studio中的project和Gradle中的project不是一個概念。每個project有至少一個tasks。每一個build.grade文件代表著一個project。tasks在build.gradle中定義。當(dāng)初始化構(gòu)建進(jìn)程,gradle會基于build文件,集合所有的project和tasks,一個tasks包含了一系列動作,然后它們將會按照順序執(zhí)行,一個動作就是一段被執(zhí)行的代碼,很像Java中的方法。
構(gòu)建的生命周期
一旦一個tasks被執(zhí)行,那么它不會再次執(zhí)行了,不包含依賴的Tasks總是優(yōu)先執(zhí)行,一次構(gòu)建將會經(jīng)歷下列三個階段:
初始化階段:project實例在這兒創(chuàng)建,如果有多個模塊,即有多個build.gradle文件,多個project將會被創(chuàng)建。
配置階段:在該階段,build.gradle腳本將會執(zhí)行,為每個project創(chuàng)建和配置所有的tasks。
執(zhí)行階段:這一階段,gradle會決定哪一個tasks會被執(zhí)行,哪一個tasks會被執(zhí)行完全依賴開始構(gòu)建時傳入的參數(shù)和當(dāng)前所在的文件夾位置有關(guān)。
build.gradle的配置文件
基于grade構(gòu)建的項目通常至少有一個build.gradle,那么我們來看看Android的build.gradle:
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:1.2.3'
}
}
這個就是實際構(gòu)建開始的地方,在倉庫地址中,我們使用了JCenter,JCenter類似maven庫,不需要任何額外的配置,grade還支持其他幾個倉庫,不論是遠(yuǎn)程還是本地倉庫。
構(gòu)建腳本也定義了一個Android構(gòu)建工具,這個就是Android plugin的來源之處。Android plugin提供了所有需要去構(gòu)建和測試的應(yīng)用。每個Android應(yīng)用都需要這么一個插件:
apply plugin: 'com.android.application'
插件用于擴展gradle腳本的能力,在一個項目中使用插件,這樣該項目的構(gòu)建腳本就可以定義該插件定義好的屬性和使用它的tasks。
注意:當(dāng)你在開發(fā)一個依賴庫,那么你應(yīng)該使用'com.android.library',并且你不能同時使用他們2個,這將導(dǎo)致構(gòu)建失敗,一個模塊要么使用Android application或者Android library插件,而不是二者。
當(dāng)使用Android 插件的時候,Android標(biāo)簽將可以被使用,如下所示:
android {
compileSdkVersion 22
buildToolsVersion "22.0.1"
}
更多的屬性我們將在第二章中進(jìn)行討論。
項目結(jié)構(gòu)
和eclipse對比來看,Android studio構(gòu)建的結(jié)構(gòu)有很大的不同:
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,例如當(dāng)你利用Android studio創(chuàng)建一個project針對一個手機應(yīng)用和一個Android wear應(yīng)用的時候,模塊將被默認(rèn)叫做application和wearable。
gradle使用了一個叫做source set的概念,官方解釋:一個source set就是一系列資源文件,其將會被編譯和執(zhí)行。對于Android項目,main就是一個source set,其包含了所有的資源代碼。當(dāng)你開始編寫測試用例的時候,你一般會把代碼放在一個單獨的source set,叫做androidTest,這個文件夾只包含測試。
開始使用Gradle Wrapper
grade只是一個構(gòu)建工具,而新版本總是在更迭,所以使用Gradle Wrapper將會是一個好的選擇去避免由于gradle版本更新導(dǎo)致的問題。Gradle Wrapper提供了一個windows的batch文件和其他系統(tǒng)的shell文件,當(dāng)你使用這些腳本的時候,當(dāng)前gradle版本將會被下載,并且會被自動用在項目的構(gòu)建,所以每個開發(fā)者在構(gòu)建自己app的時候只需要使用Wrapper。所以開發(fā)者不需要為你的電腦安裝任何gradle版本,在mac上你只需要運行g(shù)radlew,而在windows上你只需要運行g(shù)radlew.bat。
你也可以利用命令行./gradlew -v來查看當(dāng)前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版本。
使用基本的構(gòu)建命令
使用你的命令行,導(dǎo)航到你的項目,然后輸入:
$ gradlew tasks
這一命令將會列出所以可運行的tasks,你也可以添加--all參數(shù),來查看所有的task。當(dāng)你在開發(fā)的時候,構(gòu)建項目,你需要運行assemble task通過debug配置:
$ gradlew assembleDebug
該任務(wù)將會創(chuàng)建一個debug版本的app,同時Android插件會將其保存在MyApp/app/build/ outputs/apk目錄下。
除了assemble,還有三個基本的命令:
check 運行所以的checks,這意味著運行所有的tests在已連的設(shè)備或模擬器上。
build 是check和assemble的集合體。
clean 清楚項目的output文件。
保持舊的eclipse文件結(jié)構(gòu)
關(guān)于如何將eclipse項目導(dǎo)入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目錄結(jié)構(gòu),當(dāng)然,如果你有任何依賴的jar包,你需要告訴gradle它在哪兒,假設(shè)jar包會在一個叫做libs的文件夾內(nèi),那么你應(yīng)該這么配置:
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
}
該行意為:將libs文件夾中所有的jar文件視為依賴包。
總結(jié)
通過本文,我們可以學(xué)習(xí)到gradle的優(yōu)勢,以及為什么要使用gradle,我們簡單的看了看Android studio,以及其是如何幫助我們生成build文件。
同時我們學(xué)習(xí)了Gradle Wrapper,其讓我們維護(hù)以及分享項目變得更加簡單,我們知道了如何創(chuàng)建一個新的項目在Android studio中,以及如何從eclispe遷移到Android studio并且保持目錄結(jié)構(gòu)。