NetBeans 外掛開發實戰：打造您的第一個模組

NetBeans 模組開發快速入門

NetBeans 平台提供完整的模組化架構，讓開發者能輕鬆擴充 IDE 功能。本文將引導您從零建立一個具備工具列按鈕、對話框互動的完整外掛。

步驟 1：建立新模組專案

1. File → New Project，分類選 NetBeans Modules，專案選 Module
2. 命名為 HelloYou，其他保持預設
3. 基底套件命名為 org.yourorg.helloyou

步驟 2：加入 Action（動作）

1. 在原始碼套件右鍵 New → Action
2. Action Type 保持預設 Always Enabled
3. GUI Registration：選 Menu: File、Global Toolbar Button、Toolbar: Build、Position: Profile Main Project... - HERE
4. Name, Icon, Location：類別名 HelloAction，顯示名稱自訂，圖示需 16×16 與 24×24 兩種尺寸（命名慣例：icon.png / icon24.png）

步驟 3：測試空白模組

專案結構如下：

右鍵專案節點（拼圖圖示）選 Install/Reload in Target Platform，將啟動新 NetBeans 實例並載入模組：

工具列將出現自訂按鈕（此時點擊無反應）：

步驟 4：建立模組相依性

需使用 Dialogs API 顯示對話框，需加入相依：

1. 右鍵專案 Properties → Libraries
2. 點 Add 依賴，過濾輸入 dialogs，選擇 Dialogs API

步驟 5：實作 Action 邏輯

修改 HelloAction.java 的 performAction()：

版本一：簡單訊息對話框

public void performAction() {
    String msg = "Hello NetBeans World!";
    int msgType = NotifyDescriptor.INFORMATION_MESSAGE;
    NotifyDescriptor d = new NotifyDescriptor.Message(msg, msgType);
    DialogDisplayer.getDefault().notify(d);
}

重新 Install/Reload 後點擊按鈕：

版本二：輸入對話框互動

public void performAction() {
    NotifyDescriptor.InputLine question = new NotifyDescriptor.InputLine(
        "Name:", "What's your name?",
        NotifyDescriptor.OK_CANCEL_OPTION,
        NotifyDescriptor.QUESTION_MESSAGE
    );
    if (DialogDisplayer.getDefault().notify(question) == NotifyDescriptor.OK_OPTION) {
        String msg = "Hello " + question.getInputText() + "!";
        NotifyDescriptor d = new NotifyDescriptor.Message(msg, NotifyDescriptor.INFORMATION_MESSAGE);
        DialogDisplayer.getDefault().notify(d);
    }
}

執行結果：

小結

您已完成第一個 NetBeans 外掛！核心流程：建立模組 → 定義 Action → 設定 GUI 註冊 → 管理相依性 → 實作邏輯。後續可探索 Explorer API、DataSystems API 等進階主題，打造功能豐富的 IDE 擴充套件。