Equinox OSGi系列之三 Equinox配置参数详解

               

1、概述

上文我们对Equinox OSGi运行环境的组成及搭建过程做了详细讲述。本文主要对Equinox OSGi运行环境的可配置参数及其作用加以介绍，从而使用户在实际使用过程中可以对Equinox运行环境更好地进行控制。

Equinox项目沿袭Eclipse的特点，具有高度的可配置性。用户可以通过命令行参数或系统属性参数（JVM属性参数）两种方式对Equinox OSGi运行环境进行设定。命令行参数可以看作是系统属性参数的简化方式，Equinox中提供的很多系统属性参数可能不具有对应的命令行快捷设定。

2、Equinox配置参数详解

Equinox配置的参数在实际使用中可以通过以下三种方式：

• 在命令行中，使用Java虚拟机参数-D作为系统属性来设定，如：-Declipse.ignoreApp=true；
•    
• 在配置文件config.ini文件中进行配置，如：osgi.framework=plugins/org.eclipse.osgi_<版本号>.jar
•    
• 在Eclipse Launcher的配置文件<launcher>.ini文件中进行配置。在此配置文件中用户需要使用命令行参数而不是系统属性的格式。如：-console。用户在发布Equinox或RCP应用时可以设定启动程序（Eclipse Launcher）的名称和图标，如将启动程序改为：MyApp.exe，则对应的启动配置文件应命名为：MyApp.ini。

下表列举了Equinox3.3版本主要的配置参数。该列表包括系统参数，用于JVM属性配置或config.ini文件配置；命令行参数（如果有）用于<launcher>.ini文件配置；参数的简要说明描述该参数的用途。

说明：

• 表中所列参数来自于Eclipse3.3帮助文档，关于参数的解释可能不够准确，请用户参考Eclipse帮助获取详细信息。
•    
• 表中所列参数严格说来仅部分用于Equinox OSGi，全部适用于Eclipse。在下述说明中将不区分Equinox和Eclipse。

                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               

系统参数	命令行参数	参数说明
eclipse.activateRuntimePlugins		用于控制运行时（Runtime）插件的激活。如果RCP应用程序不需要使用运行时插件提供的服务，可以将该属性值设定为false，从而避免在系统启动时激活运行时插件。
eclipse.allowAppRelaunch		如果值为true，当当前运行的应用程序Application退出时，Equinox系统主线程会一直等待该应用的另一个应用被启动。如果停止system.bundle即Bundle ID值为0的Bundle，则会强制Equinox主线程停止等待另一个应用启动。该参数的默认值为false。
eclipse.application	-application <id>	该Equinox系统所启动的应用程序的标识符。该参数值会覆盖eclipse.product系统属性中定义的应用程序。
eclipse.application.launchDefault		当系统启动时，该属性用于自动启动默认的Application应用。默认的应用通过eclipse.application或eclipse.product系统属性设定。该属性的默认值为"true"。如果该属性值设为false，当系统启动时不会自动启动默认的application，系统主线程会持续等待，直至一个application通过应用描述符服务（application descriptor service）启动。
eclipse.application.registerDescriptors