Ant 編譯 Java 環境搭建完整指南 (Windows 7 x64 實測)

Apache Ant 是基於 Java 的建構工具，類似 Make 但專為 Java 設計、跨平台相容性佳。本文記錄在 Windows 7 SP1 x64 環境下，從 JDK、Ant 安裝到環境變數配置、build.xml 編寫、專案編譯的完整流程，含 Android 專案編譯說明。

環境版本基準

一、安裝 JDK 並配置環境變數

1. 執行 JDK 安裝程式，建議自訂路徑避免空格
2. 系統環境變數新增/修改：

JAVA_HOME=C:\Program Files (x86)\Java\jdk1.6.0_22
Path 追加：%JAVA_HOME%\bin

驗證：java -version、javac -version

二、安裝 Ant 並配置環境變數

1. 官網 下載二進制包 (apache-ant-1.8.4-bin.zip)
2. 解壓至 C:\apache-ant-1.8.4
3. 系統環境變數：

ANT_HOME=C:\apache-ant-1.8.4
Path 追加：%ANT_HOME%\bin

驗證：ant -version → 應顯示 Apache Ant(TM) version 1.8.4

Linux/macOS 配置參考

export ANT_HOME="/home/tools/apache-ant-1.8.4"
export PATH="${PATH}:${ANT_HOME}/bin"

三、編寫 build.xml (專案建構腳本)

build.xml 是 Ant 的核心，定義編譯、打包、部署等目標。建議從現有專案複製一份修改，或參考：

• OSChina Ant build.xml 範例
• BlogJava Ant 詳細教學

最小可用 build.xml 範例

<?xml version="1.0" encoding="UTF-8"?>
<project name="MyProject" default="jar" basedir=".">
    <property name="src.dir" value="src"/>
    <property name="build.dir" value="build"/>
    <property name="dist.dir" value="dist"/>

    <target name="clean">
        <delete dir="${build.dir}"/>
        <delete dir="${dist.dir}"/>
    </target>

    <target name="compile">
        <mkdir dir="${build.dir}/classes"/>
        <javac srcdir="${src.dir}" destdir="${build.dir}/classes" includeantruntime="false"/>
    </target>

    <target name="jar" depends="compile">
        <mkdir dir="${dist.dir}"/>
        <jar destfile="${dist.dir}/MyProject.jar" basedir="${build.dir}/classes"/>
    </target>
</project>

四、執行 Ant 編譯

一般 Java 專案

cd 專案根目錄 (含 build.xml)
ant              # 執行 default target
ant clean jar    # 指定目標鏈

輸出位於 ./build/classes、./dist/*.jar

Web 專案 (含 JSP 編譯)

需在 build.xml 中定義 war 目標，引用 jspc 任務預編譯 JSP，打包 WEB-INF/lib、WEB-INF/web.xml 等。

Android 專案 (特殊說明)

• Android SDK tools/ant/ 內建 build.xml 模板
• 專案目錄下通常不自帶 build.xml，需執行：

android update project -p . -t android-19
# 會生成 build.xml、local.properties、proguard-project.txt

編譯指令：

ant debug      # 產生未簽名/debug 簽名 APK (bin/*-debug.apk)
ant release    # 產生未簽名 release APK，需手動簽名對齊

注意：Eclipse/ADT 內建建構系統同樣調用 Ant，命令列執行僅供 CI/CD 或無圍面環境使用。

五、Cygwin 環境下使用 Ant

Cygwin 提供類 Unix 指令環境，適合習慣 Bash 的開發者：

$ cd /cygdrive/c/workspace/MyProject
$ ant clean jar

若需編譯 NDK 原生碼：

$ /cygdrive/c/android-ndk-r8b/ndk-build

常見問題排查

現代替代方案

• Maven：依賴管理、生命週期、中央倉庫、IDE 整合更好
• Gradle：DSL 靈活、增量建構、Android 官方首選
• Bazel：大型單一倉庫、遠端快取、Google 內部使用

Ant 適合輕量、無依賴管理需求、或維護舊專案。新專案建議直接採用 Gradle (Android) 或 Maven/Gradle (一般 Java)。