Eclipse 整合 Gradle 建置系統：從 Ant、Maven 遷移的完整指南

為什麼選擇 Gradle？

Ant 需手寫冗長 XML、依賴管理弱；Maven 雖有中央倉庫與慣例優於配置，但 XML 依然繁瑣、學習曲線陡。Gradle 以 Groovy DSL 撰寫建置腳本，語法簡潔、支援增量建置、原生整合 Ant/Maven、IDE 支援完善，已成為 Java 專案主流建置工具。

環境準備

• JDK 1.8+、Eclipse (任意版本)、Tomcat 8+
• 下載 Gradle 最新版、解壓、將 bin 加入 PATH
• 驗證：gradle -v 輸出版本資訊即成功

五分鐘上手：建立 Java 專案並建置

1. Eclipse 建立 Java Project → gradle_project
2. 專案根目錄新增 build.gradle 單行：

   apply plugin: 'java'

3. 原始碼置於 src/main/java（Gradle 慣例目錄）
4. 終端機執行 gradle build，自動編譯、測試、打包 JAR 至 build/libs/

常用任務與指令

進階配置

1. 相依套件管理

repositories {
  mavenCentral()
  flatDir { dirs 'libs' }  // 本地 JAR
}
dependencies {
  implementation 'org.junit.jupiter:junit-jupiter:5.9.2'
  compileOnly files('libs/legacy.jar')
}

2. 多模組專案

根目錄 settings.gradle：

include 'sub_project_one', 'sub_project_two'

根 build.gradle：

subprojects { apply plugin: 'java' }  // 所有子專案套用 java plugin
apply plugin: 'java'                  // 根專案若也需建置

子專案可各自擁有 build.gradle 覆寫（如套用 war plugin）。

3. 整合既有 Ant 腳本

ant.importBuild 'build.xml'  // 直接引入 Ant targets
gradle antTargetName         // 呼叫 Ant 目標

4. 發布成品至 Maven 倉庫

apply plugin: 'maven-publish'
publishing {
  repositories { maven { url "file:///tmp/myRepo" } }
  publications { mavenJava(MavenPublication) { from components.java } }
}

遷移既有專案建議

• 若專案結構不符 Gradle 慣例，用 sourceSets.main.java.srcDirs = ['src'] 指定舊路徑。
• 漸進式遷移：先用 ant.importBuild 复用 Ant 任務，再逐步改寫為 Gradle 任務。
• 善用 gradle init 產生初始腳本，再微調。

結語

Gradle 以「程式碼即配置」哲學，將建置邏輯變為可維護、可測試的程式。本文涵蓋從零開始到多模組、發布、Ant 整合的完整路徑，建議實作一遍即可掌握核心技能。

1. 上一篇文章： Struts 從零開始（一）：基礎登入驗證完整實作
2. 下一篇文章： JAX-RPC 實作 Web 服務（二）：開發 Client 端呼叫 RPC 服務

Java 相關知識

Java 實作 FTP 客戶端（六）：遠端視窗元件 FtpPanel 核心實現

遠端視窗整體架構 遠端視窗核心類別 FtpPanel 繼

Ruby on Rails 開發實戰（Windows 環境）第 9 篇：購物車錯誤處理與異常捕捉

本篇針對購物車加入錯誤處理機制，模擬併發情境下商品被刪除後使

Java 觀察者模式深度解析與實戰代碼示例

什麼是觀察者模式 觀察者模式定義對象間一對多依賴，當一個對象

Java Web 版 RSS 閱讀器實戰（二）：dTree 實現訂閱分組樹狀加載

系列第二篇，使用輕量級 JavaScript 樹組件 dTr