JBuilder 2005 + CommentProcessor 構建 J2ME 多版本專案實戰

專案背景

• 目標平台：Nokia S30/S40/S60、Sony K700/F500、Motorola V525/i730、Sharp GX10、Siemens C65 等 15+ 型號
• 語言包：每平台 5+ 國際化版本
• 遊戲類型：俯視視角動作解謎，含行走、跳躍、射擊、AI 視野、夜視等機制
• 代碼相似度：平台間邏輯復用率 ~80%

專案結構設計

專案組織織

<GameName>.bpgr (專案組)
├── 諾基亞S40.jpx
│   ├── _src (預處理前源碼，版控)
│   ├── res (資源文件，版控)
│   ├── src (預處理後源碼，臨時，不版控)
│   ├── Build任務: 生成 CH/EN JAR/JAD
│   └── External Build Task: CommentProcessor 預處理
├── 諾基亞S60.jpx
├── SonyK700.jpx
└── ...

核心原則

• 唯一源碼源：_src 為唯一維護入口，嚴禁複製粘貼產生多份源碼
• 預處理輸出隔離：src 為臨時生成目錄，不納入版本控制
• 資源統一管理：res 目錄統一存放，打包時按平台重命名（如 chr_S40.png → chr.png）

CommentProcessor 關鍵應用

1. 代碼裁剪指令

• //#+ //#-：塊級啟用/禁用
• //#prefix+ //#prefix-：前綴模式，批量處理
• 針對龐大工具庫，精準裁剪無用方法，減小 JAR 體積

2. 平台定義文件

每平台一個定義文件，聲明常量、字串、API 開關，驅動預處理流程。

3. 構建順序保障

預處理任務綁定在 Compile 之前，確保每次 Rebuild 產出最新平台代碼。

4. 調試代碼隔離

//#ifdef DEBUG
// 調試日志、測試邏輯
//#endif

發布版自動剔除，零運行開銷。

打包優化技巧

• 資源文件統一邏輯名（chr、script），物理文件按平台命名（chr_S40.png）
• JBuilder 打包時重命名為邏輯名，縮短 JAR 內文件名長度，微幅減小體積

工具鏈協同

• 利用 JBuilder 專案組管理多平台專案
• Borland Make 支援增量構建與依賴檢查
• External Build Task 無縫調用 CommentProcessor

總結收益

1. 工具庫複用率大幅提升，目標代碼更精簡高效
2. 專案組管理 + 自動化構建，單人即可維護 15+ 平台 × 5+ 語言 = 75+ 發布包
3. 源碼單一維護，消除版本分叉風險

雖然 JBuilder 早已退出歷史舞台，但「單一源碼 + 預處理 + 專案組管理」的工程化思想，對現代 Gradle/Maven 多渠道打包依然具有指導意義。