project-root/
├── build.xml # Ant 建構腳本 (本範本)
├── src/ # Java 原始碼 (套件結構)
├── classes/ # 編譯輸出 .class 檔案
├── lib/ # 依賴 JAR 檔案
├── web/ # JSP/靜態資源 (Web 專案)
├── dist/ # 打包輸出 (JAR/WAR)
├── doc/ # Javadoc API 文檔
└── report/ # 單元測試報告
Project API Documentation]]>
All Rights Reserved.]]>
init → compile → test → pack → doc
↑___________________________|
default="doc":直接執行 ant 完成全流程depends 確保前置步驟完成,失敗即停止clean/rebuild 為獨立便利目標| 實踐 | 範本體現 |
|---|---|
| 屬性外部化 | 所有路徑用 property 定義,支援命令列覆蓋 ant -Dsrc.dir=mysrc |
| Classpath 統一管理 | path id="master-classpath" 供編譯/測試/執行複用 |
| 測試隔離 | **/*Test.class 命名慣例,打包時自動排除 |
| Manifest 資訊豐富化 | JAR 清單檔包含主類別、建構者、日期 |
| 編譯器警告開啟 | debug="on" + -Xlint:unchecked |
現代 Java 專案主流建構工具為 Gradle (Groovy/Kotlin DSL) 或 Maven。Ant 適合極簡專案、歷史專案維護、或作為 Gradle/Maven 任務的底層執行單元 (ant.task/antBuilder)。理解 Ant 目標依賴模型,有助於掌握現代建構系統的有向無環圖 (DAG) 執行本質。