1.0 簡介
2.0 已知的問題和限制
2.1 PDE XML 編輯器之程式碼頁面中的註解
2.2 內容視圖中的剪貼簿作業
2.3 匯入片段時發生問題
2.4 假設輸出位於 bin/ 資料夾中
2.5 喜好設定對匯入/匯出沒有作用
2.6
剪貼簿作業在「功能 Manifest 編輯器」中沒有作用
2.7
「選擇計算建置路徑」導致 JavaTM 專案不再建置
2.8
由於外掛程式目錄路徑中有版本號碼,ECLIPSE_HOME 會產生易錯的類別路徑
2.9
外掛程式匯入精靈不允許匯入不同版本的外掛程式
2.10 外掛程式 Manifest 語法檢查所需的 PDE 本質
2.11 PDE 不會保留原始的 Manifest 檔案佈置
2.12
Manifest 編輯器中的「移至行」導致「概要」視圖變成空白
2.13
「新建特性」精靈不會產生 build.properties 檔
2.14「更新類別路徑」會連接錯誤安裝架構中的程式碼
2.15 無法指定外掛程式的程式庫類型
2.16
透過 2 個以上外掛程式匯出的執行程式庫不在類別路徑中
2.17 PDE 程式碼頁面顏色的「套用」無效
2.18 部分 PDE 範本的 Icons 資料夾沒有併入 bin.includes
2.19 在 Manifest 編輯器欄位中,Emacs 按鍵連結無法運作
這個組件包含外掛程式開發環境已知問題和限制的資訊。
PDE 提供了許多多頁編輯器,其中包括「程式碼」頁面。 在大部分情況下,處理 XML 檔(外掛程式、片段和功能 Manifest)的編輯器都會保留註解。可是,如果註解是加在 XML 根元素之前, 或是加在母元素中包含的最後一個子元素之後,該註解就不會保留。
剪貼簿捷徑(Ctrl+X、Ctrl+C、Ctrl+V 等等)對屬於「PDE 外掛程式 Manifest 編輯器」之內容的資料格編輯器沒有作用。請使用蹦現功能表來啟動這些作業。
如果工作區包含外掛程式的二進位碼專案,以及參照該外掛程式的片段,片段程式庫會加入被參照之外掛程式專案的類別路徑中。如果您嘗試以另一個建置的版本改寫外掛程式和片段, 刪除舊的片段可能會失敗。如果發生這個狀況,請重複該作業以修復工作區。只有受影響的外掛程式和片段需要重新匯入。
PDE 會假設包含 Java 程式碼的所有外掛程式和片段專案,在 bin/ 資料夾內都有一或多個來源資料夾與建置輸出。 雖然您可以在「內容」對話框中變更輸出資料夾的名稱,但是如果您這樣做,PDE 執行時期工作發射台將無法正確地運作。
PDE 喜好設定頁面目標平台中的喜好設定不會被保留。因此,它們不會用於「喜好設定」對話框中的「匯入/匯出」作業。
「功能 Manifest 編輯器」的 GUI 頁面支援包含標準剪貼簿作業的蹦現功能表(如剪下、複製和貼上)。可是, 這些作業對結構化小組件(樹狀結構和清單)都沒有作用。這些作業僅在資訊和程式碼頁面內的文字小組件中有用。
PDE 會查看 build.properties
檔中的程式碼對映表,來計算外掛程式專案的建置類別路徑。這個檔案會定義來源資料夾編譯到執行程式庫中的方式。如果這個檔案不存在,PDE 會計算未包含來源資料夾的類別路徑,而產生編譯錯誤。當新的外掛程式專案建立時,PDE 會產生所需的 build.properties
檔。如果外掛程式專案是以其他方式建立,您必須以手動方式新增 build.properties
檔。
請參閱「PDE 指南」,以取得 build.properties
檔之格式的詳細資料。
Eclipse 產品建置時通常會使外掛程式位於同一個目錄中,且每一個外掛程式都會位於名稱包含外掛程式 ID 和版本 ID 的目錄中(例如:"org.eclipse.ui_2.0.0
")。
如果您在自行掌控時使用了外部的外掛程式,這些外掛程式的目錄名稱會出現在 PDE 產生的類別路徑中。這些類別路徑會反映外掛程式的版本變更,
且如果目標平台使用了不同的版本號碼,它們就必須重新計算。
如果兩個 ID 相同但版本不同的外掛程式僅提供執行程式庫,WebSphere Studio 會允許這兩個外掛程式並存。 可是,PDE 無法處理這些外掛程式,原因是它會在二進位碼專案匯入時利用外掛程式 ID 來建立專案名稱。
如果外掛程式專案具有 PDE 外掛程式本質,則 PDE 僅能對外掛程式 Manifest 提供語法檢查和錯誤/警告標記。外掛程式專案會在由 PDE 精靈建立時,自動取得這個本質。 僅當一般 Java 專案已用來掌控外掛程式時,才會發生這個狀況。您可將它轉換成 PDE 專案,以解決這個問題。
當您使用 PDE Manifest 編輯器的「非程式碼」頁面時,PDE 會重新產生檔案,將變更轉換回 XML。雖然整體內容與註解都會保留, 但實際的檔案佈置卻不然。這可能導致在檔案比較期間會發生顯示錯誤變更的問題。如果檔案佈置很重要, 請在「程式碼」頁面中執行所有的編輯作業。另一種方法是,避免同時使用「程式碼」頁面。由於 XML 檔產生時會遵從並保留主要元素(副檔名、延伸點等等)的相對順序,因此在 PDE Manifest 編輯器之「非程式碼」頁面中所做的變更不會在檔案比較期間產生錯誤的差異。
當您在 PDE Manifest 編輯器的「程式碼」頁面中呼叫程式碼 > 移至行指令時, 「概要」視圖會變成灰色。由於「程式碼」頁面沒有功能概要,因此實際上並沒有遺失功能。
當您建立新的功能專案時,PDE 精靈不會自動產生 build.properties
檔。因此,建置特性會建立不具任何內容的功能 JAR。如果要解決這個問題,請利用「PDE 指南」中提供的指示,以手動方式建立 build.properties
。
Java 程式庫會根據 PDE 喜好設定中指定的程式碼位置,建立與程式碼之間的關聯性。依預設,這些位置是由設計時期 WebSphere Studio 實例的外掛程式來登錄。如果目標平台和設計實例不同, 這些外掛程式提供的程式碼將不會和程式庫同步。解決方案是取消勾選預設位置, 並定義新的程式碼位置,指向目標 WebSphere Studio 安裝架構中包含程式碼的外掛程式。
PDE Manifest 編輯器未提供小組件,將執行程式庫類型指定為「程式碼」或「資源」。指定這個屬性的唯一方法是以手動方式將它加入「程式碼」頁面中。
如果某個外掛程式需要透過兩個以上外掛程式匯出的執行程式庫,在產生 build.xml
檔時,它不會自動加入編譯類別路徑中。範例:外掛程式 A 匯出其程式庫,
外掛程式 B 需要外掛程式 A 並重新匯出 A,外掛程式 C 需要外掛程式 B 並重新匯出 B。如果外掛程式 D 需要外掛程式 C,在產生 build.xml
檔時,雖然外掛程式 A 的程式庫可在執行時期使用,但是它們還是不會加入編譯路徑中。這個問題可以解決如下:
- 利用 PDE 產生
build.xml
(選取plugin.xml
檔,然後按一下建立外掛程式 JAR)。- 編輯
build.properties
並加入以下這一行:
custom = true- 將遺漏的 JAR 加入
build.xml
內 javac 作業的 classpath 中。
PDE 在多頁面編輯器程式碼頁面中所用之顏色的變更,在按開發外掛程式 > 編輯器喜好設定頁面的「套用」按鈕之後,不會立即反映在開啟的編輯器中。 如果要解決這個問題,請關閉再重新開啟編輯器。
PDE 提供了若干範本,供您建立全功能的外掛程式專案和/或延伸。
當建立專案時,即會建立 build.properties
檔,其起始內容包括列出外掛程式 Manifest 及其程式碼 JAR 的 'bin.includes' 內容。
不過,其中沒有範本所建立的其他檔案,如 icons/
資料夾。
依照要求,當利用 Ant 建置檔來建置時,或利用「匯出可部署的外掛程式和片段」精靈來匯出時,這些額外檔案不會位在外掛程式中。
如果要解決這個問題,請在 build.properties 檔中手動加入這些檔案和目錄。
在 PDE Manifest 編輯器的非程式碼頁面各欄位中,非預設按鍵連結目前無法運作。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.