外掛程式類別

目前,我們已看過 Readme 工具所提供的不同延伸。 現在,我們要看看 Readme 工具外掛程式的一般定義。

外掛程式定義

Readme 工具外掛程式定義在 plugin.xml 檔的頂端。

<?xml version="1.0" encoding="big5"?>
<?eclipse version="3.0"?>
<plugin
         id="org.eclipse.ui.examples.readmetool"
   name="%Plugin.name"
   version="2.1.0"
   provider-name="%Plugin.providerName"
      class="org.eclipse.ui.examples.readmetool.ReadmePlugin">

   <runtime>
         <library name="readmetool.jar"/> 
      </runtime>
      <requires>
         <import plugin="org.eclipse.ui"/>
         <import plugin="org.eclipse.core.resources"/>
      <import plugin="org.eclipse.core.runtime.compatibility"/>
      <import plugin="org.eclipse.ui.views"/>
      <import plugin="org.eclipse.ui.ide"/>
      <import plugin="org.eclipse.jface.text"/>
      <import plugin="org.eclipse.text"/>
      <import plugin="org.eclipse.ui.workbench.texteditor"/>
      <import plugin="org.eclipse.ui.editors"/>
      </requires>
   ...

外掛程式定義包括外掛程式的名稱ID版本提供者名稱。我們在 Hello World 外掛程式中,曾見過大部分參數。 Readme 工具也定義一個特殊的外掛程式類別 ReadmePlugin

還會提供 JAR 檔的名稱。plugin.xml 檔中所指定的檔案名稱是相對於外掛程式的目錄,所以 Readme 工具的 JAR 檔應該直接位在外掛程式的目錄中。

requires 元素會通知呼台有關 Readme 工具的相依關係。工作台 UI 外掛程式列為必要的外掛程式,還有各種核心、jface 和文字外掛程式。

AbstractUIPlugin

ReadmePlugin 類別代表 Readme 工具外掛程式,會管理外掛程式的生命週期。 如我們在 Hello World 範例中所見,您不需要指定外掛程式類別。平台會自動提供。 在這個情況下,我們的外掛程式在啟動時必須初值設定 UI 相關資料。 平台類別 AbstractUIPlugin 會提供一個 ReadmePlugin 所繼承用來管理 UI 資源的結構。

AbstractUIPlugin 在外掛程式的生命期限中,利用通用的啟動和關閉方法來管理影像、對話框設定和喜好設定儲存庫。 當我們使用對話框和喜好設定時,會查看 ReadmePlugin 類別的特定事項。