平台提供了一种机制,用于在运行时跟踪插件的活动,而不进行完全调试。它还允许您使用跟踪标志,这将导致将跟踪信息打印在标准输出(或“控制台”视图)上。这些标志是在称为“.options”的文件中定义的,其语法如下:
<plug-in Id>/debug = true/false (master switch)
<plug-in Id>/<tracing flag> = <value>
第一个条目表示跟踪插件的主开关。如果调用插件类中的方法 isDebugging, 并且如果此跟踪变量的值为 true 的话,则将返回 true。其他跟踪标志是由您来定义的, 它们的值可以通过使用
Platform.getDebugOption(optionName)"来获得;
大多数平台插件都定义了跟踪标志,特别是平台核心。对于初级插件开发者来说,最感兴趣的一组跟踪标志是那些与类装入相关的跟踪标志, 原因是它们可以允许跟踪插件装入问题。
为了支持跟踪而不需要编辑跟踪 .options 文件, PDE 提供了“运行时跟踪”首选项页面,该页面允许您设置与装入相关的跟踪标志和名称过滤器。
要特别对待运行时类装入跟踪, 原因是它是最常见的,对于大多数插件开发者都很有用。PDE 还提供了类属对话框,用来控制其他跟踪标志。“高级跟踪”首选项页面显示支持跟踪的所有插件。当选择了插件时,它的受支持跟踪选项就会显示在特性表中。可以对工作区插件和外部插件更改这些跟踪选项的值。
如果将跟踪支持添加到正在开发的插件中,则这些跟踪值将显示在此页面中。
PDE 提供了“运行时工作台”启动板的变体,称为“带有跟踪的运行时工作台”。此启动板将根据“首选项”中的跟踪设置来创建统一的 .options 文件, 并将该文件传送至运行时平台实例。所有跟踪输出都将显示在“控制台”视图中。
为了允许其他开发者控制您的插件的跟踪标志,需要让大家都知道这些选项。这通常是通过将 .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() 来检查插件代码中的跟踪特性的值。