MIDP 應用屬性機制權威指南：系統屬性表、JAD/MANIFEST 優先級、getAppProperty 最佳實踐

兩類屬性來源

• 系統屬性：由 CLDC/MIDP/可選包規範定義，System.getProperty(key) 讀取，只讀
• 應用屬性：定義於 JAD 或 MANIFEST.MF，MIDlet.getAppProperty(key) 讀取，部署時可配置

完整系統屬性參考表 (按 JSR 分組)

運行時檢測代碼模板

String clcdVer = System.getProperty("microedition.configuration"); // CLDC-1.0/1.1
String midpVer = System.getProperty("microedition.profiles");      // MIDP-1.0/2.0
String jtwiVer = System.getProperty("microedition.jtwi.version");  // JTWI 支持?
String mmaVer  = System.getProperty("microedition.mma.version");   // MMAPI 完整版?
String pimVer  = System.getProperty("microedition.pim.version");   // JSR 75 PIM?
String locationVer = System.getProperty("microedition.location.version"); // JSR 179?

應用屬性：JAD 與 MANIFEST.MF 交互規則

必備屬性 (雙方必有，簽名 Suite 必須一致)

• MIDlet-Name
• MIDlet-Version
• MIDlet-Vendor

JAD 專有必備屬性

• MIDlet-Jar-URL (OTA 必須絕對路徑)
• MIDlet-Jar-Size (字節數)

MANIFEST 專有必備屬性 (JAD 可缺省)

• MIDlet-<n> (每個 MIDlet 描述)
• MicroEdition-Profile
• MicroEdition-Configuration

優先級邏輯 (MIDP 2.0 規範 §10.2.5)

// 可信任 Suite (已簽名並驗證)
if (trusted) {
    v0 = MANIFEST[key]; v1 = JAD[key];
    if (v0 != null && v1 != null) assert v0.equals(v1); // 關鍵屬性必須一致
    value = (v1 != null) ? v1 : v0; // JAD 覆蓋非關鍵屬性
}
// 非可信任 Suite (未簽名)
else {
    value = JAD[key];           // 優先 JAD
    if (value == null) value = MANIFEST[key]; // 回退 MANIFEST
}

實戰：自定義屬性實現免重編譯配置

JAD 中定義

SERVER_URL: https://api.mycompany.com/v1/
MAX_RETRY: 3
TIMEOUT_MS: 5000
DEBUG_MODE: true

MIDlet 中讀取並類型轉換

public class Config {
    private static Config instance;
    private String serverUrl;
    private int maxRetry;
    private int timeoutMs;
    private boolean debugMode;

    private Config(MIDlet midlet) {
        serverUrl = midlet.getAppProperty("SERVER_URL");
        maxRetry = parseInt(midlet.getAppProperty("MAX_RETRY"), 3);
        timeoutMs = parseInt(midlet.getAppProperty("TIMEOUT_MS"), 5000);
        debugMode = "true".equalsIgnoreCase(midlet.getAppProperty("DEBUG_MODE"));
    }

    public static Config getInstance(MIDlet midlet) {
        if (instance == null) instance = new Config(midlet);
        return instance;
    }

    private int parseInt(String s, int def) {
        try { return Integer.parseInt(s); } catch (Exception e) { return def; }
    }
    // getters...
}

典型 JAD 文件完整示例

MIDlet-Name: MyGame
MIDlet-Version: 1.2.0
MIDlet-Vendor: GameStudio Inc.
MIDlet-1: MyGame,/icon.png,com.gamestudio.MyGame
MIDlet-Jar-URL: https://cdn.gamestudio.com/MyGame.jar
MIDlet-Jar-Size: 45678
MicroEdition-Profile: MIDP-2.0
MicroEdition-Configuration: CLDC-1.1
MIDlet-Description: Awesome 2D Action Game
MIDlet-Icon: /icon.png
MIDlet-Info-URL: https://gamestudio.com/MyGame
MIDlet-Data-Size: 10240
MIDlet-Permissions: javax.microedition.io.Connector.http
MIDlet-Permissions-Opt: javax.microedition.io.Connector.socket
SERVER_URL: https://api.gamestudio.com/v1/
MAX_RETRY: 3
DEBUG_MODE: false

避坑指南

總結

系統屬性用於**運行時能力檢測** (CLDC/MIDP 版本、可選包支持)，應用屬性用於**部署時配置外部化** (URL、超時、開關)。掌握 JAD/MANIFEST 優先級邏輯、簽名一致性要求、自定義屬性最佳實踐，是專業 MIDP 開發者的必備基本功。

1. 上一篇文章： J2ME 調用 .NET Web Services 實戰：JSR 172 Stub 生成、異步調用與 kSOAP 替代方案對比
2. 下一篇文章： J2ME 內存優化實戰寶典：手動釋放、對象復用、圖片優化、工具鏈與監測代碼模板

J2ME

Sony Ericsson J2ME SDK 整合 Eclipse 開發環境完整實戰教程

前言：為何選擇 SE SDK + Eclipse？ Sony

J2ME 3D 學習筆記：M3G 簡易介面實作範例

完整可運行範例：載入 .m3g 場景並啟用鍵盤移動攝影機

J2ME手機遊戲開發技巧（一）：雙緩衝防閃爍與自訂斷點調試

雙緩衝技術：消除畫面閃爍的關鍵 雙緩衝是電腦動畫傳統技術，也

MIDP 圖片透明度漸變效果實作：像素級 Alpha 動畫

效果描述 將一張不透明圖片從完全透明（Alpha=0）逐漸變