使用Gradle構(gòu)建Java項(xiàng)目

這個(gè)手冊(cè)將通過一個(gè)簡(jiǎn)單的Java項(xiàng)目向大家介紹如何使用Gradle構(gòu)建Java項(xiàng)目。

我們將要做什么？

我們將在這篇文檔航中創(chuàng)建一個(gè)簡(jiǎn)單的Java項(xiàng)目，然后使用Gradle構(gòu)建它。

需要準(zhǔn)備什么？

預(yù)留15分鐘空閑時(shí)間

一件稱手的兵器(你最喜歡的IDE或者文本編輯器)

Java環(huán)境([JDK6](http://www.oracle.com/technetwork/java/javase/downloads/index.html”JDK”及以上版本)

如何完成這個(gè)手冊(cè)的內(nèi)容？

與大多數(shù)Spring的入門手冊(cè)一樣，你可以從頭開始一步步完成教程中的每一步工作，也可以跳過你已經(jīng)爛熟的基礎(chǔ)步驟。不管采用那種方式，你最后都會(huì)得到可工作的代碼。

如果要重頭開始，猛戳這里

如果要跳過基礎(chǔ)部分，需執(zhí)行以下操作：

下載并解壓本文檔相關(guān)源代碼，或者使用Git克隆一個(gè)：git clone https://github.com/spring-guides/gs-gradle.git

cd 進(jìn)入?gs-gradle/initial

當(dāng)你完成后，你可以使用gs-gradle/complete來檢查你的結(jié)果。

配置項(xiàng)目

首先需要配置一個(gè)項(xiàng)目給Gradle進(jìn)行構(gòu)建。為了保證我們能專注于Gradle，目前最好創(chuàng)建最簡(jiǎn)單的Java項(xiàng)目。

創(chuàng)建目錄結(jié)構(gòu)

在項(xiàng)目主目錄下，創(chuàng)建以下子目錄;在*nix系統(tǒng)下可以使用命令：mkdir -p src/main/java/hello

在src/main/java/hello目錄中，你可以創(chuàng)建任何Java類。為簡(jiǎn)單起見并且為了與指南的其余部分保持一致，我們建議創(chuàng)建兩個(gè)雷HelloWorld.java和Greeter.java

src/main/java/hello/HelloWorld.java的源代碼：

src/main/java/hello/Greeter.java的源代碼：

安裝Gradle

到目前為止，我們已經(jīng)搭建了一個(gè)可以用來使用Gradle構(gòu)建的項(xiàng)目，現(xiàn)在到了安裝Gradle的時(shí)候了。

Gradle可以從http://www.gradle.org/downloads下載。我們僅需要下載Gradle的二進(jìn)制發(fā)布包，所以在剛才提供的連接上尋找gradle-version-bin.zip文件(當(dāng)然，也可以下載gradle-version-all.zip，它包含源代碼、文檔以已編譯代碼)

解壓縮下載的文件，并將解壓后目錄中的bin目錄加到環(huán)境變量中。

可以在命令行中執(zhí)行以下代碼來測(cè)試Gradle是否安裝成功

如果你很幸運(yùn)，嘛事都OK，你會(huì)看到下面的welcome信息：

看到這個(gè)了，說明Gradle已經(jīng)成功安裝到系統(tǒng)中了。如果沒看到……再去看看Gradle的手冊(cè)先。

Gradle可以做些什么呢？

Gradle已經(jīng)安裝到系統(tǒng)上了，那么它可以做什么呢？在我們?yōu)轫?xiàng)目創(chuàng)建build.gradle文件之前，我們可以先問一下Gradle目前有哪些可用的任務(wù)(Tasks)：

我們可以看到可用任務(wù)(Tasks)的列表。假設(shè)你執(zhí)行Gradle的目錄不存在build.gradle文件，你可以看到一些非常基礎(chǔ)的任務(wù)，類似于：

盡管上面的列出的任務(wù)是可用的，但是如果沒有項(xiàng)目的構(gòu)建配置他們無法提供太多的價(jià)值。當(dāng)配置了項(xiàng)目的build.gradle后，一些任務(wù)將變得非常有用。

