一个产品有许多可定制方面,例如闪屏、关于对话框文本和窗口图标等等。其中大多数定制是在 org.eclipse.core.runtime.products 扩展点的添加项中定义的。
我们来看一下某些较为常见的可定制元素是如何定义的。
当用户在工作台菜单中选择帮助 > 关于时显示平台的“关于”对话框。
关于对话框的上半部分显示产品级别信息,而下半部分详细描述安装的功能部件(如果有)和插件。功能部件详细信息(如果您愿意,还将包括品牌)是使用与该功能部件相关联的插件中的 about.ini、about.properties 和 about.html 文件提供的。此信息将在用户请求功能部件详细信息并选择特定功能部件后显示。
产品品牌(在对话框的上半部分)是由描述显示在此对话框中的文本和图像的扩展属性指定的。例如,以下内容抽取自 Eclipse 平台产品声明。
<property name="aboutText" value="%aboutText"/> <property name="aboutImage" value="icons/eclipse_lg.png"/> </product>
有关这些属性的更多信息,请参阅 IProductConstants。
可将 16x16 像素彩色图像用于由产品创建的品牌窗口。它将出现在产品窗口的左上角。它是在产品扩展定义的 windowImage 属性中指定的。或者,可使用 windowImages 属性来描述应在左上角使用的一组不同大小的图像。
<property name="windowImages" value="icons/eclipse.png,icons/eclipse32.png"/>
如果同时指定了 windowImages 属性和 windowImage 属性,则前者优于后者。
使用 Eclipse 2.1 欢迎页面机制的产品可在 welcomePage 属性中指定其欢迎页面文件的名称和位置。
<property name="welcomePage" value="$nl$/welcome.xml"/>
不鼓励在 Eclipse 3.0 中使用此属性有利于 org.eclipse.ui.intro 扩展点。有关新的欢迎/简介机制的更多详细信息,请参阅简介支持。
preferenceCustomization 属性可用来指定包含该产品的缺省首选项值的文件。
<property name="preferenceCustomization" value="plugin_customization.ini"/>
此文件是 java.io.Properties 格式文件。 通常使用此文件来设置作为插件公共 API 一部分发布的首选项值。也就是说,若您引用插件使用的首选项,但它们未在 API 中正式定义,则要冒风险。
产品闪屏是在 config.ini 中指定的,该文件位于产品的 configuration 目录中。此文件中的 osgi.splashPath
属性描述用来搜索称为 splash.bmp 的文件的位置。osgi.splashLocation
属性标识指向要使用的闪屏文件的完整而确切的路径。
指定闪屏路径允许使用特定于语言环境的闪屏,因为给定的搜索路径可能会指示要搜索几个插件或段以及 $nl$
样式路径。有关可在此文件中配置的属性的完整描述,请参阅平台 SDK
的 config.ini 文件。应以 24 位彩色 BMP 格式(RGB 格式)提供该图像,而且其大小应该大约为 500x330 像素。