Revision as of 03:07, 28 December 2007

Introduce

The purpose of this document is to supply some information on the new STP build system based on Buckminster. If you only want to use it to build STP plugins, then it needn't any backgrounds of Buckminster at all, otherwise, say extend the build system to add your new plugins to STP build system, then an understanding of Buckminster will be good.

Use Build System

This section will introduce on how to use the new build system to build STP quickly, here I will show commands based on Linux, building on Window is similar except some different arguments, I will give more detail at the end of this section.

Prerequisite

Target Platform

You need setup a target platform first before you building STP, the target platform is just a Eclipse SDK installation plus all the prerequisite plugins needed by STP, e.g. you need install plugins below to /shared/eclipse_java/eclipse directory:

• eclipse-SDK-3.3.1.1-linux-gtk.tar.gz
• wtp-sdk-R-2.0.1-20070926042742.zip
• GEF-SDK-3.3.1.zip
• GMF-sdk-2.0.1.zip
• emf-sdo-xsd-SDK-2.3.1.zip
• emf-query-SDK-1.1.zip
• emf-validation-SDK-1.1.1.zip
• emf-transaction-SDK-1.1.1.zip
• mdt-ocl-SDK-1.1.1.zip
• m2t-jet-SDK-incubation-0.8.1.zip
• orbit-R200709171314.zip
• jsr_jars-0.7.0

Since STP is under developing, so all the plugins list here will be changed, you can refer STP download page to get the latest information: http://download.eclipse.org/stp/downloads/

To run unit test, you need install test framework plugins too:

• eclipse-test-framework-3.3.1.1.zip

Again, please make sure you install all those to /shared/eclipse_java/eclipse directory.

JDK Installation

Install a JDK 1.5 on your build machine, make sure you can access javac and java from command line.

Apache Ant

Install a Apache Ant 1.7.0 on your build machine, make sure you can access ant from command line.

Build STP

1. check out build system from svn
$svn co http://dev.eclipse.org/svnroot/stp/trunk/build/buckminster buckminster

2. build STP
$cd buckminster
$ant                                              #this will show a help message to you
$ant -Dbase.directory=/local/temp/download build  #kick off resolve and build for STP

waiting for about 5 minutes, after finishing, you can find build results from /local/temp/download/working/build/buckminster/workspace, it depend on your base.directory setting.

Test STP

not finish, coming soon :)

Create STP update Site

This is straight forward using Buckminster, try command below

$ant -Dbase.directory=/local/temp/download stp.build.site

after finishing, you can find STP update site from /local/temp/download/working/build/buckminster/stp.site/org.eclipse.stp.build.root/site, it depend on your base.directory setting.

Build on Windows

1. you need tell the build system where to find the target platform, you need edit the stp.rmap file, in the searchPath for europa, change the url to point to your target platform, e.g. c:\eclipse

2. run command below

c:\>cd buckminster
c:\>ant -Dbase.directory=c:\local\temp\download -Dpde.target.platform.path=c:\eclipse -Dpde.target.arch=x86 -Dpde.target.os=windows -Dpde.target.ws=win32 build 

Extend Build System

Get familiar with Buckminster

1. Buckminster project: http://www.eclipse.org/buckminster/index.php

2. A good start tutorial: http://wiki.eclipse.org/Hello_XML_World_Example_%28Buckminster%29

How to Add New Plugin

Suppose you have a new plugin to add to STP build system, you should do things below: 1. You should guarantee it works fine inside Eclipse 2. You must add it a to a feature, the build system does support add a plugin, but it's not a good practise 3.

FAQ