运行时进行跟踪

平台提供了一种机制,用于在运行时跟踪插件的活动,而不进行完全调试。它还允许您使用跟踪标志,这将导致将跟踪信息打印在标准输出(或“控制台”视图)上。这些标志是在称为“.options”的文件中定义的,其语法如下:

   <plug-in Id>/debug = true/false  (master switch)
   <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