定制产品

一个产品有许多可定制方面,例如启动屏幕、关于对话框文本和窗口图标等等。其中大多数定制是在 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"/>

现在,不鼓励使用此属性,建议您使用 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 像素。

通过使用 startupProgressRectstartupMessageRectstartupForegroundColor 属性,可以配置启动期间在启动屏幕中显示的进度条和进度消息的位置、大小和颜色。有关这些属性的更多信息,请参阅 IProductConstants。请注意,缺省情况下,在启动时不会报告进度。要启用启动进度报告功能,请将以下首选项设置为 true,例如在首选项定制文件中进行此设置:IWorkbenchPreferenceConstants.SHOW_PROGRESS_ON_STARTUP