Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 

Eclipse Platform Plug-in Development Environment Guide
Previous Page Home Next Page

Configuring p2 Products

By default, PDE/Build will automatically generate start levels and other configuration information for you. It does this by generating properties into the p2.inf file. If your product provides its own p2.inf file, then PDE/Build will append to a copy of that file. It is possible to suppress this behaviour by defining some properties in your p2.inf:

org.eclipse.pde.build.append Set to false to disable appending any defaults to the p2.inf file.
org.eclipse.pde.build.append.startlevels Set to false to disable appending start level information to the p2.inf file.
org.eclipse.pde.build.append.launchers Set to false to disable including launchers in the p2.inf file.

Start Levels

Start level information can be set manually on the configuration tab of the product editor. If any start level information is set in the .product file, then PDE/Build will not generate any defaults. This means that if you decide to set any custom start levels, then you must set start levels for all bundles that will require them. The default start levels generated by PDE/Build for p2 products are:

Bundle Start Level Auto-Start
org.eclipse.equinox.simpleconfigurator 1 true
org.eclipse.equinox.common 2 true
org.eclipse.update.configurator 4 (default) true
org.eclipse.core.runtime 4 (default) true
org.eclipse.equinox.ds 1 true

When setting the start level for org.eclipse.update.configurator, PDE/Build will also automatically set In addition to these properties, org.eclipse.update.reconcile=false .

Config.ini properties

The p2 product publisher used by PDE/Build will automatically set a number of config.ini properties based on settings in your .product file:

Property Based On
eclipse.product The product set on the overview tab of the product editor.
eclipse.application The application set on the overview tab of the product editor.
osgi.splashPath The plug-in set on the Splash tab of the product editor.

It is also possibly to add arbitrary config.ini properties to your .product file, however there is no tab the editor for this, so it must be done manually by editing the .product file as xml.

An example of setting properties this way would look like this:

	...
	<configurations>
	   <-- The product editor will generate start level information like this:
	   <plugin id="org.eclipse.core.runtime" autoStart="true" startLevel="4" />
	   -->                                     
	   <property name="osgi.bundles.defaultStartLevel" value="4" />   
	   <property name="osgi.requiredJavaVersion" value="1.5.0"/>    
	</configurations>
	...

Launchers

PDE/Build will automatically brand launchers (which it gets from the org.eclipse.equinox.executable feature in the delta pack). These launchers will be automatically included in the product along with generated metadata that will set the appropriate -startup and --launcher.library arguments in the product ini file.

Because of changes to the structure of feature metadata with respect to root files, the org.eclipse.equinox.executable feature should not be included directly in your product.


 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire