トレース付きで実行

プラットフォームは、完全なデバッグを行うことなく実行時のプラグインの活動を追跡するためのメカニズムを提供しています。 これにより、トレース・フラグを使用して、 トレース情報を標準出力 (または「コンソール」ビュー) に印刷することができます。 これらのフラグは、「.options」という名前のファイルに定義されています。その構文は以下のとおりです。

   <plug-in Id>/debug = true/false  (マスター・スイッチ)
   <plug-in Id>/<tracing flag> = <value>

最初の項目は、プラグインをトレースするためのマスター・スイッチを表します。 プラグイン・クラスの isDebugging メソッドを呼び出すと、このメソッドは、 このトレース変数の値が true の場合には true を戻します。 その他のトレース・フラグは独自に定義し、その値は、以下を使用して取得することができます。

      Platform.getDebugOption(optionName);

プラットフォームのプラグインの大部分は、トレース・フラグ、特にプラットフォーム・コアを定義しています。 プラグインの開発がはじめての開発者にとって最も興味を引き付けられるトレース・フラグのセットは、 クラス・ロードに関連するトレース・フラグ・セットです。 このセットを使用すると、プラグインのロード問題をトレースすることができるからです。 

トレース .options ファイルを編集せずにトレースをサポートするために、 PDE は、起動ダイアログに「ランタイム・トレース」タブを用意しています。 すべてのトレース設定は起動構成に保管されます。 これは、いくつかの構成を別のトレース・オプションで作成し、それらの間で代替可能であることを意味します。

ランタイム・ワークベンチ・ランチャー - トレース

開発中のプラグインにトレース・サポートを追加すると、 そのプラグインは (ワークスペース・プラグイン・グループ内の) トレースをサポートするプラグインのリストに現れ、 そのトレース・プロパティーがプロパティー・シートに現れます。

例:  プラグインへのトレース・サポートの追加

プラグインのトレース・フラグを他の開発者がコントロールできるようにするには、これらのオプションを公開する必要があります。  これを行うには、通常、そのプラグインに .options ファイルを挿入します。  このファイルには、サポートされているすべてのフラグとそのデフォルト値がリストされています。 PDE は即時にこのファイルを検出し、 それを「拡張トレース」の設定ページの「ワークスペースのプラグイン」リストに組み込みます。

次に、いくつかのトレース・フラグを持つ、テンプレートの .options ファイルを、この新規のプラグインに定義します。

先に作成した com.example.xyz プロジェクトを選択し、新規ファイル .options を作成します。 デフォルトのテキスト・エディターが開いた後、以下の項目を追加します。

   com.example.xyz/debug = true    com.example.xyz/debug/flag = true    com.example.xyz/debug/filter = *

このファイルを保管するとき、起動ダイアログを開くために「実行 -> 実行 ...」を選択します。 「ワークスペースのプラグイン」の下に、このプラグインが表示されています。 それを選択すると、新規に定義されたフラグとそのデフォルト値が表示されます。

ランタイム・ワークベンチ・ランチャー - トレースの例

.options ファイルを作成しても、それによって定義されるのは可用性フラグだけですが、 これにより、他のプラグイン開発者は、トレース・プロパティーの値を定義することができます。  ただし、独自に作成したプラグインのコード内のトレース・プロパティーの値は、 Platform.getDebugOption() を使用して検査する必要があります。

 
Copyright IBM Corporation and others 2000, 2003