Difference between revisions of "PDE/Build"

From Eclipsepedia

< PDE
Jump to: navigation, search
(Documentation)
 
(19 intermediate revisions by 7 users not shown)
Line 1: Line 1:
PDE/Build builds plug-ins.  It is used behind the scenes during export, and it is used for automated headless builds.  The purpose of this page is to answer some of the commond questions that arise.
+
{{PDE}}
  
A lot of documentation was written for PDE/Build in 3.2Reading the docs will be useful, start [http://help.eclipse.org/help32/index.jsp?topic=/org.eclipse.pde.doc.user/guide/tasks/pde_feature_build.htm here].  
+
PDE/Build builds plug-insIt is used behind the scenes during export, and it is used for automated headless builds. The purpose of this page is to answer some of the common questions that arise.
  
==Java source level problems during Export==
+
==Documentation==
*I set my compliance levels, why doesn't it work?
+
There is a significant amount of documentation in the Eclipse Help system under "Plug-in Development Environment Guide > Tasks > PDE Build".  The latest version of Eclipse Help is always available online at [http://help.eclipse.org help.eclipse.org].  Helios documentation for PDE/Build starts  [http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.pde.doc.user/tasks/pde_feature_build.htm here].  
*How do I Compile against arbitrary JDKs?
+
*java.lang.UnsupportedClassVersionError
+
  
PDE/UI performs the export by using PDE/Build to generate build scripts. PDE/Build does not know anything about the Java Builder settings in your workspace or on your project. Your plug-in's manifest.mf and build.properties files are the input to PDE/Build. See [http://help.eclipse.org/help32/index.jsp?topic=/org.eclipse.pde.doc.user/guide/tasks/pde_compilation_env.htm this page] for specifics on controlling the compilation environment for your plug-in.
+
Some of the advanced topics covered in the help system include:
 +
* Customizing the build [http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.pde.doc.user/tasks/pde_customization.htm]
 +
* Fetching source from repositories [http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.pde.doc.user/tasks/pde_fetch_phase.htm]
 +
* Controlling compiler specific settings [http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.pde.doc.user/tasks/pde_compilation_env.htm]
 +
* Generating source bundles [http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.pde.doc.user/tasks/pde_individual_source.htm]
 +
* Building for p2 [http://help.eclipse.org/helios/index.jsp?nav=/4_2_2]
  
The properties specifying the locations of the JDKs to compile against are automatically set during export by PDE/UI based on your installed JREs: Preferences->Java->Installed JREs->Execution Environment.
 
  
So, to set your compilation environment:
+
===FAQ===
#Setup your installed JREs in your preferences.
+
See [[PDE/Build/FAQ]].
#Set your Bundle-RequiredExecutionEnvironment in your manifest.
+
#or set <tt>jre.compilation.profile</tt> in your build.properties
+
#or set <tt>javacSource</tt>, <tt>javacTarget</tt> in your build.properties
+
  
Bugs: If you are using .qualifier in your bundle's version, see [https://bugs.eclipse.org/bugs/show_bug.cgi?id=153778 bug 153778].
 
  
==Including files in the root of my build==
+
[[Category:PDE|Build]] [[Category:PDE/Build]]
Files can be included in the root of your build by using a Feature.  See  [http://help.eclipse.org/help32/index.jsp?topic=/org.eclipse.pde.doc.user/reference/pde_feature_generating_build.htm this page] for the root properties to set in your feature's build.properties file.
+
 
+
If you are doing a product build using productBuild.xml and a .product file instead of a normal feature driven build, then you must somehow include your feature containing the root files.  There are two possibilities for doing this:
+
#Have your .product file based on features, and include your root feature.  If your root feature does not containg the <tt>bin.includes</tt> property, then it will not be included in the final build results, but the root files will be.
+
#If your .product file is based on plug-ins, you need to get your feature to be included in the generated container feature that is driving the product build.  The feature generator allows you to specify a list of additional features and plug-ins to be included.  Use the featureList property to add your root feature.  Note that in 3.2, the productBuild.xml script did not pass this property to the feature generator ([https://bugs.eclipse.org/bugs/show_bug.cgi?id=158761 bug 158761]).  You will need to add it to the productBuild.xml:
+
<code>
+
<target name="generateFeature">
+
    <eclipse.generateFeature
+
      featureId="org.eclipse.pde.build.container.feature"
+
      buildDirectory="${buildDirectory}"
+
      baseLocation="${baseLocation}"
+
      productFile="${product}"
+
      verify="${verify}"
+
      pluginPath="${pluginPath}"
+
      configInfo="${configs}"
+
      pluginList="${pluginList}"
+
      featureList="${featureList}"
+
    />
+
</target>
+
</code>
+
+
==Fetching the .product file in a product build==
+
When using the productBuild.xml and a .product file to build your product, the feature or plug-in that contains the .product file must exist on disk before the fetch phase of the build.  This is because we need to generate the container feature first so that we know what we need to fetch.
+
 
+
You can fetch the feature/plug-in containing the .product file using a custom step earlier on in the build. Use customTargets.xml, in the postSetup target, call ${genericTargets}/fetchElement. Something like:
+
<code>
+
  <ant antfile="${genericTargets}" target="fetchElement">
+
    <property name="type" value="feature"/>
+
    <property name="id" value="org.feature.containing.product.file" />
+
  </ant>
+
</code>
+
See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=159128 bug 159128].
+
 
+
==Problems parsing feature file in a product build==
+
Error is something like:
+
org.eclipse.pde.build_3.2.0.v20060601\scripts\productBuild\productBuild.xml:45:
+
Problems parsing the feature file:/build/features/org.eclipse.pde.build.container.feature/feature.xml.
+
or:
+
[eclipse.generateFeature] Could not read:
+
file:/tmp/builder/build/tempbuild/features/org.eclipse.pde.build.container.feature/feature.xml
+
 
+
This is [https://bugs.eclipse.org/bugs/show_bug.cgi?id=152577 bug 152577].  The workaround is to modify the productBuild.xml to delete the feature before its regeneration in the generateFeature target:
+
  <target name="generateFeature">
+
    <delete dir="${buildDirectory}/features/org.eclipse.pde.build.container.feature"/>
+
    <eclipse.generateFeature
+
        featureId="org.eclipse.pde.build.container.feature"
+
        buildDirectory="${buildDirectory}"
+
        baseLocation="${baseLocation}"
+
        productFile="${product}"
+
        verify="${verify}"
+
        pluginPath="${pluginPath}"
+
        configInfo="${configs}"
+
    />
+
  </target>
+
 
+
 
+
12:23, 11 October 2006 (EDT) [[Special:Contributions/Aniefer.ca.ibm.com]]
+

Latest revision as of 15:24, 8 June 2010

PDE
Website
Download
Community
Mailing ListForumsIRC
Bugzilla
Open
Help Wanted
Bug Day
Contribute
Browse SourceProject Set File

PDE/Build builds plug-ins. It is used behind the scenes during export, and it is used for automated headless builds. The purpose of this page is to answer some of the common questions that arise.

[edit] Documentation

There is a significant amount of documentation in the Eclipse Help system under "Plug-in Development Environment Guide > Tasks > PDE Build". The latest version of Eclipse Help is always available online at help.eclipse.org. Helios documentation for PDE/Build starts here.

Some of the advanced topics covered in the help system include:

  • Customizing the build [1]
  • Fetching source from repositories [2]
  • Controlling compiler specific settings [3]
  • Generating source bundles [4]
  • Building for p2 [5]


[edit] FAQ

See PDE/Build/FAQ.