J2ME OTA 空中下載發布全流程：MIME 配置、WML 頁面與 JAD 動態生成實戰

OTA (Over-The-Air) 發布架構

OTA 允許用戶透過手機瀏覽器直接下載安裝 MIDlet，無需資料線/藍牙/紅外。核心流程：WAP 瀏覽器訪問 WML 頁面 → 點擊 JAD 鏈接 → 手機下載 JAD → 解析 JAD 中的 JAR URL → 下載 JAR → 安裝驗證。

伺服器端 MIME 類型配置 (關鍵步驟)

若伺服器未正確配置 MIME，手機將無法識別 JAD/JAR，導致下載失敗或顯示亂碼。

最小化 WML 下載頁面

  
    

      MyGame v1.2

      大小: 128KB | 支援: MIDP 2.0/CLDC 1.1

      立即下載
        
      
    
  

• 儲存為 index.wml 或 download.wml，置於網站根目錄或專屬目錄。
• 確保伺服器回應 Content-Type: text/vnd.wap.wml。

JAD 動態生成關鍵屬性

JAD 必須包含 MIDlet-Jar-URL 指向 JAR 絕對路徑，否則手機無法定位 JAR。

MIDlet-Name: MyGame
MIDlet-Version: 1.2
MIDlet-Vendor: MyStudio
MIDlet-Jar-URL: https://cdn.example.com/games/mygame.jar
MIDlet-Jar-Size: 131072
MIDlet-1: MyGame, /res/icon.png, com.mygame.MainMidlet
MicroEdition-Profile: MIDP-2.0
MicroEdition-Configuration: CLDC-1.1

動態生成 JAD 的 Servlet 範例

@WebServlet("/game.jad")
public class JadServlet extends HttpServlet {
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) 
            throws ServletException, IOException {
        String jarUrl = "https://" + req.getServerName() 
                      + ":" + req.getServerPort() 
                      + req.getContextPath() + "/game.jar";
        long jarSize = new File(getServletContext().getRealPath("/game.jar")).length();
        
        String jad = "MIDlet-Name: MyGame\n" +
                     "MIDlet-Version: 1.2\n" +
                     "MIDlet-Vendor: MyStudio\n" +
                     "MIDlet-Jar-URL: " + jarUrl + "\n" +
                     "MIDlet-Jar-Size: " + jarSize + "\n" +
                     "MIDlet-1: MyGame, /res/icon.png, com.mygame.MainMidlet\n" +
                     "MicroEdition-Profile: MIDP-2.0\n" +
                     "MicroEdition-Configuration: CLDC-1.1\n";
        
        resp.setContentType("text/vnd.sun.j2me.app-descriptor; charset=UTF-8");
        resp.getWriter().write(jad);
    }
}

完整發布檢查清單

1. ✅ JAR 經 ProGuard 混淆、預驗證、簽名 (如需信任域權限)。
2. ✅ JAD 中 MIDlet-Jar-Size 與實際 JAR 檔案大小**完全一致** (位元組級)。
3. ✅ 伺服器 MIME 類型正確配置。
4. ✅ WML 頁面可在目標手機瀏覽器正常顯示 (測試編碼、排版)。
5. ✅ JAR URL 可直接在電腦瀏覽器下載 (驗證防盜鏈/權限)。
6. ✅ 多機型真機測試安裝流程 (Nokia S40/S60, Sony Ericsson, Motorola 等)。

常見失敗原因排查

進階：OTA 靜默安裝與推送 (JSR 211/248)

部分平台支援 Push Registry (JSR 120/205) 實現伺服器主動喚醒 MIDlet，或 OTA Provisioning (JSR 211) 實現企業級靜默分發，需手機/運營商支援，屬進階主題。