Plug-ins Tab

The Plug-ins Tab allows you to select the plug-ins (aka. bundles) and their start level, which consequently allows you to customize the osgi.bundles and osgi.bundles.defaultStartLevel system properties that the launch configuration will run with.

Equinox Plug-ins

 

Default Start Level

A start level is a positive integer that denotes the default OSGi start level at which a bundle will run. The default start level, which is assigned to all selected bundles, is initially set to 4. This master setting can be changed directly to modify the start level of bundles en masse, or it can be overridden on a per-bundle basis.

 

Default Start Status

The start status indicates to the framework whether a bundle should be marked as active after it gets installed. If set to true (the default), a bundle will always be started when the framework is launched. The Start plug-ins automatically is a master setting that is applied to all selected bundles en masse, but it can be overridden on a per-bundle basis.

 

Bundle Selection

Bundles that are to be installed by the framework upon startup must be explicitly checked on this page. By default, a bundle will be assigned the default start level and the default start status, but these values can be overridden on a per-bundle basis by selecting the bundle and editing the start level and status in-place.

There are several buttons available to help you select plug-ins including an Add Required Plug-ins button. The Add Required Plug-ins button should be used often to ensure the subset of plug-ins you have selected is complete.

Please note that if a workspace bundle has the same ID as a target bundle, the workspace bundle overrides its target counterpart. This behavior can be overridden by deselecting a workspace bundle and selecting its target counterpart.

 

Validate Plug-in Set

The Validate Plug-in Set functionality, which can be invoked via the button located at the bottom right corner of the Plug-ins tab, analyzes the selected set of plug-ins to find launching startup problems. For instance, missing dependencies, unsatisfied execution environments, incompatible platform filters are a few of the potential problems that may prevent your plug-in from running.

By checking the Validate plug-in dependencies automatically prior to launching option, PDE will run the Validate Plug-in Set function prior to every launch. If problems are found, a dialog showing the error comes up for you to examine and you have the option to continue the launch without correcting the problems or canceling the launch to rectify the issues. Otherwise, if no problems are found, the launch proceeds as normal.