Jump to: navigation, search

Difference between revisions of "DSDP/DD/Releng"

< DSDP‎ | DD
m
m (Building)
Line 36: Line 36:
 
** org.eclipse.wst.xml_ui.feature
 
** org.eclipse.wst.xml_ui.feature
 
** org.eclipse.wst.common_ui.feature
 
** org.eclipse.wst.common_ui.feature
 +
 +
All of these components have to have the correct version selected.  The easiest way to get the version to use in the build is to pull it from the site.xml file on the release update page.  For ganymede this page is: [http://download.eclipse.org/releases/ganymede/site.xml http://download.eclipse.org/releases/ganymede/site.xml]. 
 +
 +
Alternatively it is possible to get the version numbers and to install the components from the update sites of individual projects.  For example the CDT update site is [http://download.eclipse.org/tools/cdt/releases/ganymede/site.xml http://download.eclipse.org/tools/cdt/releases/ganymede/site.xml].
 +
 +
Note: at this moment (Eclipse SDK 3.4M6) the install feature is broken.  P2 team is working on fixing it.
 +
 +
=== customTargets.xml ===
 +
This ant file is used by the PDE build to perform portions of the build.  This file needs to be updated whenever features in the DD project are changed.
 +
 +
=== Pass/Fail ===
 +
The build process itself contains checks to determine whether there were errors in the build (this is done in the ''postBuild'' target of the customTargets.xml and file).  Based on whether there were errors detected, an appropriate message is mailed to the address specified in the ''mailTo'' property. 
 +
 +
However, in practice the error detection in the build is not always reliable.  Sometimes the compiler used by PDE does not generate errors but still fails to generate all the class files.  The only way to truly verify that a build succeeded is to install it and perform some testing on it.
  
 
== Releasing ==
 
== Releasing ==

Revision as of 12:36, 8 April 2008

Introduction

At the current moment (nearing completion of Ganymede release) there is no official build process for Eclipse projects. There are various rules and procedures that were put in place by various teams at various times and each project must find its own way through them. The Device Debugging project release process was implemented and is maintained by Ted Williams. This page is an attempt to document this process to allow us to support him.

Building

org.eclipse.dd.releng

The build scripts are all contained within the org.eclipse.dd.releng project. To run the build scripts, check out this project into your home directory.

nightly.sh, stable.sh

These two shell scripts call ant with the appropriate parameters in order to build the release image. The only different between these two scripts is the -DbuildType. Other parameters are described in the build-dd.xml file.

message.in

Template for the mail that will be sent upon completion of the build.

Note: At the moment mail notifications are broken in the build scripts.

installFeatures

installFeatures is a build step inside the dd-build.xml ant build script. This step calls the eclipse installation used to perform the build to update the installation with the given features. The features listed are dependent upon by the DD components being build. In summary the features are as follows:

  • MEMORY component
    • none, Eclipse SDK is the only dependency
  • DSF, MI, GDB component dependencies:
    • org.eclipse.cdt
  • IP-XACT component dependencies:
    • org.eclipse.draw2d
    • org.eclipse.gef
    • org.eclipse.emf.common
    • org.eclipse.emf.common.ui
    • org.eclipse.emf.ecore
    • org.eclipse.emf.edit
    • org.eclipse.emf.edit.ui
    • org.eclipse.emf.ecore.edit
    • org.eclipse.xsd
    • org.eclipse.xsd.edit
    • org.eclipse.wst
    • org.eclipse.wst.xml_ui.feature
    • org.eclipse.wst.common_ui.feature

All of these components have to have the correct version selected. The easiest way to get the version to use in the build is to pull it from the site.xml file on the release update page. For ganymede this page is: http://download.eclipse.org/releases/ganymede/site.xml.

Alternatively it is possible to get the version numbers and to install the components from the update sites of individual projects. For example the CDT update site is http://download.eclipse.org/tools/cdt/releases/ganymede/site.xml.

Note: at this moment (Eclipse SDK 3.4M6) the install feature is broken.  P2 team is working on fixing it.

customTargets.xml

This ant file is used by the PDE build to perform portions of the build. This file needs to be updated whenever features in the DD project are changed.

Pass/Fail

The build process itself contains checks to determine whether there were errors in the build (this is done in the postBuild target of the customTargets.xml and file). Based on whether there were errors detected, an appropriate message is mailed to the address specified in the mailTo property.

However, in practice the error detection in the build is not always reliable. Sometimes the compiler used by PDE does not generate errors but still fails to generate all the class files. The only way to truly verify that a build succeeded is to install it and perform some testing on it.

Releasing