J2ME Polish Samples 專案建置與客製化完整教學

前置需求

• JDK + WTK (基本環境)
• J2ME Polish：https://www.j2mepolish.org/downloads/，下載 JAR 執行 java -jar J2MEpolish-x.x.x.jar 圖形化安裝
• Eclipse (建議)

匯入範例專案 (以 menu 為例)

1. 複製 ${polish.home}/samples/menu 到 Eclipse 工作區
2. 建立 Java 專案名為 menu (自動導入 src/res 等目錄)
3. 執行 Ant 建構腳本，自動產生多版本 JAR/JAD (不同語言、平台、MIDP 版本)

建構輸出客製化

1. 語言設定 (build.xml 中 <languages> 區段)

<languages>
    <language value="en"/>
    <language value="de"/> <!-- 可改為 cn -->
    <language value="cn"/> <!-- 新增中文 -->
</languages>

新增語言需在 resources/ 建立對應 messages_<lang>.txt。

2. 中文資源檔範例 resources/messages_cn.txt

#######################################
# 翻譯屬性檔，鍵值用 = 分隔
#######################################

# 區域化預處理變數 (以 var: 開頭)
var:MyExampleVariable=你好,midlet
var:GameName=測試

# Polish 內建指令鍵 (無需 var:)
polish.command.ok=確認
polish.command.cancel=取消
polish.command.select=選擇
polish.command.options=選項

# JAD/MANIFEST 屬性
MIDlet-Description=中文哦
MIDlet-Name=J2ME Polish 範例
MIDlet-Delete-Confirm=J2ME Polish

# 應用專用翻譯
cmd.StartGame=${GameName} 開始
cmd.Quit=退出
cmd.ShowLog=Log 顯示

menu.StartGame=${GameName} 開始!
menu.LoadGame=${GameName} 讀取
menu.Highscore=最高分
menu.Quit=退出

messages.welcome=歡迎阿, {0}!!!

3. 模擬器執行參數調整 (build.xml)

<emulator ...>
    <!-- 改為 true 可在建構後自動啟動模擬器 -->
    <property name="polish.emulator.autoRun" value="true"/>

    <!-- 關閉記憶體/網路監視器以簡化視窗 -->
    <property name="enableMemoryMonitor" value="false"/>
    <property name="enableNetworkMonitor" value="false"/>
    <property name="enableProfiler" value="false"/>
</emulator>

建構流程說明

1. Ant 讀取 build.xml
2. 依 <devices>、<languages> 產生所有組合
3. 各組合獨立：預處理 → 編譯 → 預驗證 → 混淆 (可選) → 打包 → 產生 JAD
4. 輸出至 dist/ 目錄，按裝置/語言分資料夾

常見問題

• 中文亂碼：確認 messages_cn.txt 以 UTF-8 儲存，且 build.xml 宣告 encoding="UTF-8"
• 缺少資源：檢查 resources/ 下是否有對應語言檔與圖片
• 預處理指令不生效：確認 build.xml 中 <preprocess> 任務配置正確

J2ME Polish 的強項在於「一次原始碼、多平台建構」。善用 build.xml 的 <devices>、<languages>、<preprocess> 三大機制，可輕鬆管理數十種裝置組合的差異化建構。