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 "Swordfish Documentation: Creating Headless Build"

(→‎Prerequisites)
 
(36 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
= Creating and Running a Headless Build =
+
= Creating and Running a Headless Build =
−
This section contains instructions on creating a headless build.<br>
+
  
−
[[Image:Swordfish_build_process1.png‎]]
+
This section contains instructions on creating a headless build.<br>
  
−
== Prerequisites ==
+
[[Image:Swordfish build process1.png]]
−
The following prerequisites must be met before you start creating the build.
+
−
You must have the latest version of Eclipse, Apache Ant & Subversion installed.
+
−
Detailed instructions are provided here.
+
  
−
=== Eclipse ===
+
== Prerequisites  ==
−
Install a fresh Eclipse SDK you want to use for building and keep it free from modifications.
+
  
−
=== Eclipse Test Framework ===
+
The following prerequisites must be met before you start creating the build. You must have the latest version of Eclipse, Apache Ant &amp; Subversion installed. Detailed instructions are provided here.
−
Download Eclipse Testing Framework package. You will need it in order to run integration tests which are part of the headless build.<br>
+
 
−
Eclipse Testing Framework for Eclipse for
+
=== Eclipse  ===
−
[http://www.eclipse.org/downloads/download.php?file=/eclipse/downloads/drops/R-3.5-200906111540/eclipse-test-framework-3.5.zip Galileo] or  
+
 
−
[http://download.eclipse.org/eclipse/downloads/drops/S-3.6M3-200910301201/download.php?dropFile=eclipse-test-framework-3.6M3.zip Helios] ''(Note that you cannot use a later Helios milestone than M3 for JUnit compatibility reasons!)''
+
Install a fresh Eclipse SDK you want to use for building and keep it free from modifications.
 +
 
 +
=== Eclipse Test Framework ===
 +
 
 +
Download Eclipse Testing Framework package. You will need it in order to run integration tests which are part of the headless build.<br> Eclipse Testing Framework for Eclipse for [http://www.eclipse.org/downloads/download.php?file=/eclipse/downloads/drops/R-3.5-200906111540/eclipse-test-framework-3.5.zip Galileo] or [http://archive.eclipse.org/eclipse/downloads/drops/S-3.6M3-200910301201/download.php?dropFile=eclipse-test-framework-3.6M3.zip Helios] ''(Note that you cannot use a later Helios milestone than M3 for JUnit compatibility reasons!)''  
  
 
=== Ant ===
 
=== Ant ===
−
Install the latest Ant build (currently, the version available is 1.7) and include it into your path.<br>
 
−
You can find the latest version here: [http://ant.apache.org/ Apache Ant]
 
  
−
=== Subversion PDE build plugin ===
+
Install the latest Ant build with the optional tasks (currently, the version available is 1.7) and include it into your path.<br> You can find the latest version here: [http://ant.apache.org/ Apache Ant]
 +
 
 +
=== Subversion PDE build plugin ===
 +
 
 +
This plugin is required to translate the CVS fetch commands PDE build creates to SVN commands.
 +
 
 
You can download the zipped version here: [http://sourceforge.net/projects/svn-pde-build/ SVN PDE Build]
 
You can download the zipped version here: [http://sourceforge.net/projects/svn-pde-build/ SVN PDE Build]
  
−
=== SVN ===
+
=== SVN ===
−
Install the latest version of the SVN client (currently, the version available is 1.6.2).<br>
+
−
You can find the latest version here: [http://subversion.apache.org/ Subversion]
+
  
−
=== Check Proxy Settings ===
+
Install the latest version of the SVN client (currently, the version available is 1.6.2).<br> You can find the latest version here: [http://subversion.apache.org/ Subversion]
−
If you want to run the build scripts within a firewall, ensure that you enable the proxy settings.
+
−
For example, add the <tt>-autoproxy</tt> parameter when you run the <tt>ant</tt> scripts.<br>  
+
−
<b>NOTE</b>: The <tt>ant</tt> scripts use your default system proxy settings.
+
  
−
You also need to ensure that your SVN client is enabled to access the [http://dev.eclipse.org/svnroot/soa/org.eclipse.swordfish Swordfish Repository] via your proxy.
+
=== Check Proxy Settings  ===
  
−
== Runtime build ==
+
If you want to run the build scripts within a firewall, ensure that you enable the proxy settings. E.g. add the <tt>-autoproxy</tt> parameter when you run the <tt>ant</tt> scripts.<br> '''NOTE''': The <tt>ant</tt> scripts use your default system proxy settings.
−
The build process is divided into two main stages. The first stage involves the following steps:
+
  
−
<ol>
+
You also need to ensure that your SVN client is enabled to access the [http://dev.eclipse.org/svnroot/soa/org.eclipse.swordfish Swordfish Repository] via your proxy.  
−
<li>Generate the third-party bundles</li>
+
−
<li>Create an update site and store these bundles there.</li>
+
−
<li>Upload the update site into the Swordfish download area.</li>
+
−
</ol>
+
−
<b>NOTE</b>: The last step only needs to be done when changes occur.  
+
−
For example, when you create a new bundle, remove an obsolete bundle or create a new bundle version.
+
−
<br>
+
  
−
The second stage involves the following steps:
+
== Runtime build  ==
  
−
<ol>
+
The build process is divided into two main stages. The first stage involves the following steps:
−
<li>Create the Swordfish site.</li>
+
−
<li>Create the corresponding Swordfish update site.</li>
+
−
</ol>
+
  
−
You also need to ensure that your SVN client is enabled to access the [http://dev.eclipse.org/svnroot/soa/org.eclipse.swordfish Swordfish Repository] via your proxy.
+
#Generate the third-party bundles
 +
#Create an update site and store these bundles there.  
 +
#Upload the update site into the Swordfish download area.  
  
−
=== Running a Third-Party Build ===
+
'''NOTE''': The last step only needs to be done when changes occur. E.g. when you create a new bundle, remove an obsolete bundle or create a new bundle version. <br>
−
This is the first step of the Swordfish build process, that is, creating the third-party builds.
+
  
−
To successfully create and run the third-party build:
+
The second stage involves the following steps:  
−
<ol>
+
−
<li>Check out the following projects from the [http://dev.eclipse.org/svnroot/soa/org.eclipse.swordfish/ Swordfish SVN] + version-to check-out, for example, trunk.
+
−
  <ul>
+
−
    <li><tt>rt/org.eclipse.swordfish.build</tt></li>
+
−
    <li><tt>rt/org.eclipse.swordfish.bundles</tt></li>
+
−
    <li><tt>third-parties/org.eclipse.swordfish.third-parties.site</tt></li>
+
−
  </ul>
+
−
<li>Edit the <tt>[local_directory]/rt/org.eclipse.swordfish.build/etc/launcher.properties</tt> to set these two properties:
+
−
<ol>
+
−
<li>eclipseLocation=[root directory of Eclipse installation, for example, <tt>c:/Program Files/eclipse</tt>]</li>
+
−
</ol> 
+
−
</li>
+
−
<li>Switch to the directory <tt><Swordfish project root directory>/rt/org.eclipse.swordfish.build</tt></li>
+
−
<li>Start the <tt>ant</tt> script to run the build with the parameter, <tt>third.parties</tt>.</li>
+
−
<li>Check the build results in <tt><local_directory>/rt/org.eclipse.swordfish.build/target-third-parties</tt>.</li><br>
+
−
  </ol>
+
−
<b>NOTE</b>: The build results consist of the update site for Swordfish third-parties. It is located in the <tt>site</tt> sub-directory.
+
−
<br>
+
  
−
=== Running the Swordfish Headless Build ===
+
#Create the Swordfish site.
−
This is the second step of the Swordfish build process, that is, creating the Swordfish build and update site.
+
#Create the corresponding Swordfish update site.  
  
−
==== Running as remote build ====
+
You also need to ensure that your SVN client is enabled to access the [http://dev.eclipse.org/svnroot/soa/org.eclipse.swordfish Swordfish Repository] via your proxy.
−
To successfully create and run the Swordfish build:
+
  
−
<ol>
+
=== Running a Third-Party Build ===
−
<li>Check out the following projects from the [http://dev.eclipse.org/svnroot/soa/org.eclipse.swordfish/ Swordfish SVN]</li>
+
−
  <ul>
+
−
    <li>rt/org.eclipse.swordfish.build</li>
+
−
      <li>rt/org.eclipse.swordfish.bundles</li>
+
−
      <li>third-parties/org.eclipse.swordfish.third-parties.site</li>
+
−
  </ul>
+
−
<li>Switch to the directory <tt>[Swordfish project root directory]/rt/org.eclipse.swordfish.build</tt></li>
+
−
  <li>Edit the <tt>[used_directory]/org.eclipse.swordfish.build/etc/launcher.properties</tt> to set these four properties:
+
−
<ol>
+
−
<li>eclipseLocation=[root directory of Eclipse installation, for example, <tt>c:/Program Files/eclipse</tt>]</li>
+
−
<li>pdeBuildPluginVersion=[version number of the PDE plugin. The PDE plugin can be found in Eclipse in the folder <tt>plugins</tt>]</li>
+
−
<li>eclipseTestFrameworkPackage=[location of Eclipse Testing Framework archive, for example, <tt>c:/Install/eclipse-test-framework-3.5.zip</tt>]</li>
+
−
</ol> 
+
−
<li>Start the <tt>ant</tt> script to run the build.</li>
+
−
<li>Check the build results:</li>
+
−
  <ul>
+
−
      <li>Browse to the directory <tt>org.eclipse.swordfish.build/target</tt>.</li>
+
−
      <li>The <tt>site</tt> sub-directory contains the update site for Swordfish.</li>
+
−
    </ul>
+
−
</ol>
+
  
−
==== Running as local build ====
+
This is the first step of the Swordfish build process, that is, creating the third-party builds.  
−
Before you run a local build the following tasks must first be completed.<br>
+
−
<ol>
+
−
<li>Execute the [[Swordfish_Documentation:_Creating_Headless_Build#Running_a_Third-Party_Build | third-party build]] ''(This has to be a remote build!)''.</li>
+
−
<li>Check the build results.</li>
+
−
<li>If not already done, check out '''all''' projects from the [http://dev.eclipse.org/svnroot/soa/org.eclipse.swordfish/ Swordfish SVN] + version-to check-out, for example, trunk. </li>
+
−
</ol>
+
  
−
To execute the local build:
+
To successfully create and run the third-party build:  
−
<ol>
+
−
<li>Switch to the directory <tt><Swordfish project root directory>/rt/org.eclipse.swordfish.build</tt> and execute the <tt>ant</tt> build script with parameter: <pre>ant -Dlocal=true</pre></li>
+
−
<br>
+
−
You can also specify this property in your launcher.properties file.
+
−
</ol>
+
  
−
==== Executing runtime tests ====
+
#Check out the following projects from the [http://dev.eclipse.org/svnroot/soa/org.eclipse.swordfish/ Swordfish SVN] + version-to check-out, e.g. <tt>trunk</tt>.
 +
#*<tt>rt/org.eclipse.swordfish.build</tt>
 +
#*<tt>rt/org.eclipse.swordfish.bundles</tt>
 +
#*<tt>third-parties/org.eclipse.swordfish.third-parties.site</tt>
 +
#Edit the <tt>[local_directory]/rt/org.eclipse.swordfish.build/etc/launcher.properties</tt> to set these two properties:
 +
#*<tt>eclipseLocation=</tt>[root directory of Eclipse installation, e.g. <tt>c:/BuildTools/eclipse</tt>]
 +
#*<tt>pdeSvnBuildPluginPackage=</tt>[fully qualified path to [[Swordfish Documentation: Creating Headless Build#Subversion_PDE_build_plugin|Subversion PDE build plugin zip]] e.g. <tt>c:/BuildTools/org.eclipse.pde.build.svn-1.0.1RC2.zip</tt> ]
 +
#Switch to the directory <tt>&lt;Swordfish project root directory&gt;/rt/org.eclipse.swordfish.build</tt>
 +
#Start the <tt>ant</tt> script to run the build with the parameter, <tt>third.parties</tt>.
 +
#Check the build results in <tt>&lt;local_directory&gt;/rt/org.eclipse.swordfish.build/target-third-parties</tt>.<br>
 +
 
 +
'''NOTE''': The build results consist of the update site for Swordfish third-parties. It is located in the <tt>site</tt> sub-directory. <br>
 +
 
 +
=== Running the Swordfish RT Headless Build  ===
 +
This is the second step of the Swordfish build process, that is, creating the Swordfish build and update site.
 +
 
 +
==== Running as remote build  ====
 +
To run the Swordfish RT build:
 +
 
 +
# Check out the following projects from the [http://dev.eclipse.org/svnroot/soa/org.eclipse.swordfish/ Swordfish SVN]
 +
#* <tt>rt/org.eclipse.swordfish.build</tt>
 +
#* <tt>rt/org.eclipse.swordfish.bundles</tt>
 +
#* <tt>third-parties/org.eclipse.swordfish.third-parties.site</tt>
 +
# Switch to the directory <tt>[Swordfish project root directory]/rt/org.eclipse.swordfish.build</tt>
 +
# Edit the <tt>[used_directory]/org.eclipse.swordfish.build/etc/launcher.properties</tt> to set these three properties:
 +
#* <tt>eclipseLocation=</tt>[root directory of Eclipse installation, e.g. <tt>c:/BuildTools/eclipse</tt>]
 +
#* <tt>pdeSvnBuildPluginPackage=</tt>[fully qualified path to [[Swordfish Documentation: Creating Headless Build#Subversion_PDE_build_plugin|Subversion PDE build plugin zip]] e.g. <tt>c:/BuildTools/org.eclipse.pde.build.svn-1.0.1RC2.zip</tt> ]
 +
#* <tt>eclipseTestFrameworkPackage=</tt>[location of Eclipse Testing Framework archive, e.g. <tt>c:/BuildTools/eclipse-test-framework-3.5.zip</tt>] 
 +
# Start the <tt>ant</tt> script to run the build.
 +
# Check the build results:
 +
* Browse to the directory <tt>org.eclipse.swordfish.build/target</tt>.
 +
* The <tt>site</tt> sub-directory contains the update site for Swordfish.
 +
 
 +
==== Running as local build  ====
 +
Before you run a local build the following tasks must first be completed.<br>
 +
 
 +
# Execute the [[Swordfish Documentation: Creating Headless Build#Running_a_Third-Party_Build|third-party build]] ''(This has to be a remote build!)''.
 +
# Check the build results.
 +
# If not already done, check out '''all''' rt and third-parties projects from the [http://dev.eclipse.org/svnroot/soa/org.eclipse.swordfish/ Swordfish SVN] + version-to check-out, e.g. <tt>trunk</tt>. 
 +
 
 +
To execute the local build:
 +
 
 +
* Switch to the directory <tt>&lt;Swordfish project root directory&gt;/rt/org.eclipse.swordfish.build</tt> and execute the <tt>ant</tt> build script with parameter (You can also specify this property in your launcher.properties file.): <pre>ant -Dlocal=true</pre>
 +
 
 +
==== Executing runtime tests ====
 
By default the tests execution is enabled. The results of the tests will be stored in  
 
By default the tests execution is enabled. The results of the tests will be stored in  
−
* <tt>rt/org.eclipse.swordfish.built/target/'''unit-tests'''</tt>
 
−
* <tt>rt/org.eclipse.swordfish.built/target/'''integration-tests'''</tt>
 
  
−
You can switch off the test execution by setting the system property <tt>noTest</tt> to true. E.g.:
+
*<tt>rt/org.eclipse.swordfish.built/target/'''unit-tests'''</tt>
−
<pre>ant -DnoTest=true</pre>
+
*<tt>rt/org.eclipse.swordfish.built/target/'''integration-tests'''</tt>
 +
 
 +
You can switch off the test execution by setting the system property <tt>noTest</tt> to true. E.g.:  
 +
<pre>ant -DnoTest=true</pre>  
 +
To run the tests later without doing a full build, use the targets
 +
 
 +
*<tt>unit.tests</tt> to run the unit tests and
 +
*<tt>integration.tests</tt> to run the integration tests
 +
 
 +
== Tooling build  ==
 +
To run the tooling build, you need the build results of the Runtime build.
 +
 
 +
=== Prerequisites  ===
 +
In addition to the general prerequisites building tooling requires some more tools.
 +
For license reasons and to make them easy to fetch they are provided [http://swordfish-tooling.googlecode.com/svn/trunk/BuildTools in the BuildTools directory at GoogleCode SVN].
 +
 
 +
Check out this directory to your local file system.
 +
 
 +
=== Running as remote build  ===
 +
To run the Swordfish Tooling build:
 +
 
 +
# Check out the project <tt>tools/org.eclipse.swordfish.build</tt> from the [http://dev.eclipse.org/svnroot/soa/org.eclipse.swordfish/ Swordfish SVN]
 +
# Switch to the directory <tt>[Swordfish project root directory]/tools/org.eclipse.swordfish.tooling.build</tt>
 +
# Edit the <tt>[used_directory]/tools/org.eclipse.swordfish.tooling.build/etc/launcher.properties</tt> to set these properties:
 +
#* <tt>eclipseLocation=</tt>[root directory of Eclipse installation, e.g. <tt>c:/BuildTools/eclipse</tt>]
 +
#* <tt>pdeSvnBuildPluginPackage=</tt>[fully qualified path to [[Swordfish Documentation: Creating Headless Build#Subversion_PDE_build_plugin|Subversion PDE build plugin zip]] e.g. <tt>c:/BuildTools/org.eclipse.pde.build.svn-1.0.1RC2.zip</tt> ]
 +
#* <tt>eclipseTestFrameworkPackage=</tt>[location of Eclipse Testing Framework archive, e.g. <tt>c:/BuildTools/eclipse-test-framework-3.5.zip</tt>] 
 +
#* <tt>third-parties=</tt>[path to the build tools directory, e.g. <tt>c:/BuildTools</tt>]
 +
#* <tt>lastGoodRTBundleLocation=</tt>[path to the runtime bundles in <tt>[Swordfish project root directory]/rt/org.eclipse.swordfish.build/target/platform/plugins</tt>]
 +
# Start the <tt>ant</tt> script to run the build.
 +
# Check the build results:
 +
* Browse to the directory <tt>org.eclipse.swordfish.tooling.build/target</tt>.
 +
* The <tt>site</tt> sub-directory contains the update site for Swordfish tooling.
 +
 
 +
=== Running as local build  ===
 +
# Modify the <tt>[used_directory]/tools/org.eclipse.swordfish.tooling.build/etc/launcher.properties</tt> as described for the [[Swordfish_Documentation:_Creating_Headless_Build#Running_as_remote_build_2 | remote tooling build]].
 +
# If not already done, check out '''all''' tools projects from the [http://dev.eclipse.org/svnroot/soa/org.eclipse.swordfish/ Swordfish SVN] + version-to check-out, e.g. <tt>trunk</tt>. 
 +
 
 +
To execute the local build:
 +
* Switch to the directory <tt>&lt;Swordfish project root directory&gt;/tools/org.eclipse.swordfish.tooling.build</tt> and execute the <tt>ant</tt> build script with parameter (You can also specify this property in your launcher.properties file.)
 +
: <pre>ant -Dlocal=true</pre>
 +
 
 +
=== Executing tooling tests  ===
 +
The unit tests are exclusively executed during the tooling build (remote or local).
 +
There is no option to run them separately.
 +
 
 +
If the build of tooling has finished successfully you can execute the system tests.
 +
Note that the tooling system tests run using SWTBot, so you have to wait until they have finished - otherwise they might fail.<br />
 +
The results will be stored at <tt>&lt;Swordfish project root directory&gt;/tools/org.eclipse.swordfish.tooling.build/target</tt>.
 +
 
 +
==== Running system tests as remote build  ====
 +
# Check out the project <tt>tools/org.eclipse.swordfish.tooling.systemtest.build</tt> from the [http://dev.eclipse.org/svnroot/soa/org.eclipse.swordfish/ Swordfish SVN] 
 +
# Switch to the directory <tt>[Swordfish project root directory]/tools/org.eclipse.swordfish.tooling.systemtest.build</tt>
 +
# Start the <tt>ant</tt> script to run the build.
 +
 
 +
==== Running system tests as local build  ====
 +
# Checkout & modify the <tt>[used_directory]/tools/org.eclipse.swordfish.tooling.systemtest.build/etc/launcher.properties</tt> as described for the [[Swordfish_Documentation:_Creating_Headless_Build#Running_system_tests_as_remote_build | remote system test build]].
 +
 
 +
To execute the local build:
 +
* Switch to the directory <tt>&lt;Swordfish project root directory&gt;/tools/org.eclipse.swordfish.tooling.systemtest.build</tt> and execute the <tt>ant</tt> build script with parameter (You can also specify this property in your launcher.properties file.)
 +
: <pre>ant -Dlocal=true</pre>
 +
 
  
−
To run the tests later without doing a full build, use the targets
+
----
−
* <tt>unit.tests</tt> to run the unit tests and
+
−
* <tt>integration.tests</tt> to run the integration tests
+
  
−
----------------
+
[[Swordfish Documentation|Swordfish Documentation Home]] <br> [[Swordfish|Swordfish Wiki Home]] <br>
−
[[Swordfish_Documentation |Swordfish Documentation Home]] <br/>
+
−
[[Swordfish | Swordfish Wiki Home]] <br/>
+

Latest revision as of 09:16, 1 July 2010

Creating and Running a Headless Build

This section contains instructions on creating a headless build.

Swordfish build process1.png

Prerequisites

The following prerequisites must be met before you start creating the build. You must have the latest version of Eclipse, Apache Ant & Subversion installed. Detailed instructions are provided here.

Eclipse

Install a fresh Eclipse SDK you want to use for building and keep it free from modifications.

Eclipse Test Framework

Download Eclipse Testing Framework package. You will need it in order to run integration tests which are part of the headless build.
Eclipse Testing Framework for Eclipse for Galileo or Helios (Note that you cannot use a later Helios milestone than M3 for JUnit compatibility reasons!)

Ant

Install the latest Ant build with the optional tasks (currently, the version available is 1.7) and include it into your path.
You can find the latest version here: Apache Ant

Subversion PDE build plugin

This plugin is required to translate the CVS fetch commands PDE build creates to SVN commands.

You can download the zipped version here: SVN PDE Build

SVN

Install the latest version of the SVN client (currently, the version available is 1.6.2).
You can find the latest version here: Subversion

Check Proxy Settings

If you want to run the build scripts within a firewall, ensure that you enable the proxy settings. E.g. add the -autoproxy parameter when you run the ant scripts.
NOTE: The ant scripts use your default system proxy settings.

You also need to ensure that your SVN client is enabled to access the Swordfish Repository via your proxy.

Runtime build

The build process is divided into two main stages. The first stage involves the following steps:

  1. Generate the third-party bundles
  2. Create an update site and store these bundles there.
  3. Upload the update site into the Swordfish download area.

NOTE: The last step only needs to be done when changes occur. E.g. when you create a new bundle, remove an obsolete bundle or create a new bundle version.

The second stage involves the following steps:

  1. Create the Swordfish site.
  2. Create the corresponding Swordfish update site.

You also need to ensure that your SVN client is enabled to access the Swordfish Repository via your proxy.

Running a Third-Party Build

This is the first step of the Swordfish build process, that is, creating the third-party builds.

To successfully create and run the third-party build:

  1. Check out the following projects from the Swordfish SVN + version-to check-out, e.g. trunk.
    • rt/org.eclipse.swordfish.build
    • rt/org.eclipse.swordfish.bundles
    • third-parties/org.eclipse.swordfish.third-parties.site
  2. Edit the [local_directory]/rt/org.eclipse.swordfish.build/etc/launcher.properties to set these two properties:
    • eclipseLocation=[root directory of Eclipse installation, e.g. c:/BuildTools/eclipse]
    • pdeSvnBuildPluginPackage=[fully qualified path to Subversion PDE build plugin zip e.g. c:/BuildTools/org.eclipse.pde.build.svn-1.0.1RC2.zip ]
  3. Switch to the directory <Swordfish project root directory>/rt/org.eclipse.swordfish.build
  4. Start the ant script to run the build with the parameter, third.parties.
  5. Check the build results in <local_directory>/rt/org.eclipse.swordfish.build/target-third-parties.

NOTE: The build results consist of the update site for Swordfish third-parties. It is located in the site sub-directory.

Running the Swordfish RT Headless Build

This is the second step of the Swordfish build process, that is, creating the Swordfish build and update site.

Running as remote build

To run the Swordfish RT build:

  1. Check out the following projects from the Swordfish SVN
    • rt/org.eclipse.swordfish.build
    • rt/org.eclipse.swordfish.bundles
    • third-parties/org.eclipse.swordfish.third-parties.site
  2. Switch to the directory [Swordfish project root directory]/rt/org.eclipse.swordfish.build
  3. Edit the [used_directory]/org.eclipse.swordfish.build/etc/launcher.properties to set these three properties:
    • eclipseLocation=[root directory of Eclipse installation, e.g. c:/BuildTools/eclipse]
    • pdeSvnBuildPluginPackage=[fully qualified path to Subversion PDE build plugin zip e.g. c:/BuildTools/org.eclipse.pde.build.svn-1.0.1RC2.zip ]
    • eclipseTestFrameworkPackage=[location of Eclipse Testing Framework archive, e.g. c:/BuildTools/eclipse-test-framework-3.5.zip]
  4. Start the ant script to run the build.
  5. Check the build results:
  • Browse to the directory org.eclipse.swordfish.build/target.
  • The site sub-directory contains the update site for Swordfish.

Running as local build

Before you run a local build the following tasks must first be completed.

  1. Execute the third-party build (This has to be a remote build!).
  2. Check the build results.
  3. If not already done, check out all rt and third-parties projects from the Swordfish SVN + version-to check-out, e.g. trunk.

To execute the local build:

  • Switch to the directory <Swordfish project root directory>/rt/org.eclipse.swordfish.build and execute the ant build script with parameter (You can also specify this property in your launcher.properties file.): 
    ant -Dlocal=true

Executing runtime tests

By default the tests execution is enabled. The results of the tests will be stored in

  • rt/org.eclipse.swordfish.built/target/unit-tests
  • rt/org.eclipse.swordfish.built/target/integration-tests

You can switch off the test execution by setting the system property noTest to true. E.g.: 

ant -DnoTest=true

To run the tests later without doing a full build, use the targets

  • unit.tests to run the unit tests and
  • integration.tests to run the integration tests

Tooling build

To run the tooling build, you need the build results of the Runtime build.

Prerequisites

In addition to the general prerequisites building tooling requires some more tools. For license reasons and to make them easy to fetch they are provided in the BuildTools directory at GoogleCode SVN.

Check out this directory to your local file system.

Running as remote build

To run the Swordfish Tooling build:

  1. Check out the project tools/org.eclipse.swordfish.build from the Swordfish SVN
  2. Switch to the directory [Swordfish project root directory]/tools/org.eclipse.swordfish.tooling.build
  3. Edit the [used_directory]/tools/org.eclipse.swordfish.tooling.build/etc/launcher.properties to set these properties:
    • eclipseLocation=[root directory of Eclipse installation, e.g. c:/BuildTools/eclipse]
    • pdeSvnBuildPluginPackage=[fully qualified path to Subversion PDE build plugin zip e.g. c:/BuildTools/org.eclipse.pde.build.svn-1.0.1RC2.zip ]
    • eclipseTestFrameworkPackage=[location of Eclipse Testing Framework archive, e.g. c:/BuildTools/eclipse-test-framework-3.5.zip]
    • third-parties=[path to the build tools directory, e.g. c:/BuildTools]
    • lastGoodRTBundleLocation=[path to the runtime bundles in [Swordfish project root directory]/rt/org.eclipse.swordfish.build/target/platform/plugins]
  4. Start the ant script to run the build.
  5. Check the build results:
  • Browse to the directory org.eclipse.swordfish.tooling.build/target.
  • The site sub-directory contains the update site for Swordfish tooling.

Running as local build

  1. Modify the [used_directory]/tools/org.eclipse.swordfish.tooling.build/etc/launcher.properties as described for the remote tooling build.
  2. If not already done, check out all tools projects from the Swordfish SVN + version-to check-out, e.g. trunk.

To execute the local build:

  • Switch to the directory <Swordfish project root directory>/tools/org.eclipse.swordfish.tooling.build and execute the ant build script with parameter (You can also specify this property in your launcher.properties file.)
ant -Dlocal=true

Executing tooling tests

The unit tests are exclusively executed during the tooling build (remote or local). There is no option to run them separately.

If the build of tooling has finished successfully you can execute the system tests. Note that the tooling system tests run using SWTBot, so you have to wait until they have finished - otherwise they might fail.
The results will be stored at <Swordfish project root directory>/tools/org.eclipse.swordfish.tooling.build/target.

Running system tests as remote build

  1. Check out the project tools/org.eclipse.swordfish.tooling.systemtest.build from the Swordfish SVN
  2. Switch to the directory [Swordfish project root directory]/tools/org.eclipse.swordfish.tooling.systemtest.build
  3. Start the ant script to run the build.

Running system tests as local build

  1. Checkout & modify the [used_directory]/tools/org.eclipse.swordfish.tooling.systemtest.build/etc/launcher.properties as described for the remote system test build.

To execute the local build:

  • Switch to the directory <Swordfish project root directory>/tools/org.eclipse.swordfish.tooling.systemtest.build and execute the ant build script with parameter (You can also specify this property in your launcher.properties file.)
ant -Dlocal=true


Swordfish Documentation Home
Swordfish Wiki Home

Retrieved from "https://wiki.eclipse.org/index.php?title=Swordfish_Documentation:_Creating_Headless_Build&oldid=210050"

This page was last modified 09:16, 1 July 2010 by J. Based on work by Diya, Sergey Dneprovskiy and Anne Aloysious and others.

Back to the top