Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "RAP/Build"

< RAP
(Milestone/Release Build Check List)
(Redirected page to RAP/Build Process)
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
==Release Engineering==
+
#redirect [[RAP/Build Process]]
 
+
With RAP we have two different builds in place: one for the target and one of the tooling.
+
The build for the tooling heavily relies on the other build as we need to bundle the target into in the intro plugin and also need the sources for generating the help contents (like javadoc or extension point documentation).
+
 
+
===Setup the build===
+
The target build script resides in the <code>org.eclipse.rap.releng</code> bundle which can be found in CVS. What you need to do to setup a new target build is to checkout the releng plugin, download the eclipse sdk (at least platform+pde) for 3.2 and 3.3 and unzip them into a directory. Furthermore you need to modify the <code>build.properties</code> to point it to the right directories of your eclipse installations.
+
 
+
===Starting the build===
+
In order to start the build, you need to execute the pde build antscript by providing different parameters like which releng project to use and other options to control the output name (build type, version, etc).
+
A sample script could look like this:
+
<pre>
+
#!/bin/bash
+
export buildbase=/home/rapbuild/releng
+
cd /home/rapbuild/releng/build-platforms/3.3/plugins/org.eclipse.pde.build_3.3.0.v20070612/scripts
+
java -cp ../../org.eclipse.equinox.launcher_1.0.0.v20070606.jar:../../org.junit_3.8.2.v200706111738/junit.jar \
+
org.eclipse.core.launcher.Main -application org.eclipse.ant.core.antRunner \
+
-Dbuilder=`echo $buildbase`/org.eclipse.rap.releng/ -DbuildId=`date +%Y%m%d-%H%M`\
+
-Dbuild.base=`echo $buildbase` -DtargetVersion=1.0.1 -DbuildType=N \
+
-DoutputDirectory="`echo $WORKSPACE`/targets" $1
+
</pre>
+
 
+
{| border="1" cellpadding="2"
+
!width="50"|Name
+
!width="225"|Description
+
|-
+
|builder|| Which Builder to use (releng project in our case)
+
|-
+
|buildId|| build id to identify the builds
+
|-
+
|buildType|| which type the build is (N/I/R) - only used for labeling the output
+
|-
+
|build.base|| path to the root of our build. will be used for building and output of the build
+
|}
+
 
+
After executing the script you'll find a new build of the target platform in the <code>build.base</code>/targets directory.
+
 
+
===Building new version===
+
* update <code>targetVersion</code> paramter of the build script
+
* update bundle manifest with the new versions
+
 
+
===Adding new bundles===
+
* add them to one of the features
+
* update the map file with the name and path to the plugin
+
 
+
==Help==
+
===Adding new packages to javadoc===
+
* add reference in toc.xml of the help plugin
+
 
+
===Adding new extension point description===
+
* add reference in toc.xml of the help plugin
+
 
+
==Milestone/Release Build Check List==
+
* tag CVS
+
* <s> update JavaDoc in help plug-in: include reference documentation for extension schemas and JavaDoc of all plug-ins</s>
+
* <s> include the respective 3.4 target into the tooling build</s>
+
* update release train files (e.g. for Ganymede)
+
* update [[Ganymede/Signoffs]]
+
* notify newsgroup and mailing list
+
* finalize new & noteworthy
+
* update web site: new & noteworthy, download
+
* scan Bugzilla for bugs that are still open but solved, verify target version of closed bugs
+
 
+
[[Category:RAP]]
+

Latest revision as of 13:30, 17 November 2013

Redirect to:

Back to the top