範例

org.eclipse.ui.intro.samples

3.0 版

這個延伸點應該用來登錄 Eclipse 程式碼範例。 範例是指將多個 Eclipse 專案以適合的方法套裝起來,以便匯入工作區。

每一個範例都有一個名稱、多個專案元素以及一個最終視景。 範例精靈會針對每一個 project 元素建立一個專案, 從保存檔匯入內容,以及開啟最終視景(如果指定的話)。 專案必須完整,也就是說,有正確的本質和類別路徑(如果是 Java 或外掛程式專案)。

如果您有指定目標視圖,而且其中含有資源元素,則會在建立範例之後,利用它在視圖中選取和顯示那些資源。

這個延伸點目前僅提供給內部 Eclipse SDK 使用。 它不能用在 Eclipse SDK 範例以外的地方。

<!ELEMENT extension (sample+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT sample (description , project+ , activity*)>

<!ATTLIST sample

id            CDATA #REQUIRED

name          CDATA #REQUIRED

perspectiveId CDATA #IMPLIED

launcher      CDATA #IMPLIED

targetViewId  CDATA #IMPLIED>

代表要匯入工作區之範例的元素。



<!ELEMENT project EMPTY>

<!ATTLIST project

name         CDATA #REQUIRED

archive      CDATA #REQUIRED

shared       CDATA #IMPLIED

selectReveal CDATA #IMPLIED>

每一個專案元素都會產生一個利用從相關保存檔匯入之內容所建立的工作區專案。



<!ELEMENT description EMPTY>

<!ATTLIST description

helpHref CDATA #IMPLIED>

這個元素的主體文字,應該含有範例的說明。



<!ELEMENT activity EMPTY>

<!ATTLIST activity

id CDATA #REQUIRED>

指定一個必須針對本範例啟用的活動



下面是延伸點的一個範例:

   

<extension point=

"org.eclipse.pde.ui.samples"

>

<sample id=

"com.example.xyz.sample"

name=

"My Sample"

>

<description helpHref=

"/com.example.xyz.doc/samples/com.example.xyz.sample1/doc-html/doc.html"

>

範例的簡要說明。

</description>

<project name=

"com.example.xyz.sample1"

archive=

"samples/sample1.zip"

/>

</sample>

</extension>

如果指定的話,屬性 launcher 的值必須代表實作 org.eclipse.debug.ui.ILaunchShortcut 介面之 Java 類別的完整名稱。

PDE UI 可以提供執行時期工作台啟動程式,來啟動 Eclipse 的另一個實例。