Equinox OSGi系列之三 Equinox配置参数详解【DOC精选】.docVIP

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的配置文件.ini 文件中进行配置。在此配置文件中用户需要使用命令行参数而不是系统属性的格式。如：-console。用户在发布Equinox或RCP应用时可以设定启动程序（Eclipse Launcher）的名称和图标，如将启动程序改为：MyApp.exe，则对应的启动配置文件应命名为：MyApp.ini。 ??? 下表列举了Equinox3.3版本主要的配置参数。该列表包括系统参数，用于JVM属性配置或config.ini文件配置；命令行参数（如果有）用于.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 该Equinox系统所启动的应用程序的标识符。该参数值会覆盖duct系统属性中定义的应用程序。 eclipse.application.launchDefault ? 当系统启动时，该属性用于自动启动默认的Application应用。默认的应用通过eclipse.application或 duct系统属性设定。该属性的默认值为true。如果该属性值设为false，当系统启动时不会自动启动默认的 application，系统主线程会持续等待，直至一个application通过应用描述符服务（application descriptor service）启动。 eclipse.application.registerDescriptors ? 该属性控制所有安装的application是否注册相应的应用描述符服务。该属性的默认值为false。如果设定为false，只有默认的 application在服务注册表中具有相应的应用描述符服务；如果设定为true，所有安装的application在OSGi服务注册表中都具有相应的应用描述符服务注册。 mands ? 在启动Equinox系统时，使用该属性参数将用回车换行方式分隔的命令行参数列表传递给系统。 eclipse.consoleLog ? 如果该属性参数设定且值为true，则所有的日志输出都会传送到Java的System.out。该属性参数可以和-debug参数结合用于调试。 eclipse.debug.startupTime ? 该属性用于设定系统运行时Java虚拟机启动的时间（单位为毫秒） eclipse.ee.install.verify ? 如果该属性值设定为true，在Bundle组件安装时，OSGi框架会检查框架运行所需要的运行环境。该参数默认值为false。 eclipse.exitOnError ?