J2ME Polish 入門實戰：設備優化、預處理指令、Ant 構建與調試功能詳解

什麼是 J2ME Polish？

德國開源項目，J2ME 開發的「預處理器 + 構建框架 + 設備庫」。解決核心痛點：

• 同一代碼庫針對不同設備 (API、屏幕、性能) 生成差異化構建。
• 自動化打包、混淆、簽名、部署。
• 強大的調試輔助 (代碼級、運行時)。

官網：j2mepolish.org

核心功能一：設備優化與預處理指令

場景：播放音效

• MIDP 2.0 / MMAPI 設備：Manager.createPlayer(is, "audio/midi")
• Nokia UI 設備：new Sound(400,1000).play(1)

傳統做法

維護多套源碼，或運行時 if-else 判斷 (增加體積、降低性能)。

Polish 方案：編譯時預處理

// 源碼中嵌入預處理指令 (以 //# 開頭)
 //#if polish.midp2 || polish.api.mmapi
 try {
     InputStream is = getClass().getResourceAsStream("/mymid.mid");
     Player player = Manager.createPlayer(is, "audio/midi");
     player.realize(); player.start();
 } catch (MediaException me) {
     //#debug error
     System.out.println("Unable to play midi: " + me);
 } catch (IOException ioe) {
     //#debug error
     System.out.println("Unable to load midi: " + ioe);
 }
 //#elif polish.api.nokia-ui
     Sound s = new Sound(400, 1000);
     s.setGain(100);
     s.play(1);
 //#endif

預處理語法

• //#if condition、//#elif condition、//#else、//#endif：條件編譯，語法同 C/C++。
• //#debug level：調試輸出控制 (error、warn、info、debug)，構建時可過濾級別。
• 條件變量：polish.midp2、polish.api.mmapi、polish.api.nokia-ui、polish.ScreenWidth、polish.HeapSize 等數百個預定義變量，覆蓋平台、API、硬件特性。

核心功能二：Ant 構建多設備發布

<!-- build.xml 片段 -->
<property name="polish.dir" location="../j2mepolish"/>
<import file="${polish.dir}/build.xml"/>

<target name="build-all">
    <polish.emulator
        devices="Nokia/Series40, Generic/midp2"
        >
        <requirement name="Identifier" value="Nokia/Series40,Generic/midp2"/>
    </polish.emulator>
</target>

• devices 指定目標設備組 (來自 devices.xml 數據庫，含數千機型特性)。
• 構建過程：預處理 → 編譯 → 預驗證 → 混淆 (ProGuard) → 打包 JAR/JAD → 簽名 → 生成 OTA 下載頁面。
• 每種設備生成獨立優化構建，無冗餘代碼，JAR 體積最小化。

核心功能三：強大調試支持

• //#debug 指令配合構建參數，實現「開發版含詳細日誌、發布版零開銷」。
• 運行時調試代理：通過 Socket 連接 PC 端控制台，查看變量、堆棧、內存、線程狀態。
• 模擬器集成：一鍵啟動多設備模擬器並行測試。

學習路徑建議

1. 下載 Polish，研究 samples/ 目錄完整項目結構。
2. 閱讀 devices.xml 理解設備能力描述模型。
3. 在現有 Ant/Maven 項目中集成 polish.task，嘗試雙設備構建。
4. 掌握 //#if、//#debug、//#define 等指令，重構現有條件編譯邏輯。

總結

J2ME Polish 為 Java 引入了「編譯時預處理 + 設備感知構建」能力，**徹底解決了「一碼多端、差異化優化、自動化發布」的工程化難題**，是中大型 J2ME 專案、產品線開發的標配利器。