Nebula uses Maven Tycho to run its build
Maven / Tycho
Building with Maven and Tycho requires Java and Maven3 to be installed on your computer and a POM file (pom.xml). A POM file is a project definition and must be located at the root of each module. This file contains everything maven needs to build, package, test, run reports, ... the project.
Each Nebula widget needs this file, but in order to reduce the amount of configuration required, we use a parent POM which contains all common configuration. This special project must be installed locally before building a widget.
checkout org.eclipse.nebula.nebula-parent and run maven in this project's folder :
Note : when running a complete build, this project is automatically installed.
A widget pom content :
<?xml version="1.0" encoding="UTF-8"?>
<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
<parent> <artifactId>nebula-parent</artifactId> <groupId>org.eclipse.nebula</groupId> <version>1.0.0-SNAPSHOT</version> <relativePath>../org.eclipse.nebula.nebula-parent</relativePath> </parent>
<groupId>org.eclipse.nebula</groupId> <artifactId>org.eclipse.nebula.widgets.gallery</artifactId> <version>0.5.3-SNAPSHOT</version> <packaging>eclipse-plugin</packaging>
The only values which require modification are groupId, artifactId and version
Note : that the version number must match the version in MANIFEST.MF. Snapshot means developement version and requires an ending .qualifier in the plugin version.
Building a widget only requires a single command :
jar files are then available in the target folder.
Tests bundles use the same pom with only a different packaging type (see gallery test plugin).
Note : tests run in an osgi environnement which is different from running the tests in PDE. As a result tests may have to be modified to run correctly on both Maven and PDE.
Nebula has 2 builds : Release for stable widget aiming for a 1.0 release (org.eclipse.swt.nebula.nebula-release) and Incubation (org.eclipse.swt.nebula.nebula-incubation) for widget which are work in progress.
Running these build requires to check-out the full nebula repository, to go into the selected build folder and run
mvn install integration-test
Note: integration-test runs tests from test-bundles
Adding a new widget to one of these build is easy. Once the widget builds with Maven, just add an additionnal module to the build pom :
These jobs are set up to run on Hudson every 5 hours if the repository has changed
From this page, you can see build results, download jars and view java doc.
Lastest jars are available at these url
Please note that jars are not yet published to download.eclipse.org and features/update sites are not yet generated. This requires additional setup.
Email notifications : Every Nebula committer has write access to builds configuration on Hudson. Most settings do not need to be changed but email addresses can be added for build event notifications (failures, return to normal)