View source

From Eclipsepedia

for Equinox/p2/Reusing Platform Metadata
You do not have permission to do that, for the following reason:
The action you have requested is limited to users in the group user.
You can view and copy the source of this page:
{{CommentBox|Under update for 3.5}} 

This page outlines the current shape of the metadata for the "org.eclipse.platform.ide" product.  This product is a subset of the Eclipse SDK.  The SDK adds JDT, PDE, CVS and Help, but everything that requires special configuration exists in the base platform.  This makes the platform ideal for general reuse.

The current RC1 metadata for org.eclipse.platform.ide looks something like this:

{|border="1" cellspacing="0"
!width=370|IU Name
!width=600|Provided Contents/Actions 
|-
|org.eclipse.platform.ide
|addRepository : add default repositories<br>mdkir : create the dropins folder
|-
!colspan="2"|
{|border="1" cellspacing="0" align="right" style="width:98%"
|width=348|org.eclipse.platform.feature.group
| The features and bundles that make up the platform
|-
| org.eclipse.p2.user.ui.feature.group
| The features and bundles that make up p2
|-
| org.eclipse.rcp.configuration.feature.group
| Eclipse branded launchers with appropriate requirements on the launcher fragments as well as CUs for setting <tt>-startup</tt> and <tt>--launcher.library</tt>.
|-
| toolingorg.eclipse.configuration
| Set <b><tt>osgi.instance.area.default=@user.home/workspace</tt></b> (os != macosx)
|-
| toolingorg.eclipse.configuration.macosx
| Set <b><tt>osgi.instance.area.default=@user.home/Documents/workspace</tt></b> (os == macosx)
|-
| toolingorg.eclipse.platform.ide.configuration
|-
!colspan="2"|
{|border="1" cellspacing="0" align="right" style="width:98%"
|width=326|toolingorg.eclipse.platform.ide.config.[ws.os.arch]
| Properties for config.ini<br>
osgi.bundles.defaultStartLevel<br>
osgi.splashPath<br>
eclipse.application<br>
eclipse.product<br>
eclipse.buildId
|-
|toolingorg.eclipse.platform.ide.ini.[ws.os.arch]
| Entries for the launcher .ini file<br>
program: -showplash org.eclipse.platform --launcher.XXMaxPermSize 256m<br>
vm: -Xmx40m -Xmx256m 
|-
|tooling[ws.os.arch][bundle-id]
| Start level information for individual bundles
|}
|}
|}
<br>
==Using org.eclipse.platform.ide As-Is ==
In general, the org.eclipse.platform.ide is not attractive for reuse in other products as it includes product specific branding and settings.  However, in the special case of products (like EPP) that look the same as eclipse but change the default eclipse.product, then we could reuse org.eclipse.platform.ide directly.  The epp.product file would specify a program argument <tt>-product</tt> which would override the entry in the config.ini file.  As well, because org.eclipse.platform.ide includes launcher, we should set the product build to not include launchers.

This would be done using a [[Equinox/p2/Engine/Touchpoint Instructions#Authoring touchpoint data|p2.inf]] file which should be placed beside the product file.  The p2.inf file should also tell pde.build not to generate defaults CUs for start levels, because we will already get start levels from the platform.ide.
<pre>
builder/build.properties : includeLaunchers=false
epp.product
   Program Arguments: -product epp.package.cpp
   Include features : CDT, etc...
p2.inf 
   #tell pde.build not to generate start levels
   org.eclipse.pde.build.append.startlevels=false

   #add requirement on org.eclipse.platform.ide
   requires.1.namespace=org.eclipse.equinox.p2.iu
   requires.1.name=org.eclipse.platform.ide
   requires.1.range=[3.5.0.I20090513-2000,3.5.0.I20090513-2000]
   requires.1.greedy=true
</pre>

==Proposed Modifications==

We propose that the IU <tt>toolingorg.eclipse.platform.ide.configuration</tt> be made more generally reusable.  Currently, it contains the following product specific settings:
*config.ini settings: osgi.splashPath, eclipse.application,eclipse.product
* All program and vm arguments are arguably product specific, but <tt>-showsplash org.eclipse.platform</tt> is especially so.
We propose that these product specific setting be moved into the <tt>org.eclipse.platform.ide</tt> IU, leaving the configuration IU as more generally reusable.

==Links==
*[[Equinox/p2/Engine/Touchpoint_Instructions| Touchpoint Instructions]]
*[https://bugs.eclipse.org/bugs/show_bug.cgi?id=276125 Bug 276125 - Structure configuration metadata for reuse]



[[Category:Equinox p2|Reusing Platform Metadata]]
Templates used on this page:
Template:CommentBox
Return to Equinox/p2/Reusing Platform Metadata.
Retrieved from "http://wiki.eclipse.org/Equinox/p2/Reusing_Platform_Metadata"