NetBeans 專案配置：輕鬆實現 J2ME 遊戲多裝置移植

前言：移植難題與 NetBeans 的解決之道

在 J2ME 遊戲開發中，將遊戲移植到不同手機型號向來是開發者的痛點。螢幕解析度、色深、支援的 JSR 擴展包、記憶體限制……每款裝置都有獨特的硬體規格與 API 差異。傳統做法往往需要維護多套原始碼，或是用大量 if-else 判斷散落在業務邏輯中，維護成本極高。

NetBeans IDE（早期版本）透過 Project Configuration（專案配置） 機制，提供了一套優雅的解決方案：將「裝置差異」抽象為「配置屬性」，並在建構過程中自動進行程式碼裁剪與資源打包。本文詳細拆解此機制的核心概念與實戰用法。

核心概念：Configuration 解剖

每一個 Configuration 代表一個目標裝置群組（例如「Nokia S40 系列 240x320」或「Sony Ericsson MIDP 2.0 176x220」），包含以下五大屬性面向：

1. Platform（目標平台）

• 指定模擬器廠商、裝置皮膚、螢幕尺寸
• 勾選支援的 JSR 擴展包（JSR 118 MIDP 2.0、JSR 135 MMAPI、JSR 184 3D 等）
• 決定編譯時的 bootclasspath 與預驗證目標

2. Abilities（平台能力描述）

自訂鍵值對屬性，供前置處理器判斷使用。常見範例：

• ScreenSize="176x220"
• ScreenColorDepth=16
• HasTouchScreen=false
• MaxJarSize=65536
• SupportJSR184=true

這些屬性純粹由開發者定義，NetBeans 不解釋其語義，僅在前置處理時作為條件判斷依據。

3. Sources Filter（原始碼過濾）

以 Ant 模式匹配決定哪些 .java 檔案參與編譯。典型用法：

• **/common/** — 所有配置共用的核心邏輯
• **/nokia/** — 僅 Nokia 配置編譯的專用類別
• **/ui/** — 通用 UI，但可再搭配子資料夾細分

若將圖片、音效等資源同置於 src 目錄下，同樣可用此機制控制資源打包。

4. Libraries & Resources（類庫與資源）

• 指定每個配置專屬的第三方 JAR（如針對特定裝置優化的圖片壓縮庫）
• 掛載配置專屬的資源目錄（res/nokia/、res/sony/），解決不同裝置需不同解析度圖片、不同音效格式的問題

5. Creating JAR（輸出設定）

• 自訂 JAD/JAR 檔名模板，例如 MyGame-${cfg.name}.jar
• 設定 JAD 屬性（MIDlet-Name、MIDlet-Vendor、MicroEdition-Profile 等）
• 啟用/停用混淆、壓縮、預驗證等後處理步驟

實戰：前置處理指示符與程式碼裁剪

在原始碼中使用 //#if、//#elif、//#endif 註解指示符，NetBeans 建構時會依據 Active Configuration 的 Abilities 屬性，自動將不符合條件的程式碼區塊「註解化」，只編譯目標裝置需要的邏輯。

//#if ScreenSize == "128x160"
int tileWidth = 12;
//#elif ScreenSize == "176x208"
int tileWidth = 16;
//#elif ScreenSize == "240x320"
int tileWidth = 20;
//#else
int tileWidth = 12; // 預設回落
//#endif

關鍵優勢：

• 業務邏輯保持單一代碼庫，無需複製貼上
• 編譯產出的 JAR 僅包含目標裝置需要的類別與常數，體積最小化
• IDE 內即時切換 Active Configuration 即可預覽不同裝置的編譯結果

一鍵全量建構：Build All Project Configurations

點選專案右鍵 → Build All Project Configurations，NetBeans 會依序對每個 Configuration 執行完整建構流程，並在 dist/ 目錄下產生以配置命名的子資料夾：

dist/
├── Nokia_S40_240x320/
│   ├── MyGame.jad
│   └── MyGame.jar
├── SE_MIDP2_176x220/
│   ├── MyGame.jad
│   └── MyGame.jar
└── Generic_MIDP1_128x128/
    ├── MyGame.jad
    └── MyGame.jar

此功能極適合 CI/CD 整合，一次提交即可產出全機種安裝包。

最佳實踐建議

1. 能力屬性標準化： 團隊內訂定命名規範（如 ScreenWidth、ScreenHeight、HeapSizeKB），避免同義詞混亂。
2. 共用程式碼前置： 將平台無關邏輯置於 common/，平台相關介面定義於 api/，具體實作於各配置專屬套件。
3. 資源分級： 通用資源放 res/common/，差異資源放 res/${cfg.name}/，建構腳本自動合併。
4. 持續整合： 結合 Ant/Maven/Gradle 腳本，在 Jenkins/GitLab CI 中執行 ant build-all-configs，自動發布至測試平台。

結語

NetBeans 的 Configuration 機制將「裝置碎片化」轉化為「可配置的建構參數」，配合前置處理器實現編譯期程式碼裁剪，是 J2ME 時代極具前瞻性的工程化方案。雖然 J2ME 已淡出主流舞台，但這套「配置驅動建構、條件編譯、多產出物」的思維，在現代 Android Flavor、iOS Target、Webpack Multi-Compiler、Flutter Flavor 等跨平台建構體系中依然熠熠生輝。