Jump to: navigation, search

Difference between revisions of "Data Tools Platform:Release Engineering"

(Design)
(org.eclipse.datatools.releng)
Line 40: Line 40:
  
 
===org.eclipse.datatools.releng===
 
===org.eclipse.datatools.releng===
This project contains the [http://help.eclipse.org/help32/index.jsp?topic=/org.eclipse.pde.doc.user/guide/tasks/pde_fetch_phase.htm map files] used by the [http://help.eclipse.org/help32/index.jsp?topic=/org.eclipse.pde.doc.user/guide/tasks/pde_feature_build.htm PDE builder].  The map files are used to specify the following information, which is used by the [http://help.eclipse.org/help32/index.jsp?topic=/org.eclipse.pde.doc.user/guide/tasks/pde_feature_build.htm PDE builder] when it fetches the source for the build:
+
This project contains the following files:
*plugin/fragment/bundle/feature ID
+
*[http://help.eclipse.org/help32/index.jsp?topic=/org.eclipse.pde.doc.user/guide/tasks/pde_fetch_phase.htm *.map files]
*plugin/fragment/bundle/feature location in CVS (project and path)
+
*:used by the [http://help.eclipse.org/help32/index.jsp?topic=/org.eclipse.pde.doc.user/guide/tasks/pde_feature_build.htm PDE builder] to locate and fetch source for the buildThese files are used to specify the following information:
*build tag
+
*:*plugin/fragment/bundle/feature ID
*:the tag of the source that should be fetched
+
*:*plugin/fragment/bundle/feature location in CVS (project and path)
 +
*:*tag to fetch
 +
*'''dependencies.properties''' file
 +
*:specifies name and download information for dependencies (e.g. Eclipse platform, EMF, GEF)
 +
*'''build.cfg''' file
 +
*:specifies which version of the DTP builder should be used to execute the build

Revision as of 16:04, 12 February 2007

Back to DTP Main Page

This information is preliminary. While this system is available within CVS, it is not currently used to generate the DTP builds.

This page details the build system utilised by DTP.

Overview

This system was derived from the system used by WTP and STP (and probably others). The system performs the following tasks:

  • Component builds
    builds plugins and features
    generates install ZIP
    generates update site JARs
  • Component testing
    executes unit tests
    generates results files
  • Update site generation
    generates html for download site
    incorporates build settings
    incorporates build results (e.g. warnings/errors)
    incorporates test results
  • Download site generation
    [TBD]
  • Uploading build information
    publishes generated files to DTP web site

Design

The build system is designed to organized as follows:

distribution
a group of one or more components
component
synonymous with feature; the input to the builder/assembler/packager

The system is comprised of custom Ant scripts which are used to initialize build properties, download dependencies, invoke the PDE builder for individual components, generate site files.

The head-less PDE builder is used to generate plugin JARs and ZIPs. The PDE builder executes a build using information in the feature and plugin manifests. This helps ensure the plugin build environment is similar to its execution environment.

The system is composed of two projects within CVS:

  • org.eclipse.datatools.releng
  • org.eclipse.datatools.releng.builder

org.eclipse.datatools.releng

This project contains the following files:

  • *.map files
    used by the PDE builder to locate and fetch source for the build. These files are used to specify the following information:
    • plugin/fragment/bundle/feature ID
    • plugin/fragment/bundle/feature location in CVS (project and path)
    • tag to fetch
  • dependencies.properties file
    specifies name and download information for dependencies (e.g. Eclipse platform, EMF, GEF)
  • build.cfg file
    specifies which version of the DTP builder should be used to execute the build