安裝

從官網(wǎng)下載zip壓縮包文件

此文件中包含如下內(nèi)容：

• gradle執(zhí)行文件

• 用戶手冊(cè)（HTML & PDF）

• DSL參考手冊(cè)

• API文檔（Javadoc & Groovydoc）

• 用戶手冊(cè)中的示例代碼衣式，其中有一些可以在你自己的項(xiàng)目中直接使用

• 源代碼（僅供參考荆几，如果你想編譯源代碼汉操，需要從源代碼倉(cāng)庫(kù)下載源代碼）

設(shè)置環(huán)境變量

• 添加GRADLE_HOME環(huán)境變量登失，其值為上一步解壓出來(lái)的文件夾所在目錄

• 添加GRADLE_HOME/bin到PATH環(huán)境變量

測(cè)試安裝

在命令行中執(zhí)行 gradle -v查看輸出內(nèi)容

JVM參數(shù)

可以通過(guò)環(huán)境變量GRADLE_OPTS或JAVA_OPTS給Gradle設(shè)置參數(shù)。也可以在gradle或gradlew腳本的開(kāi)始處設(shè)置環(huán)境變量。

目前還不能通過(guò)命令行參數(shù)給gradle設(shè)置JVM參數(shù)。

執(zhí)行多個(gè)任務(wù)

在gradle命令后跟隨多個(gè)任務(wù)的名稱就可以一次執(zhí)行多個(gè)任務(wù)拣挪。如果任務(wù)之間存在依賴關(guān)系，相同名稱的任務(wù)只會(huì)執(zhí)行一次俱诸。如：執(zhí)行gradle dist test菠劝，dist 依賴test，test只會(huì)執(zhí)行一次睁搭。

排除任務(wù)

使用命令行參數(shù)-x可以排除指定名稱的任務(wù)赶诊。如：執(zhí)行gradle dist -x test，將不會(huì)執(zhí)行test和test依賴的任務(wù)介袜，雖然test依賴了compileTest甫何，也不會(huì)執(zhí)行compileTest任務(wù)出吹。

在發(fā)生錯(cuò)誤時(shí)繼續(xù)構(gòu)建

默認(rèn)情況下遇伞，gradle在任務(wù)發(fā)生錯(cuò)誤時(shí)會(huì)退出執(zhí)行，這會(huì)讓構(gòu)建工作盡快完成捶牢，不過(guò)這樣也隱藏了可能會(huì)發(fā)生的其它錯(cuò)誤鸠珠。為了在一次構(gòu)建中查看盡可能多的錯(cuò)誤巍耗，你可以使用--continue選項(xiàng)，所有的錯(cuò)誤信息會(huì)在構(gòu)建結(jié)束時(shí)輸出渐排。

任務(wù)名縮寫

在命令行中指定任務(wù)名稱時(shí)炬太，可以不用給出完整的任務(wù)名稱，只需要給出能唯一確定任務(wù)名稱的部分名稱即可驯耻。

如：gradle dist可以縮寫為gradle di

也可以按駝峰命名法給出首字母縮寫亲族，如：gradle compileTest可以縮寫為gradle compTest或gradle cT

在-x選項(xiàng)中也可以使用名稱縮寫

指定構(gòu)建文件

執(zhí)行g(shù)radle命令時(shí)，默認(rèn)在當(dāng)前目錄中查找構(gòu)建文件可缚■龋可以使用-b選項(xiàng)來(lái)使用指定的構(gòu)建文件，當(dāng)使用-b 選項(xiàng)時(shí)帘靡，settings.gradle選項(xiàng)不起作用知给。

如：gradle -q -b subdir/myproject.gradle hello

另外，可以使用-p選項(xiàng)來(lái)指定項(xiàng)目目錄描姚。在多項(xiàng)目構(gòu)建中涩赢，需要使用-p選項(xiàng)來(lái)代替-b選項(xiàng)。

如：gradle -q -p subdir hello 使用subdir目錄中的build.gradle文件轩勘。

強(qiáng)制執(zhí)行任務(wù)

gradle使用增量構(gòu)建筒扒，當(dāng)一個(gè)任務(wù)的輸入輸出自上次構(gòu)建后沒(méi)有變化時(shí)，就不會(huì)再執(zhí)行此任務(wù)绊寻，并且在下一次執(zhí)行構(gòu)建時(shí)在任務(wù)名稱的后面顯示UP-TO-DATE霎肯。

如果你想強(qiáng)制執(zhí)行一個(gè)任務(wù)，使用--rerun-tasks選項(xiàng)即可榛斯，如：gradle --rerun-tasks doIt

這會(huì)強(qiáng)制執(zhí)行所有需要的任務(wù)观游，而不僅僅是在命令行中指定的任務(wù)。

獲取關(guān)于構(gòu)建的信息

gradle提供了一些內(nèi)置的任務(wù)來(lái)顯示構(gòu)建的詳細(xì)信息驮俗。這對(duì)于理解構(gòu)建的結(jié)構(gòu)和依賴很有幫助懂缕，也有助于調(diào)試問(wèn)題。

顯示項(xiàng)目列表

gradle projects顯示指定項(xiàng)目的子項(xiàng)目列表王凑。

顯示任務(wù)列表

gradle tasks可以顯示主要的任務(wù)搪柑，gradle tasks --all可以顯示全部的任務(wù)。

顯示任務(wù)詳情

顯示指定任務(wù)的詳細(xì)信息索烹。

如：gradle help -task taskname

顯示項(xiàng)目依賴

以樹(shù)形顯示指定項(xiàng)目的依賴關(guān)系工碾。

如：gradle -q dependencies api:dependencies webapp:dependencies

顯示項(xiàng)目構(gòu)建腳本的依賴

gradle buildEnvironment

查看指定依賴的詳情

gradle dependencyInsight查看指定依賴的詳情

如：gradle -q webapp:dependencyInsight --dependency groovy --configuration compile

查看項(xiàng)目屬性

gradle properties顯示項(xiàng)目的屬性列表。

如：gradle -q api:properties

虛執(zhí)行

-m選項(xiàng)并不會(huì)真正的執(zhí)行構(gòu)建百姓，只是顯示構(gòu)建的順序渊额。

如：gradle -m test