外掛程式開發環境 (PDE) - 版本注意事項

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 按鍵連結無法運作

1.0 簡介

這個組件包含外掛程式開發環境已知問題和限制的資訊。

2.0 已知的問題和限制

2.1 PDE XML 編輯器之程式碼頁面中的註解

PDE 提供了許多多頁編輯器,其中包括「程式碼」頁面。 在大部分情況下,處理 XML 檔(外掛程式、片段和功能 Manifest)的編輯器都會保留註解。可是,如果註解是加在 XML 根元素之前, 或是加在母元素中包含的最後一個子元素之後,該註解就不會保留。

2.2 內容視圖中的剪貼簿作業

剪貼簿捷徑(Ctrl+X、Ctrl+C、Ctrl+V 等等)對屬於「PDE 外掛程式 Manifest 編輯器」之內容的資料格編輯器沒有作用。請使用蹦現功能表來啟動這些作業。

2.3 匯入片段時發生問題

如果工作區包含外掛程式的二進位碼專案,以及參照該外掛程式的片段,片段程式庫會加入被參照之外掛程式專案的類別路徑中。如果您嘗試以另一個建置的版本改寫外掛程式和片段, 刪除舊的片段可能會失敗。如果發生這個狀況,請重複該作業以修復工作區。只有受影響的外掛程式和片段需要重新匯入。

2.4 假設輸出位於 bin/ 資料夾中

PDE 會假設包含 Java 程式碼的所有外掛程式和片段專案,在 bin/ 資料夾內都有一或多個來源資料夾與建置輸出。 雖然您可以在「內容」對話框中變更輸出資料夾的名稱,但是如果您這樣做,PDE 執行時期工作發射台將無法正確地運作。

2.5 喜好設定對匯入/匯出沒有作用

PDE 喜好設定頁面目標平台中的喜好設定不會被保留。因此,它們不會用於「喜好設定」對話框中的「匯入/匯出」作業。

2.6 剪貼簿作業在「功能 Manifest 編輯器」中沒有作用

「功能 Manifest 編輯器」的 GUI 頁面支援包含標準剪貼簿作業的蹦現功能表(如剪下、複製和貼上)。可是, 這些作業對結構化小組件(樹狀結構和清單)都沒有作用。這些作業僅在資訊程式碼頁面內的文字小組件中有用。

2.7 「選擇計算建置路徑」導致 Java 專案不再建置

PDE 會查看 build.properties 檔中的程式碼對映表,來計算外掛程式專案的建置類別路徑。這個檔案會定義來源資料夾編譯到執行程式庫中的方式。如果這個檔案不存在,PDE 會計算未包含來源資料夾的類別路徑,而產生編譯錯誤。當新的外掛程式專案建立時,PDE 會產生所需的 build.properties 檔。如果外掛程式專案是以其他方式建立,您必須以手動方式新增 build.properties 檔。 請參閱「PDE 指南」,以取得 build.properties 檔之格式的詳細資料。

2.8 由於外掛程式目錄路徑中有版本號碼,ECLIPSE_HOME 會產生易錯的類別路徑

Eclipse 產品建置時通常會使外掛程式位於同一個目錄中,且每一個外掛程式都會位於名稱包含外掛程式 ID 和版本 ID 的目錄中(例如:"org.eclipse.ui_2.0.0")。 如果您在自行掌控時使用了外部的外掛程式,這些外掛程式的目錄名稱會出現在 PDE 產生的類別路徑中。這些類別路徑會反映外掛程式的版本變更, 且如果目標平台使用了不同的版本號碼,它們就必須重新計算。

2.9 外掛程式匯入精靈不允許匯入不同版本的外掛程式

如果兩個 ID 相同但版本不同的外掛程式僅提供執行程式庫,WebSphere Studio 會允許這兩個外掛程式並存。 可是,PDE 無法處理這些外掛程式,原因是它會在二進位碼專案匯入時利用外掛程式 ID 來建立專案名稱。

2.10 外掛程式 Manifest 語法檢查所需的 PDE 本質

如果外掛程式專案具有 PDE 外掛程式本質,則 PDE 僅能對外掛程式 Manifest 提供語法檢查和錯誤/警告標記。外掛程式專案會在由 PDE 精靈建立時,自動取得這個本質。 僅當一般 Java 專案已用來掌控外掛程式時,才會發生這個狀況。您可將它轉換成 PDE 專案,以解決這個問題。