如果在build.gradle中配置了插件(plugins)上面的任務(wù)列表會(huì)變得更長(zhǎng)，最好在配置插件后使用gradle task看看那些任務(wù)是可用的。

剛說到配置插件，馬上我們就會(huì)配置一個(gè)插件來啟用基礎(chǔ)的Java構(gòu)建功能。

構(gòu)建Java代碼

先從簡(jiǎn)單的開始，創(chuàng)建一個(gè)最簡(jiǎn)單的只有一行的build.gradle文件：

別看只有一行配置，提供的能力可不是一點(diǎn)點(diǎn)哦。再執(zhí)行一下gradle task，我們可以看到任務(wù)列表中增加了一些內(nèi)容，比如：用來編譯java項(xiàng)目的任務(wù)、用來創(chuàng)建JavaDoc的任務(wù)、用來執(zhí)行單元測(cè)試的任務(wù)。

我們經(jīng)常使用的任務(wù)是gradle build，這個(gè)任務(wù)執(zhí)行以下操作：編譯、執(zhí)行單元測(cè)試、組裝Jar文件：

幾秒鐘以后，會(huì)看到”BUILD SUCCESSFUL”輸出，說明構(gòu)建已經(jīng)完成了。

可以到”build”目錄中查看構(gòu)建結(jié)構(gòu)，在這個(gè)目錄中我們可以看到很多子目錄，其中有三個(gè)我們需要特別注意：

classes: 保存被編譯后的.class文件

reports: 構(gòu)建報(bào)告(如：測(cè)試報(bào)告)

lib: 組裝好的項(xiàng)目包(通常為：.jar或者.war文件)

classes目錄包含編譯生成的所有.class文件。執(zhí)行完編譯后，我們應(yīng)該可以在這里找到”HelloWorld.class”和”Greeter.class”。

到目前為止，我們項(xiàng)目并沒有申明任何依賴，所以”debendency_cache”目錄是空的。

“reports”目錄會(huì)包含項(xiàng)目單元測(cè)試的測(cè)試報(bào)告，當(dāng)然，當(dāng)前項(xiàng)目并未編寫任何單元測(cè)試，所以，也是空目錄。

“l(fā)ib”目錄包含打包后的jar或war文件，在后面的內(nèi)容中我們將學(xué)會(huì)如何定義JAR的名稱和版本號(hào)。

申明依賴

我們的Hello World例程非常簡(jiǎn)單且不依賴于任何第三方庫(kù)，但是大多數(shù)應(yīng)用程序都會(huì)依賴第三方庫(kù)提供的通用或復(fù)雜的功能。

例如：假設(shè)我們希望更好的說”Hello World!”，我們希望應(yīng)用程序能同時(shí)輸出當(dāng)前的日期和時(shí)間。當(dāng)然這可以使用Java自身的日期和時(shí)間相關(guān)庫(kù)，但是我們可以使用”Joda Time”庫(kù)實(shí)現(xiàn)更有趣的功能。

首先，把HelloWorld.jara類修改成下面這樣：

這里我們的HelloWorld使用”Joda Time”的LocalTime類來獲取和輸出當(dāng)前時(shí)間。

如果我們馬上執(zhí)行g(shù)radle build來構(gòu)建項(xiàng)目，構(gòu)建過程將會(huì)失敗，因?yàn)槲覀儾⑽磳ⅰ盝oda Time”庫(kù)聲明為編譯時(shí)依賴庫(kù)。

首先，我們需要添加一些配置來定義第三方庫(kù)的來源：

上面的repositories定義，告訴構(gòu)建系統(tǒng)通過Maven中央庫(kù)來檢索項(xiàng)目依賴的軟件包，Gradle在很大程度上依賴Maven構(gòu)建工具的許多約定和基礎(chǔ)功能,包括使用Maven中央的庫(kù)來處理依賴關(guān)系。

現(xiàn)在我們可以使用第三方庫(kù)了，但現(xiàn)需要定義：

使用dependencies塊，我們定義了一條Joda Time的依賴項(xiàng)。這里，明確指定使用joda-time組內(nèi)的版本為2.2的joda-time庫(kù)。

