Sun J2ME Wireless Toolkit (WTK) 完整指南：安裝、專案管理、打包混淆與進階效能調優

目錄結構速查

WTK_ROOT/
├── apps/           # 專案原始碼與資源 (每專案一子目錄)
│   └── MyProject/
│       ├── src/    # Java 源檔
│       ├── res/    # 圖片、音訊等資源
│       └── lib/    # 專案依賴 jar
├── bin/            # 開發工具執行檔
├── docs/           # API 文件、開發指南
├── lib/            # 系統類庫
│   ├── midpapi20.jar
│   ├── cldcapi11.jar
│   ├── wma20.jar, wma11.jar
│   ├── mmapi.jar, jsr172.jar, jsr75.jar, jsr82.jar, jsr184.jar
├── wtklib/         # 模擬器皮膚、核心程式
└── sessions/       # 效能分析資料

KToolbar 專案生命週期操作

建立專案

1. 啟動 KToolbar (WTK 主介面)。
2. New Project → 輸入專案名與主 MIDlet 類名（通常同名）。
3. 選擇目標平台、CLDC/MIDP 版本、可選包（按需勾選，減小 JAR）。
4. 設定 MIDlet 屬性（圖示、描述、權限等），將寫入 JAD。

原始碼與資源放置規範

• Java 檔 → apps/專案名/src/（套件結構對應目錄）。
• 資源檔 → apps/專案名/res/（代碼中用 /res/xxx.png 訪問）。
• 第三方 Jar → apps/專案名/lib/（建構時自動加入 classpath）。

編譯、運行、除錯

• Build：編譯 + 預驗證，錯誤顯示於控制台。
• Run：啟動預設模擬器運行，支援多模擬器皮膚切換。
• Run MIDP Application...：直接載入外部 JAD/JAR 測試（路徑勿含中文）。

打包發布：JAR 生成與混淆

標準打包

KToolbar → Project → Package → Create Package → 輸出至 apps/專案名/bin/：

• 專案名.jar：類檔 + 資源 + Manifest
• 專案名.jad：描述檔（含 MIDlet-Jar-URL、MIDlet-Jar-Size 等）

ProGuard 混淆縮減 JAR 體積

1. 下載 ProGuard，解壓取 lib/proguard.jar。
2. 複製至 WTK_ROOT/bin/。
3. KToolbar → Project → Package → Create Obfuscated Package。

效果：類/方法/欄位重命名為 a/b/c...，JAR 體積通常縮減 30%-50%，並提高反編譯難度。

進階效能調優功能

Edit → Preferences → Monitoring 啟用：

實戰避坑指南

• ❌ 模擬器 ≠ 真機：模擬器 CPU/記憶體/網絡遠優於真機，必須真機測試。
• ❌ System.gc() 濫用：J2ME GC 非決定性，依賴它釋放資源不可靠。
• ✅ 資源路徑：統一用 /res/xxx 絕對路徑，相對路徑在打包後常失效。
• ✅ JAD/JAR 大小一致：混淆後務必更新 JAD 中的 MIDlet-Jar-Size，否則安裝失敗。
• ✅ 預驗證：WTK Build 自動預驗證，手動用 preverify 僅在整合第三方 class 時需要。