2.11 PDE 不會保留原始的 Manifest 檔案佈置

當您使用 PDE Manifest 編輯器的「非程式碼」頁面時,PDE 會重新產生檔案,將變更轉換回 XML。雖然整體內容與註解都會保留, 但實際的檔案佈置卻不然。這可能導致在檔案比較期間會發生顯示錯誤變更的問題。如果檔案佈置很重要, 請在「程式碼」頁面中執行所有的編輯作業。另一種方法是,避免同時使用「程式碼」頁面。由於 XML 檔產生時會遵從並保留主要元素(副檔名、延伸點等等)的相對順序,因此在 PDE Manifest 編輯器之「非程式碼」頁面中所做的變更不會在檔案比較期間產生錯誤的差異。

2.12 Manifest 編輯器中的「移至行」導致「概要」視圖變成空白

當您在 PDE Manifest 編輯器的「程式碼」頁面中呼叫程式碼 > 移至行指令時, 「概要」視圖會變成灰色。由於「程式碼」頁面沒有功能概要,因此實際上並沒有遺失功能。

2.13 「新建特性」精靈不會產生 build.properties 檔

當您建立新的功能專案時,PDE 精靈不會自動產生 build.properties 檔。因此,建置特性會建立不具任何內容的功能 JAR。如果要解決這個問題,請利用「PDE 指南」中提供的指示,以手動方式建立 build.properties

2.14 「更新類別路徑」會連接錯誤安裝架構中的程式碼

Java 程式庫會根據 PDE 喜好設定中指定的程式碼位置,建立與程式碼之間的關聯性。依預設,這些位置是由設計時期 WebSphere Studio 實例的外掛程式來登錄。如果目標平台和設計實例不同, 這些外掛程式提供的程式碼將不會和程式庫同步。解決方案是取消勾選預設位置, 並定義新的程式碼位置,指向目標 WebSphere Studio 安裝架構中包含程式碼的外掛程式。

2.15 無法指定外掛程式的程式庫類型

PDE Manifest 編輯器未提供小組件,將執行程式庫類型指定為「程式碼」或「資源」。指定這個屬性的唯一方法是以手動方式將它加入「程式碼」頁面中。

2.16 透過 2 個以上外掛程式匯出的執行程式庫不在類別路徑中

如果某個外掛程式需要透過兩個以上外掛程式匯出的執行程式庫,在產生 build.xml 檔時,它不會自動加入編譯類別路徑中。範例:外掛程式 A 匯出其程式庫, 外掛程式 B 需要外掛程式 A 並重新匯出 A,外掛程式 C 需要外掛程式 B 並重新匯出 B。如果外掛程式 D 需要外掛程式 C,在產生 build.xml 檔時,雖然外掛程式 A 的程式庫可在執行時期使用,但是它們還是不會加入編譯路徑中。這個問題可以解決如下:

  1. 利用 PDE 產生 build.xml(選取 plugin.xml 檔,然後按一下建立外掛程式 JAR)。
  2. 編輯 build.properties 並加入以下這一行:
    custom = true
  3. 將遺漏的 JAR 加入 build.xml 內 javac 作業的 classpath 中。

2.17 PDE 程式碼頁面顏色的「套用」無效

PDE 在多頁面編輯器程式碼頁面中所用之顏色的變更,在按開發外掛程式 > 編輯器喜好設定頁面的「套用」按鈕之後,不會立即反映在開啟的編輯器中。 如果要解決這個問題,請關閉再重新開啟編輯器。

2.18 部分 PDE 範本的 Icons 資料夾沒有併入 bin.includes

PDE 提供了若干範本,供您建立全功能的外掛程式專案和/或延伸。 當建立專案時,即會建立 build.properties 檔,其起始內容包括列出外掛程式 Manifest 及其程式碼 JAR 的 'bin.includes' 內容。 不過,其中沒有範本所建立的其他檔案,如 icons/ 資料夾。 依照要求,當利用 Ant 建置檔來建置時,或利用「匯出可部署的外掛程式和片段」精靈來匯出時,這些額外檔案不會位在外掛程式中。 如果要解決這個問題,請在 build.properties 檔中手動加入這些檔案和目錄。

2.19 在 Manifest 編輯器欄位中,Emacs 按鍵連結無法運作

在 PDE Manifest 編輯器的非程式碼頁面各欄位中,非預設按鍵連結目前無法運作。

返回主 Readme 檔

>