使用「延伸」頁面瀏覽和編輯外掛程式延伸。 延伸是對平台提供行為的主要機制。 除非您的外掛程式是其他外掛程式可使用的簡單 Java API 程式庫,否則會以延伸項 目來提供新的行為。
外掛程式提供它們需要的外掛程式所定義的延伸點。延伸語法必須 符合延伸點定義才能正確處理。 PDE 透過遍訪所有可見的外掛程式(工作區和外部)計算合格延伸點清單總計。
PDE 提供的通用延伸精靈只掃描延伸點。如果有提供延伸綱目(請參閱延伸點綱目),那麼精靈會從綱目擷 取文法和延伸點 meta 資料。
除了通用精靈之外,有數個可用的延伸項目範本。 這些是相同的範本,可用來產生外掛程式專案的起始內容。 他們的存在讓您可以安排延伸項目的建立。 您可以使用簡單檢視畫面建立外掛程式,然後新增編輯器或精靈。
為了說明「延伸」頁面的作業,我們會將 'Hello, PDE world' 動作新增至外掛 程式。 我們會提供 org.eclipse.ui.actionSets 延伸點。這個範例假設您熟悉延伸點。
第一步是按新增...按鈕選取延伸精靈:
綱目型延伸精靈是預設值,因為它使用最常見的方式處理 延伸。 它會掃描外掛程式並提供找到的所有延伸點(有或沒有綱目)。 含有綱目的延伸點允許 PDE 提供更好的協助。 如果遺漏延伸點綱目,那麼 PDE 可讓您將元素和屬性新增至延伸,但是如果對於選 取的延伸點來說這些元素和屬性有效,則無法驗證延伸。
按下一步,就會提供延伸點清單。選取 org.eclipse.ui.actionSets 並按 完成。
精靈會將新延伸新增至延伸清單。 因為這個延伸有一個相關聯的綱目,所以我們可以進一步編輯延伸定義。 我們選取新增加的延伸並從蹦現功能表選取新建->動作集。 這個 XML 元素已定義為可以顯示在延伸定義中的唯一有效元素。
對於所有必要的屬性來說,PDE 會建立預設值。我們可以 變更動作集的預設名稱成為 "Sample Action Set",方法是選取元素並在 「內容」檢視畫面變更標籤內容。 新名稱會顯示在延伸清單。
現在我們需要定義動作集的功能表和動作。 如果選取動作集並在 "Extension Element Children" 區段蹦現功能表, 那麼「新建」功能表會提供兩個選項: 功能表和動作。這些 選項依據動作集延伸的綱目資訊。首先,我們建立功能表。
我們可以採取類似方法建立動作:
我們需要設定的最後一項是動作的 Java 類別。 延伸點定義指定動作必須實作 IWorkbenchWindowActionDelegate 。PDE 可以提供協助,因為它從綱目知道這個資訊:
按完成之前,對話框應該如下:
完成時,會依據必要的介面(含有每一種抽象方法的 Stub 實作) 產生新類別。 此外,會為類別內容值設定新類別的名稱。 依預設精靈也會開啟要編輯的新 Java 類別。您可以尋找 "run" 方法並 新增下列陳述式:
System.out.println("Hello, PDE world!");
儲存新的原始碼並關閉 Java 編輯器。然後返回 Manifest 編輯器的「延伸」頁面並儲存。
在執行外掛程式時我們會繼續這 個範例。