另一個(gè)要注意的是，我們?cè)谶@個(gè)依賴定義中指定依賴是compile范圍的。意思是，這個(gè)庫(kù)在編譯和運(yùn)行時(shí)都需要(如果我們正在構(gòu)建WAR文件，這個(gè)文件會(huì)在/WEB-INF/libs目錄下)。另外值得注意的依賴類型包括：

providedCompile：在編譯期間需要這個(gè)依賴包，但在運(yùn)行期間可能由容器提供相關(guān)組件(比如：Java Servlet API)

testCompile：依賴項(xiàng)僅在構(gòu)建和運(yùn)行測(cè)試代碼時(shí)需要，在項(xiàng)目運(yùn)行時(shí)不需要這個(gè)依賴項(xiàng)。

最后，我們來定義我們將生成的Jar文件的名字：

jar塊定義如何命名JAR文件，在上面的例子中，我們的JAR文件的名字為：gs-gradle-0.1.0.jar。

注：這個(gè)時(shí)候如果執(zhí)行g(shù)radle build，Gradle會(huì)花一些時(shí)間從Maven中央庫(kù)下載Joda Time包(具體下載時(shí)間依賴于你的網(wǎng)速)

使用Gradle Wrapper來構(gòu)建項(xiàng)目

Gradle Wrapper是開始一個(gè)Gradle構(gòu)建的首選方式。它包含了windows批處理以及OS X和Linux的Shell腳本。這些腳本允許我們?cè)跊]有安裝Gradle的系統(tǒng)上執(zhí)行Gradle構(gòu)建。要實(shí)現(xiàn)這個(gè)功能，我們需要在我們的build.gradle文件中增加以下代碼：

執(zhí)行下面代碼來下載和初始化wrapper腳本:

命令執(zhí)行完后，我們可以看到增加了一些新文件。有兩個(gè)文件在根目錄下，wapper的jar文件和properties文件在新增的gradle/wrapper目錄下。

現(xiàn)在Gradle Wrapper已經(jīng)可以用來構(gòu)建系統(tǒng)了。把這些文件增加到版本控制系統(tǒng)中，然后再任何時(shí)候、任何地方只要遷出這些文件就一個(gè)按照同樣的方式(與當(dāng)前生成 Wrapper的Gradle版本一致)構(gòu)建系統(tǒng)。運(yùn)行wrapper腳本來構(gòu)建系統(tǒng)，跟我們之前橋的命令很像：

當(dāng)?shù)谝淮瓮ㄟ^wrapper使用指定版本的Gradle構(gòu)建系統(tǒng)時(shí)，wrapper首先下載對(duì)應(yīng)版本的Gradle可執(zhí)行文件。Gradle Wrapper的所有文件在都可以被提交到版本庫(kù)中，所以，任何人都可以在沒有安裝Gradle的環(huán)境下使用相同版本的Gradle構(gòu)建系統(tǒng)。

在這個(gè)時(shí)候，我們需要重新構(gòu)建我們的代碼，構(gòu)建的結(jié)果目錄如下：

Jar文件中包含我們希望打包的Gretter和HelloWorld類。

需要注意的,即使我們聲明了joda-time依賴,但這里也沒有包括對(duì)應(yīng)的庫(kù)文件，而且生成的JAR文件也不是可運(yùn)行JAR文件。

要想讓代碼可以運(yùn)行，我們可以使用Gradle的application插件。增加以下內(nèi)容到build.gradle文件中。

現(xiàn)在我們的app可以執(zhí)行了。

為了能夠?qū)⒁蕾嚢惨砸黄鸫虬?#xff0c;比如，我們希望構(gòu)建一個(gè)WAR包，可以包含第三方組件的打包格式，我們可以使用Gradle的WAR插件。如果我們使用Spring Boot并且希望得到一個(gè)可執(zhí)行的JAR文件，我們可以使用spring-boot-gradle-plugin插件。在我們的示例中，gradle沒有足夠的信息來了解我們的目標(biāo)系統(tǒng)。但是，目前介紹的內(nèi)容已經(jīng)足夠我們開始使用Gradle了。

下面是本文需要用的的build.gradle文件：

總結(jié)

以上是生活随笔為你收集整理的gradle java ide_使用Gradle构建Java项目的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。