使用 Antenna (Ant 任務) 自動化 J2ME 專案打包

動機

Ant 打包 J2EE 應用 (WAR/EAR) 很方便，但 Sun 官方 Ant 教學需手寫 Manifest 與 JAD。Antenna (https://antenna.sourceforge.net/) 提供專用 Ant 任務，一次完成：編譯、預驗證、產生 JAR/JAD、可選混淆 (RetroGuard/ProGuard)、甚至產生 Palm PRC。

前置準備

• 已安裝 Ant，設定 ANT_HOME 並加入 PATH。
• 下載 antenna-bin.jar 放入 ANT_HOME/lib 或專案 lib，並於 build.xml 以 <taskdef> 載入。

專案結構範例

UIDemo/
├── build.xml
├── src/          # 來源碼
└── res/          # 資源檔 (圖片等)

build.xml 完整範例 (關鍵屬性已中文註釋)

<?xml version="1.0"?>
<project name="UIDemo" default="build" basedir=".">
    <!-- WTK 安裝路徑 -->
    <property name="wtk.home" value="c:\J2MEwtk"/>

    <!-- MIDlet 名稱與專案根目錄 -->
    <property name="midlet.name" value="UIDemo"/>
    <property name="midlet.home" value="."/>

    <!-- 定義 Antenna 任務 -->
    <taskdef name="wtkjad" classname="de.pleumann.antenna.WtkJad"/>
    <taskdef name="wtkbuild" classname="de.pleumann.antenna.WtkBuild"/>
    <taskdef name="wtkpackage" classname="de.pleumann.antenna.WtkPackage"/>
    <taskdef name="wtkmakeprc" classname="de.pleumann.antenna.WtkMakePrc"/>
    <taskdef name="wtkrun" classname="de.pleumann.antenna.WtkRun"/>
    <taskdef name="wtkpreverify" classname="de.pleumann.antenna.WtkPreverify"/>
    <taskdef name="wtkobfuscate" classname="de.pleumann.antenna.WtkObfuscate"/>

    <target name="clean">
        <delete failonerror="false" dir="classes"/>
        <delete failonerror="false">
            <fileset dir="."><exclude name="build.xml"/></fileset>
        </delete>
    </target>

    <target name="build">
        <!-- 產生 JAD -->
        <wtkjad jadfile="${midlet.name}.jad"
              name="Sun Samples - Demos"
              vendor="Sun Microsystems"
              version="1.0.3">
            <midlet name="UIDemo"
                  icon="/res/midp/uidemo/icon.png"
                  class="midp.uidemo.UIDemo"/>
        </wtkjad>

        <mkdir dir="classes"/>

        <!-- 編譯 (不預驗證) -->
        <wtkbuild srcdir="${midlet.home}/src"
                  destdir="classes"
                  preverify="false"/>

        <!-- 打包 JAR/JAD、預驗證、可選混淆、自動版本號 -->
        <wtkpackage jarfile="${midlet.name}.jar"
                    jadfile="${midlet.name}.jad"
                    obfuscate="false"
                    preverify="true"
                    autoversion="true">
            <fileset dir="classes"/>
            <fileset dir="${midlet.home}/res"/>
        </wtkpackage>

        <!-- 產生 Palm PRC (可選) -->
        <wtkmakeprc jadfile="${midlet.name}.jad"
                    prcfile="${midlet.name}.prc"/>

        <!-- 直接啟動模擬器測試 -->
        <wtkrun jadfile="${midlet.name}.jad" device="DefaultColorPhone"/>
    </target>
</project>

執行

命令列執行 ant 即可完成全流程。

Ant 安裝提醒

下載 Ant，設定 ANT_HOME 指向安裝目錄，將 %ANT_HOME%\bin 加入 PATH。