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

《Equinox OSGi系列之三 Equinox配置参数详解》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、1、概述    上文我们对EquinoxOSGi运行环境的组成及搭建过程做了详细讲述。本文主要对EquinoxOSGi运行环境的可配置参数及其作用加以介绍，从而使用户在实际使用过程中可以对Equinox运行环境更好地进行控制。       Equinox项目沿袭Eclipse的特点，具有高度的可配置性。用户可以通过命令行参数或系统属性参数（JVM属性参数）两种方式对EquinoxOSGi运行环境进行设定。命令行参数可以看作是系统属性参数的简化方式，Equinox中提供的很多系统属性参数可能不具有对应的命令行快捷

2、设定。2、Equinox配置参数详解Equinox配置的参数在实际使用中可以通过以下三种方式：·在命令行中，使用Java虚拟机参数-D作为系统属性来设定，如：-Declipse.ignoreApp=true；·在配置文件config.ini文件中进行配置，如：osgi.framework=plugins/org.eclipse.osgi_<版本号>.jar·在EclipseLauncher的配置文件.ini文件中进行配置。在此配置文件中用户需要使用命令行参数而不是系统属性的格式。如：-console。用户在发布

3、Equinox或RCP应用时可以设定启动程序（EclipseLauncher）的名称和图标，如将启动程序改为：MyApp.exe，则对应的启动配置文件应命名为：MyApp.ini。   下表列举了Equinox3.3版本主要的配置参数。该列表包括系统参数，用于JVM属性配置或config.ini文件配置；命令行参数（如果有）用于.ini文件配置；参数的简要说明描述该参数的用途。说明：·表中所列参数来自于Eclipse3.3帮助文档，关于参数的解释可能不够准确，请用户参考Eclipse帮助获取详细信息。·表中所列

4、参数严格说来仅部分用于EquinoxOSGi，全部适用于Eclipse。在下述说明中将不区分Equinox和Eclipse。系统参数命令行参数参数说明eclipse.activateRuntimePlugins 用于控制运行时（Runtime）插件的激活。如果RCP应用程序不需要使用运行时插件提供的服务，可以将该属性值设定为false，从而避免在系统启动时激活运行时插件。eclipse.allowAppRelaunch 如果值为true，当当前运行的应用程序Application退出时，Equinox系统主线程

5、会一直等待该应用的另一个应用被启动。如果停止system.bundle即BundleID值为0的Bundle，则会强制Equinox主线程停止等待另一个应用启动。该参数的默认值为false。eclipse.application-application该Equinox系统所启动的应用程序的标识符。该参数值会覆盖eclipse.product系统属性中定义的应用程序。eclipse.application.launchDefault 当系统启动时，该属性用于自动启动默认的Application应用。默认的应用通过

6、eclipse.application或eclipse.product系统属性设定。该属性的默认值为"true"。如果该属性值设为false，当系统启动时不会自动启动默认的application，系统主线程会持续等待，直至一个application通过应用描述符服务（applicationdescriptorservice）启动。eclipse.application.registerDescriptors 该属性控制所有安装的application是否注册相应的应用描述符服务。该属性的默认值为false。如果

7、设定为false，只有默认的application在服务注册表中具有相应的应用描述符服务；如果设定为true，所有安装的application在OSGi服务注册表中都具有相应的应用描述符服务注册。eclipse.commands 在启动Equinox系统时，使用该属性参数将用回车换行方式分隔的命令行参数列表传递给系统。eclipse.consoleLog 如果该属性参数设定且值为true，则所有的日志输出都会传送到Java的System.out。该属性参数可以和-debug参数结合用于调试。eclipse.de

8、bug.startupTime 该属性用于设定系统运行时Java虚拟机启动的时间（单位为毫秒）eclipse.ee.install.verify 如果该属性值设定为true，在Bundle组件安装时，OSGi框架会检查框架运行所需要的运行环境。该参数默认值为false。eclipse.exitOnError 该参数设定为true时，如果系统在运行时遇到无法处理的错误，则系统会退出。该参