J2ME 專案打包發布必檢清單：JAD/JAR 大小寫、中文、垃圾檔與混淆

前言

J2ME 專案開發完成，打包成 .jad + .jar 看似簡單，但手機端執行環境嚴格，稍有疏忽即導致安裝失敗或運行異常。本文整理四大必檢項目，助你一次上架成功。

四大關鍵檢查點

1. 資源檔名大小寫一致性

• Windows 檔案系統**不區分大小寫**，手機**嚴格區分**
• 程式碼 Image.createImage("/res/Icon.png")，實際檔案若為 icon.png → 手機拋 NullPointerException
• 建議： 統一採用小寫檔名，程式碼與資源同步修正

2. 中文資訊務必用工具產生

• JAD 中的 MIDlet-Name、MIDlet-Description 等若含中文，手動編輯易產生編碼錯誤（UTF-8 vs Big5）
• 建議： 使用 IDE 內建打包精靈或 WTK ktoolbar 圖形介面設定，自動處理編碼與 Base64

3. 清理 JAR 內的垃圾檔案

• Windows 隱藏檔 Thumbs.db、.DS_Store 等常被誤打包
• 雖小但佔寶貴的 JAR 空間（部分手機限制 100~300 KB）
• 建議： 打包前以 jar tf 檢視清單，或在 Ant/Maven 排除 **/Thumbs.db

4. 啟用程式碼混淆

• 主要目的**非防反編譯**，而是**縮減 JAR 體積**（縮短類別/方法/欄位名稱、移除未用代碼、壓縮行號）
• 常用工具：ProGuard、RetroGuard、WTK 內建混淆器
• 注意： 保留反射用到的類別/方法（如 Class.forName、序列化類別）

發布前最終驗收流程

1. 在模擬器完整跑一次主流程
2. 實機測試（至少兩款不同廠牌/螢幕尺寸）
3. 檢查 JAD 中 MIDlet-Jar-Size 與實際 JAR 大小一致
4. 確認 MIDlet-Data-Size、MicroEdition-Profile/Configuration 正確