Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Data Tools Platform:Release Engineering
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
- used by the PDE builder to locate and fetch source for the build. These files are used to specify the following information:
- 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