Ant 構建腳本精要：從編譯打包到部署的十大核心任務實戰

Ant 專案結構總覽

Apache Ant 作為 Java 早期標準構建工具，雖然逐漸被 Maven/Gradle 取代，但大量存量專案仍在使用。一個典型 build.xml 包含：專案定義、屬性配置、目標與依賴關係。本文解析涵蓋編譯、測試、打包、部署全流程的十大核心任務。

十大核心任務深度解析

1. 專案與屬性初始化

屬性不可變（首次設定生效），支援檔案引入 實現環境隔離。

2. 清理與建立目錄

3. Java 編譯：javac 任務詳解

關鍵屬性：includeantruntime="false" 避免 Ant 自身類庫污染編譯類路徑。

4. 單元測試：junit 任務整合

5. 打包 JAR：manifest 與依賴處理

6. 打包 WAR：Web 應用部署

7. 資料庫腳本執行：sql 任務

8. 檔案複製與過濾：copy/filterset

9. 部署與發佈

10. 執行主程式：java 任務

最佳實踐總結

• 目標依賴鏈：clean → init → compile → test → jar/war → deploy
• 屬性外部化：敏感資訊（資料庫密碼、部署路徑）放入 build.properties，不入版控
• 路徑規範化：統一使用 ${basedir}/relative/path，避免絕對路徑
• 遞歸構建：多模組專案用 或 協調子專案

遷移建議

新專案強烈建議直接使用 Gradle (Kotlin DSL) 或 Maven：依賴管理、增量構建、多模組支援、IDE 整合、生態插件豐富，長期維護成本遠低於 Ant。存量 Ant 專案可通過 gradle init 自動轉換或漸進式遷移。