NetBeans Mobility Pack 預處理器實戰：多終端適配的最佳實踐

前言：碎片化終端的痛點

Java ME 設備屏幕尺寸、按鍵映射、 API 支援度差異巨大，導致多終端移植成本極高。預處理器在編譯前根據目標設備屬性裁剪代碼，實現「一碼多端」，是解決碎片化的利器。

主流預處理器方案對比

• J2ME Polish：功能強大，配置複雜，社區活躍
• Antenna：Ant 任務集成，輕量靈活
• NetBeans Mobility Pack：IDE 深度集成，易用性最佳，本文重點介紹

核心概念：Configuration（配置）

Mobility Pack 引入的「配置」概念，為每個目標設備定義獨立的構建環境，包含：

• 平台與模擬器
• Abilities（能力集）：API 支援、屏幕尺寸、文件格式、自定義屬性——預處理器判斷依據
• 應用描述（JAD/JAR 屬性）
• Build 參數：源碼過濾、編譯選項、混淆、簽名等
• 部署參數

預處理器指令語法

• 指令以 //# 開頭，嵌入註釋中
• 條件成立 → 保留代碼；不成立 → 註釋掉
• 常用指令：#ifdef、#ifndef、#else、#endif、#define、#undefine

實戰配置步驟

1. 專案屬性中新增多個 Configuration（如 Nokia_S40、Sony_K700）
2. 在每個 Configuration 中定義 Abilities（如 screen.width=240、api.mmapi=true）
3. 源碼中使用預處理指令：

   //#ifdef screen.width==240
   // 240x320 專用佈局代碼
   //#else
   // 176x208 兼容代碼
   //#endif

4. 構建時選擇目標 Configuration，IDE 自動生成對應版本

資源文件過濾技巧

修改 nbproject/build-impl.xml，在 pre-init target 中添加排除規則：

<target name="pre-init">
  <defaultexcludes add="**/*.db"/>
  <defaultexcludes add="**/*.tmp"/>
</target>

防止版本控制、臨時文件打包進 JAR。

優缺點權衡

最佳實踐建議

• 將平台差異代碼封裝到專用類/接口，預處理僅控制實現類注入
• 建立共享核心庫，配合 //#+ //#- 精細裁剪工具方法
• 每個 Configuration 維護專屬預處理定義文件（常量、字串、開關）
• 預處理任務必須置於編譯之前執行
• 調試代碼統一用 //#ifdef DEBUG 包裹，發布版自動剔除

NetBeans Mobility Pack 預處理器以 IDE 原生集成優勢，成為中小團隊應對 Java ME 碎片化的首選方案。合理架構配合規範使用，可最大化收益、最小化風險。