定制产品

一个产品有许多可定制方面,例如闪屏、关于对话框文本和窗口图标等等。其中大多数定制是在 org.eclipse.core.runtime.products 扩展点的添加项中定义的。

我们来看一下某些较为常见的可定制元素是如何定义的。

“关于”对话框

当用户在工作台菜单中选择帮助 > 关于时显示平台的“关于”对话框。  

“关于”对话框

关于对话框的上半部分显示产品级别信息,而下半部分详细描述安装的功能部件(如果有)和插件。功能部件详细信息(如果您愿意,还将包括品牌)是使用与该功能部件相关联的插件中的 about.iniabout.propertiesabout.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 像素。