1.0 概要
2.0 既知の問題および制限
2.1 PDE XML エディターのソース・ページのコメント
2.2 プロパティー・ビューのクリップボード操作
2.3 フラグメントをインポート中の問題
2.4 出力は bin/ フォルダーという前提事項
2.5 インポート/エクスポートで設定が機能しない
2.6
フィーチャー・マニフェスト・エディターでクリップボード操作が作動しない
2.7
Compute Build パスを選ぶと、JavaTM プロジェクトがビルドされなくなる
2.8
プラグイン・ディレクトリー・パスのバージョン番号が原因で、ECLIPSE_HOME によって壊れやすいクラスパスが作成される
2.9
プラグイン・インポート・ウィザードが別のバージョンのプラグインのインポートを許可しない
2.10 プラグインのマニフェスト構文検査に必要な PDE の性質
2.11 PDE が元のマニフェスト・ファイル・レイアウトを保持しない
2.12
マニフェスト・エディターで「行へ移動」を実行するとアウトライン・ビューがブランクになる
2.13
新規フィーチャー・ウィザードが build.properties ファイルを生成しない
2.14
クラスパスを更新すると、誤ったインストールからのソースが付加される
2.15 プラグイン・ライブラリー・タイプを指定する方法がない
2.16
3 つ以上のプラグインを使用してエクスポートされたランタイム・ライブラリーは、クラスパスに入らない
2.17 PDE ソース・ページの色が「適用」を実行しても有効にならない
2.18 いくつかの PDE テンプレートの bin.includes にアイコン・フォルダーが含まれない
2.19 Emacs のキー・バインディングが、マニフェスト・エディター・フィールドで機能しない
ここでは、プラグイン開発環境に関する既知の問題および制限についての情報が記載されています。
PDE は、ロー・ソース・ページを含む多くの複数ページ・エディターを提供します。 XML ファイル (プラグイン、フラグメント、 およびフィーチャー・マニフェスト) を処理するエディターは、多くの場合コメントを保持します。 しかし、ルート XML エレメント以前に追加されたり、親エレメントに含まれている最後の子エレメントの後に追加された場合、コメントが保持されることはありません。
クリップボード・ショートカット (Ctrl+X、Ctrl+C、Ctrl+V など) は PDE プラグイン・マニフェスト・エディターに属するプロパティーのセル・エディター内では作動しません。これらの操作を活動化するにはポップアップ・メニューを使用してください。
ワークスペースにプラグイン用のバイナリー・プロジェクト、およびそのプラグインを参照するフラグメントが含まれる場合、 フラグメント・ライブラリーが参照プラグイン・プロジェクトのクラスパスに追加されます。 プラグインとフラグメントを別のビルドのバージョンで上書きしようとすると、古いフラグメントの削除が失敗する場合があります。この問題が発生したら、ワークスペースの修復操作を繰り返してください。影響のあったプラグインとフラグメントのみを再度インポートする必要があります。
PDE は、Java コードを含むすべてのプラグインとフラグメント・プロジェクトが1 つ以上のソース・フォルダーを持っており、bin/ フォルダーに出力を作成すると想定しています。プロパティー・ダイアログ内の出力フォルダー名を変えることはできますが、 そうすると PDE ランタイム・ワークベンチ・ランチャーは正しく作動しません。
ターゲット・プラットフォームの PDE 設定ページで設定された設定は、保存されません。 結果として、これらの設定は設定ダイアログでのインポート/エクスポート操作の影響を受けません。
フィーチャー・マニフェスト・エディターの GUI ページは、標準クリップボード操作 (切り取り、コピー、貼り付けなど) を含むポップアップ・メニューをサポートします。 しかし、これらの操作は構造化ウィジェット (ツリーとリスト) で機能しません。 この操作が機能する場所は、「情報」と「ソース」の各ページのテキスト・ウィジェット内のみです。
PDE は、build.properties
ファイルのソース・マッピングを検索して、プラグイン・プロジェクトのビルド・クラスパスを計算します。 このファイルは、ソース・フォルダーをランタイム・ライブラリーにコンパイルする方法を定義します。このファイルがない場合、PDE はソース・フォルダーがないクラスパスを計算し、結果としてコンパイル・エラーになります。
新規のプラグイン・プロジェクトが生成される際、PDE は必要な build.properties
ファイルを生成します。 別の方法でプラグイン・プロジェクトが生成される場合は、build.properties
ファイルを手動で追加する必要があります。
build.properties
ファイルのフォーマットについての詳細は、PDE ガイドを参照してください。
Eclipse 製品は、通常プラグインが同じディレクトリーに作成され、各プラグインがプラグイン ID とバージョン ID
が両方とも含まれている名前のディレクトリー (例: "org.eclipse.ui_2.0.0
") に置かれるようにビルドされます。
自己ホスティング中に外部プラグインが使用されると、これらのプラグインのディレクトリー名が PDE で生成されたクラスパスで表示されます。
これらのクラスパスはプラグインのバージョン変更を認識するため、ターゲット・プラットフォームが異なったバージョン番号を使う場合には再計算されなければなりません。
WebSphere Studio では 2 つのプラグインが同一の ID であること可能ですが、異なったバージョンが共存するのは両者を 使用するのがランタイム・ライブラリーのみの場合です。 しかし、PDE はバイナリー・プロジェクトをインポートするときにプラグイン ID を使用してプロジェクト名を生成するため、これらのプラグインは処理できません。
PDE は、プラグイン・プロジェクトが PDE プラグインの性質を持つ場合、プラグイン・マニフェストに構文検査とエラー/警告マーカーのみを提供できます。プラグイン・プロジェクトは PDE ウィザードによって生成された場合、自動的にこの性質を持ちます。 この状況は、通常の Java プロジェクトがプラグインをホストするために使われる場合のみに起こります。 この問題は、PDE プロジェクトに変換することで解決されます。
PDE マニフェスト・エディターの「ソース (Source)」以外のページが使用された場合、 PDE はファイルを再生成して、変更を XML に変換します。全体の内容とコメントは保持されますが、実際のファイル・レイアウトは変わります。 これはファイルの比較のときに間違った変更を示す原因になる可能性があります。 ファイル・レイアウトが重要な場合、すべての編集はソース・ページで行なってください。 あるいは、完全に「ソース (Source)」ページを使用しないようにしてください。XML ファイルは、主だったエレメント (拡張、拡張ポイントなど) の相対順序を重要視して保持するように生成されるため、PDE マニフェスト・エディターの非ソース・ページで加えられた変更は、ファイルの比較のときに誤った差異になりません。
PDE マニフェスト・エディターのソース・ページにある「ソース」>「行へ移動」コマンドが呼び出されると、アウトライン・ビューは灰色表示になります。 ソース・ページには機能アウトラインがないため、事実上機能の損失はありません。
新規のフィーチャー・プロジェクトを作成する際、PDE ウィザードは自動的には build.properties
ファイルを生成しません。 結果として、フィーチャーの作成ではコンテンツのないフィーチャー JAR が作成されます。この問題を回避するには、PDE ガイドに示されている指示にしたがって手動で build.properties
を作成してください。
Java ライブラリーは、PDE 設定で指定されているソース・コード・ロケーションに応じたソース・コードに関連付けられています。 デフォルトでは、これらのロケーションは設計時 WebSphere Studio インスタンスのプラグインによって登録されています。 ターゲット・プラットフォームが設計インスタンスと同一でないと、これらのプラグインで提供されるソース・コードはライブラリーと同期しません。 回避策は、デフォルト・ロケーションのチェックマークを外し、ターゲット WebSphere Studio システム内のソース保持プラグインをポイントする新規のソース・コード・ロケーションを定義します。
PDE マニフェスト・エディターは、ランタイム・ライブラリー・タイプを「code」または「resource」として指定するウィジェットを提供しません。 この属性を指定する唯一の方法は、これをソース・ページに手作業で追加することです。
プラグインが 3 つ以上のプラグインによってエクスポートされたランタイム・ライブラリーを必要とする場合、build.xml
ファイルを生成するときに自動的にコンパイル・クラスパスに追加されることはありません。例: プラグイン A はそのライブラリーをエクスポートし、プラグイン B はプラグイン A を要求し、A を再エクスポートし、プラグイン C はプラグイン B を要求し、B を再エクスポートします。build.xml
ファイルを生成するときに、もしプラグイン D がプラグイン C を要求した場合、プラグイン A ライブラリーは、ランタイム時に使用可能であってもコンパイル・パスに追加されることはありません。 この問題は以下のように回避できます。
- PDE (
plugin.xml
ファイルを選択し、「プラグイン JAR の作成」をクリックする) を使用してbuild.xml
を生成する。build.properties
を編集して以下の行を追加する。
custom = true- 欠落している JAR を
build.xml
内にある Javac タスクのクラスパスに追加する。
PDE がそのマルチページ・エディターのソース・ページに使用する色に変更を加えて、「プラグイン開発」>「エディターの設定」ページで「適用」ボタンを押しても、開いているエディターにはその変更が即時に反映されません。 この問題を回避するには、エディターをクローズしてから、再オープンします。
PDE には、完全動作するプラグイン・プロジェクトや拡張機能の作成に使用できる、多くのテンプレートが用意されています。
プロジェクトの作成時に build.properties
ファイルとその初期内容が作成されます。このファイルには、プラグインのマニフェストおよびそのコード JAR をリストしたプロパティー「bin.includes」が含まれています。ただし、テンプレートによって作成された他のファイル (icons/
フォルダーなど) についての言及は省かれています。
そのため、Ant ビルド・ファイルを使用してビルドしても、あるいは
「デプロイ可能なプラグインとフラグメントのエクスポート」ウィザードを使用してエクスポートしても、
それらのファイルはプラグインには含まれません。
この問題を回避するには、言及が省かれているファイルとディレクトリーを手動で build.properties に追加してください。
現在のところ、PDE マニフェスト・エディターのソース以外のページのフィールドでは、デフォルト以外のキー・バインディングは機能しません。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.