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.
Difference between revisions of "Swordfish Documentation: Creating Headless Build"
Line 58: | Line 58: | ||
==Creating a Third-Party Build== | ==Creating a Third-Party Build== | ||
This is the first stage of the Swordfish build process, that is, creating the third-party builds. | This is the first stage of the Swordfish build process, that is, creating the third-party builds. | ||
+ | |||
+ | =====First Stage===== | ||
To successfully create and run the third-party build: | To successfully create and run the third-party build: | ||
Line 71: | Line 73: | ||
<b>NOTE</b>: It consists of the update site for Swordfish third-parties and is located in the <tt>site</tt> sub-directory. | <b>NOTE</b>: It consists of the update site for Swordfish third-parties and is located in the <tt>site</tt> sub-directory. | ||
<br> | <br> | ||
+ | |||
==Creating a Swordfish Headless Build== | ==Creating a Swordfish Headless Build== | ||
Line 76: | Line 79: | ||
<ol> | <ol> | ||
− | <li> | + | <li>Check out the following projects from the Swordfish SVN [http://dev.eclipse.org/svnroot/rt/org.eclipse.swordfish/ Swordfish SVN]</li> |
− | <li> | + | <ul> |
+ | <li>org.eclipse.swordfish.build</li> | ||
+ | <li>org.eclipse.swordfish.bundles</li> | ||
+ | <li>org.eclipse.swordfish.third-parties.site</li> | ||
+ | </ul> | ||
+ | <li>Switch to the directory <tt><Swordfish project root directory>/org.eclipse.swordfish.build</tt></li> | ||
+ | <li></li> | ||
+ | |||
+ | |||
</ol> | </ol> | ||
+ | |||
Revision as of 03:56, 16 May 2009
Contents
Creating and Running a Headless Build
This section contains instructions on creating a headless build.
Prerequisites
The following prerequisites must be met before you start creating the build.
Eclipse
- Install Eclipse SDK
- Install the subversion PDE build plug-in.
You can find it here: SVN PDE Build
NOTE: When making a remote build you need to fetch items (?) from SVN. - Download the zip file, org.eclipse.pde.build.svn-n.n.nRCn.zip.
Ant
Install the latest Ant build (currently, the version available is 1.7) and include it into your path.
You can find the latest version here: Apache Ant
SVN
Install the latest version of the SVN client (currently, the version available is 1.5).
You can find the latest version here: Subversion
About the Build Process
The build process is divided into two main stages. This is done for performance reasons. The first stage involves the following steps:
- Generate the third-party bundles
- Create an update site and store these bundles there.
- Upload the update site into the Swordfish download area
NOTE: 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.
The second stage involves the following steps:
- Create the Swordfish site.
- Create the corresponding Swordfish update site.
Detailed instructions are provided in the following sections.
Check Proxy Settings
If you want to run the build scripts within a firewall, ensure that you enable the proxy settings.
For example, 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.
Creating a Third-Party Build
This is the first stage of the Swordfish build process, that is, creating the third-party builds.
First Stage
To successfully create and run the third-party build:
- Check out the following projects from the Swordfish SVN Swordfish SVN + version-to check-out, for example, trunk.
- org.eclipse.swordfish.build
- org.eclipse.swordfish.bundles
- org.eclipse.swordfish.third-parties/org.eclipse.swordfish.third-parties.site
- Check the build results in org.eclipse.swordfish.build/target-third-parties.
NOTE: It consists of the update site for Swordfish third-parties and is located in the site sub-directory.
Creating a Swordfish Headless Build
To successfully create and run the Swordfish build:
- Check out the following projects from the Swordfish SVN Swordfish SVN
- org.eclipse.swordfish.build
- org.eclipse.swordfish.bundles
- org.eclipse.swordfish.third-parties.site
- Switch to the directory <Swordfish project root directory>/org.eclipse.swordfish.build