NetBeans平台開發J2ME遊戲實戰講解（一）：環境建置與專案啟動

開發環境準備

開始前請確認已安裝 NetBeans IDE 4.0 與 Mobility Pack 4.0。完整安裝指南可參考 NetBeans 官方中文文檔：J2ME MIDP 開發下載頁面。

建立 MIDP 專案

1. 選擇「檔案」>「新建專案」(Ctrl+Shift+N)，類別選「行動裝置」，專案選「行動應用程式」，點擊「下一步」。
2. 專案名稱輸入 HuaRongDao，主目錄自訂（以下稱 $PROJECTHOME）。
3. 取消勾選「建立 HelloMIDlet」，點擊「下一步」，選擇 CLDC 1.0 / MIDP 1.0 規範。
4. 目標平台選 J2ME Wireless Toolkit，點擊「完成」。IDE 將在 $PROJECTHOME/HuaRongDao 產生專案結構。

新增 MIDlet 並實作 CommandListener

右鍵專案選「新建」>「MIDlet」，名稱設為 HuaRongDao，不指定套件。產生的樣板碼中加入 implements CommandListener 並實作四大生命週期方法與 commandAction。

第一步：加入退出按鈕與 TextBox 測試

public class HuaRongDaoMidlet extends MIDlet implements CommandListener {
    private Display display;
    private final static Command CMD_EXIT = new Command("退出", Command.EXIT, 1);

    public HuaRongDaoMidlet() {
        display = Display.getDisplay(this);
    }

    public void startApp() {
        TextBox t = new TextBox("標題", "內容", 256, 0);
        t.addCommand(CMD_EXIT);
        t.setCommandListener(this);
        display.setCurrent(t); // 原碼誤寫 mainList，此處修正
    }
    // ... pauseApp, destroyApp, commandAction 略
}

重點提示：

• J2ME API 細節請查閱 WTK 安裝目錄下的 docs 文檔。
• 本系列採用 MIDP 1.0 API，確保相容性；MIDP 2.0 雖有 Game API 但早期手機支援度低。
• TextBox 為可輸入文字框，參數依序為標題、預設內容、最大長度、限制條件。

第二步：建立 Images 類別統一管理圖片資源

MIDP 1.0 無法從單張大圖切割子圖（MIDP 2.0 才支援 Image.createImage(Image, x, y, w, h, transform)），故採用陣列儲存各角色獨立圖片。Images 類別定義常數：繪圖邊界 (LEFT, TOP, UNIT)、地圖尺寸 (WIDTH=4, HEIGHT=5)、角色標記 (如 CAOCAO='a')、圖片物件引用。靜態方法 init() 統一載入所有 /res/ 下的 PNG 圖片，若路徑錯誤需在專案屬性「Libraries and Resources」加入 res 絕對路徑。