MIDP 2.0 platformRequest() 實現 MIDlet 自動更新升級

MIDP 2.0 新增 MIDlet.platformRequest(String url) 方法，可呼叫平台原生應用程式：撥打電話 (tel:...)、開啟 WAP 瀏覽器 (https://...)、安裝/更新 MIDlet 套件 (.jad 或 .jar URL)。本文詳細說明如何實作應用程式自動更新功能。

platformRequest() 基本用法

// 撥打電話
platformRequest("tel:+886912345678");

// 開啟 WAP 瀏覽器
platformRequest("https://wap.example.com/index.wml");

// 安裝/更新 MIDlet (指向 JAD 或 JAR)
platformRequest("https://example.com/app/HelloWorld.jad");

自動更新架構設計

1. MIDlet 啟動時連線版本檢查伺服器
2. 伺服器回傳最新版本號與下載 URL
3. 若有新版本，提示使用者或自動觸發更新
4. 呼叫 platformRequest(jarUrl) 啟動系統安裝程式
5. 目前 MIDlet 必須主動退出 (destroyApp/notifyDestroyed)
6. 安裝完成後，使用者重新啟動即為新版本

完整實作範例

public class AutoUpdateMIDlet extends MIDlet {
    private static final String VERSION_URL = 
        "https://example.com/api/version.txt";
    private static final String DOWNLOAD_URL = 
        "https://example.com/download/MyApp.jar";
    private static final String CURRENT_VERSION = "1.0.0";
    
    private Display display;

    protected void startApp() {
        if (display == null) {
            display = Display.getDisplay(this);
            checkUpdateAsync();
        }
    }

    private void checkUpdateAsync() {
        new Thread() {
            public void run() {
                try {
                    String latest = fetchVersion(VERSION_URL);
                    if (isNewer(latest, CURRENT_VERSION)) {
                        // 切換到事件執行緒顯示確認對話框
                        Display.getDisplay(AutoUpdateMIDlet.this).callSerially(() -> {
                            showUpdateConfirm(latest);
                        });
                    } else {
                        showMainScreen();
                    }
                } catch (IOException e) {
                    // 網路錯誤靜默處理，進入主畫面
                    Display.getDisplay(AutoUpdateMIDlet.this).callSerially(
                        AutoUpdateMIDlet.this::showMainScreen);
                }
            }
        }.start();
    }

    private String fetchVersion(String url) throws IOException {
        HttpConnection conn = (HttpConnection) Connector.open(url);
        try (DataInputStream dis = new DataInputStream(conn.openInputStream())) {
            return dis.readUTF().trim(); // 伺服器回傳 "1.0.1"
        } finally { conn.close(); }
    }

    private boolean isNewer(String latest, String current) {
        // 簡單版本號比較，實際建議用語意化版本解析
        return latest.compareTo(current) > 0;
    }

    private void showUpdateConfirm(String latestVersion) {
        Form form = new Form("發現新版本");
        form.append("目前版本: " + CURRENT_VERSION + "\n");
        form.append("最新版本: " + latestVersion + "\n\n");
        form.append("立即更新？");
        
        Command yes = new Command("更新", Command.OK, 1);
        Command no = new Command("稍後", Command.CANCEL, 2);
        form.addCommand(yes);
        form.addCommand(no);
        form.setCommandListener(c -> {
            if (c == yes) performUpdate();
            else showMainScreen();
        });
        display.setCurrent(form);
    }

    private void performUpdate() {
        try {
            // 觸發系統安裝程式
            platformRequest(DOWNLOAD_URL);
            // 必須退出目前 MIDlet 讓安裝程式接管
            destroyApp(true);
            notifyDestroyed();
        } catch (ConnectionNotFoundException e) {
            showAlert("錯誤", "無法啟動安裝程式");
        } catch (MIDletStateChangeException e) {
            e.printStackTrace();
        }
    }

    private void showMainScreen() {
        Form main = new Form("主選單");
        main.append("歡迎使用 v" + CURRENT_VERSION);
        display.setCurrent(main);
    }
}

伺服器端版本 API 範例

// version.txt 內容純文字
1.0.1

// 或 JSON 格式 (需客戶端解析)
{
  "version": "1.0.1",
  "url": "https://example.com/download/MyApp-1.0.1.jar",
  "force": false,
  "changelog": "修正登入閃退、優化圖片載入"
}

進階：背景下載 + 靜默安裝 (部分平台支援)

某些平台 (如 Nokia S60 3rd+) 支援背景下載 JAR，下載完成後再提示安裝，不需中斷應用流程。但標準 MIDP 2.0 僅保證 platformRequest 基本行為。

關鍵注意事項

測試驗證

• WTK 模擬器：platformRequest 會在主控台列印 URL，不會真正安裝
• 真機測試：Nokia 7610、N73、E63 等 S60 機型驗證通過
• 邊界測試：網路中斷、儲存空間不足、簽名不符、版本號相同/降級

最佳實務總結

• ✅ 啟動時非同步檢查版本，不阻塞主畫面
• ✅ 提供使用者選擇權 (立即/稍後/跳過此版本)
• ✅ 顯示更新內容與預估大小/時間
• ✅ 使用 HTTPS 保護下載完整性
• ✅ 伺服器端實作漸進式發布 (灰度發佈)
• ✅ 記錄更新日誌供客戶端顯示
• ✅ 保留舊版本下載連結一段時間供回滾

實作自動更新機制能大幅降低使用者使用舊版本比例，確保安全性修正與新功能快速觸達，是成熟商業級 J2ME 應用的必備功能。