Ant 構建工具入門：環境配置、build.xml 編寫與專案構建圖文教程

Ant 是什麼？

基於 Java 的構建工具，用 XML (build.xml) 定義構建目標與依賴，類似 Make 但跨平台、擴展性強。雖已被 Maven/Gradle 取代主流地位，但維護老專案、理解構建本質仍有價值。

環境安裝配置 (Windows 示例)

1. 下載 apache-ant-1.10.x-bin.zip 解壓至 D:\tools\ant
2. 設置環境變量：
   • ANT_HOME=D:\tools\ant
   • JAVA_HOME=D:\tools\jdk1.8 (必須先配置)
   • Path=%Path%;%ANT_HOME%\bin
3. 驗證：CMD 輸入 ant -version 輸出版本號即成功

專案結構約定

my-project/
├── src/           # 源碼
│   └── com/demo/Hello.java
├── build.xml      # Ant 腳本 (根目錄)
├── build/         # 編譯輸出 (自動生成)
│   └── classes/
└── dist/          # 打包輸出 (自動生成)
    └── project.jar

核心 build.xml 模板

關鍵概念解析

命令行構建演示

D:\my-project> ant
Buildfile: D:\my-project\build.xml

init:
    [mkdir] Created dir: D:\my-project\build\classes
    [mkdir] Created dir: D:\my-project\dist

compile:
    [javac] Compiling 1 source file to D:\my-project\build\classes

jar:
      [jar] Building jar: D:\my-project\dist\MyProject.jar

BUILD SUCCESSFUL
Total time: 2 seconds

進階常用 Task

• <copy> 複製資源文件到 classes
• <javadoc> 生成 API 文檔
• <junit> 執行單元測試並生成報告
• <zip>/<tar> 打包發布
• <ftp>/<scp> 部署遠程
• <condition>/<if> (ant-contrib) 條件構建

遷移建議

新專案直接用 Maven 或 Gradle：依賴管理、約定優於配置、多模組、IDE 深度整合、CI/CD 原生支援。Ant 適用於：極簡專案、無依賴管理需求、嵌入式構建邏輯、老專案維護。