与主功能部件关联的插件用于指定产品品牌信息。产品有许多可定制的方面。产品级别的定制使用 about.ini 文件和该处描述的其它文件定义。产品还可以控制其它插件的缺省首选值。这是使用 plugin_customization.ini 文件来完成的。
再次参考我们样本产品的主功能部件插件,让我们进一步看看如何定制产品。
com.example.acme.acmefeature_1.0.0/ plugin.xml about.ini about.html about.mappings about.properties acme.gif plugin_customization.ini plugin_customization.properties splash.bmp welcome.xml
当用户在工作台菜单中选择帮助 > 关于时显示平台的“关于”对话框。
“关于”对话框是使用功能部件和插件提供的信息来构造的。所有功能部件和插件都应添加提供有关该特定插件信息的 about.html 文件。当用户请求功能部件详细信息或插件详细信息并选择特定的功能部件或插件时显示此信息。
主功能部件还提供总的产品信息和图形。使用附加文件指定该信息。
可使用 16x16 像素彩色图像来标记产品创建的品牌窗口。它将显示在产品窗口的左上角。它在 about.ini 文件的 windowImage 属性中指定。路径应指定为插件相对路径。上面显示的目录结构的正确项将为如下所示:
windowImage=acme.gif
产品欢迎页面的描述应在 xml 文件中定义,其格式在平台欢迎页面配置中描述。它在 about.ini 文件的 welcomePage 属性中指定。路径应指定为插件相对路径。上面显示的目录结构的正确项将为如下所示:
welcomePage=welcome.xml
您还可以指定文件的本地语言查询。(有关详细信息,参见语言环境特定文件。)
welcomePage=$nl$/welcome.xml
产品的弹出屏幕在位于主功能部件插件目录中的 splash.bmp 文件中提供。图像应以 24 位彩色 BMP 格式(RGB 格式)提供,并且大小应为大约 500x330 像素。若要为不同语言环境定制弹出屏幕,则可将它们放置在主功能部件插件的片断中。
plugin_customization.ini 文件用于设置其它插件定义的首选项的缺省首选值。此文件是 java.io.Properties 格式文件。通常使用此文件来设置作为插件公共 API 一部分发布的首选项值。也就是说,若您引用插件使用的首选项,但它们未在 API 中正式定义,则要冒风险。
一个通常的定制是设置工作台的缺省透视图。此首选项在 org.eclipse.ui 插件中定义。以下示例假设在启动产品时应使用资源透视图作为缺省透视图。
org.eclipse.ui/defaultPerspectiveId=org.eclipse.ui.resourcePerspective
若您发现需要更改其它某个插件首选项的缺省值,则查阅该插件的 API 文档,以查看该首选项是否被当作公共首选项。
plugin_customization.properties 文件包含 plugin_customization.ini 文件的转换字符串。