Page History
...
The basic structure of the POM files is the same for both, the pragmatics and semantics repository, and can be seen below:
Each plug-in and feature has a corresponding (usually rather small) POM file. The POM files in the features
and plugins
directories know about the different features and plug-ins. The parent POM file, which all other POM files copy basic configuration from, knows about the feature and plug-in POM files, as well as about every kind of build configuration we have (for building the pragmatics repository, for building the KWebS product, etc.). In addition, the build
directory also contains a bunch of subdirectories . These also contain housing POM files that actually implement the different build configurations to produce our p2 repositories and our products we can deliver.
Using the KIELER Maven Build
Using the KIELER Maven build requires knowledge about two aspects: necessary configuration / required libraries and invoking Maven.
Necessary Configuration
KIELER needs to be built against a P2 repository generated from an Eclipse reference installation (the target platform). The command for doing that is described on this page. The target platform is available online so you don't have to worry about it when building KIELER on your local computer.
...
things: a working Maven installation (d'oh...) and knowledge about how exactly to trigger a build. We leave the former to you, but the latter is what this section is about.
To actually build KIELER once all preliminaries are done, navigate to the /build/
directory and run the following command line:
...
- klighdning – Builds a standalone version of the KLighDning server, based on the current nightly pragmatics update site.
- kwebs – Builds a standalone version of the KWebS server, based on the current nightly pragmatics update site.
- papyrus pragmatics – Builds a p2 repository that contains our feature for adding automatic layout to a Papyrus installation.pragmatics – Builds a p2 repository that contains our pragmatics featurespragmatics features. This is what would usually be pushed online for people to download as our nightly pragmatics build.
- ptolemy-rcp – Produces a standalone version of our Ptolemy Model Viewer, based on the current nightly build pragmatics update site.
The following build profiles are available in the KIELER Semantics repository:
Warning | ||
---|---|---|
| ||
Document the Semantics build profiles. |
What to Be Aware of
There are some things that people need to be aware of to keep the build files in a valid state.
- Eclipse metadata and POM files are not synchronized. Thus, if the version of an Eclipse plug-in changes, its
pom.xml
needs to be updated accordingly. - The repository POM directories contain product files and product icons. These are copies of the files found in the corresponding branding plug-ing (such as
de.cau.cs.kieler.core.product
) and have to be manually synchronized.
The Curious Case of Building the KLay Library
We distribute our KLay layout algorithms in two library files: one that contains just our algorithms, and another one that also contains dependencies such as required EMF classes. To build the KLay libraries, navigate to the /build/de.cau.cs.kieler.klay.libraries
directory and do the following:
- Set the TARGET_PLATFORM environment variable to point to a local copy of our currently used target platform p2 repository.
- Set the
KIELER_REPOSITORY
environment variable to point to a local copy of a p2 repository of our pragmatics build. - Run Ant on the
build.xml
file. This will produce both versions of the KLay layout library.
Continuous and Nightly Builds
There are basically three four different kinds of build plans for each of the KIELER projects:
- Continuous Plugins – Compiles the plug-ins and runs the unit tests on them. None of the compiled artifacts are published anywhere (in fact, no update site or product is even produced). This plan is triggered by pushing stuff into the repositories, giving early feedback regarding whether committed changes break anything.
- Nightly <Product> – Assembles distributable product files and/or update sites. Distributable files are published in the nightly build directory
/home/kieler/public_html/files/nightly
. Update sites are published in/home/kieler/public_html/updatesite/nightly
. These plans are run once every night. - Nightly Rating – Compiles the plug-ins and runs our code quality rating doclet on them. The result is a website published at
/home/kieler/public_html/rating
. This plan is run once every night. - Release Builds – Continuous builds of release branches once a release is imminent. These usually run whenever changes are pushed into the repository. All release builds are placed in a special Bamboo project calles KIELER Releases.
The Semantics project has an additional build plan:
...
Our automatic builds produce a bunch of so-called artifacts: redistributable applications as well as a number of update sites. This table lists all artifacts, the project or repository they belong to, the build file responsible for producing them, the Bamboo build plan that builds them, and the directory they are finally placed in.
Tip | ||
---|---|---|
| ||
Don't be alarmed if the timestamps of the plugin and feature jar files on the updatesite don't match the current time. The time is probably UTC. Which is nice. |
Artifact | Repository | Build File | Bamboo Build Plan | Final Directory |
---|
...klighdning.repository/pom.xml
/home/kieler/public_html/files/nightly/klighning
...klay.libraries/build.xml
/home/kieler/public_html/files/nightly/klay
KWebS RCA | Pragmatics | ...kwebs.repository/pom.xml | KIELER Pragmatics -> Nightly |
KWebS | /home/kieler/public_html/files/nightly/kwebs |
KIELER Pragmatics |
Updatesite | Pragmatics | ...pragmatics.repository/pom.xml | KIELER Pragmatics -> Nightly |
Pragmatics Updatesite | /home/kieler/public_html/updatesite/nightly/pragmatics/ |
Papyrus Layout |
Updatesite | Pragmatics | ...papyrus.repository/pom.xml | KIELER Pragmatics -> Nightly |
Papyrus Updatesite | /home/kieler/public_html/updatesite/nightly-papyrus/ | |||
KIELER RCA | Semantics | ...semantics.repository/pom.xml | KIELER Semantics -> Nightly Semantics Product | /home/kieler/public_html/files/nightly/ |
KIELER Semantics |
Updatesite | Semantics | ...semantics.repository/pom.xml | KIELER Semantics -> Nightly |
Semantics Updatesite | /home/kieler/public_html/updatesite/nightly/semantics/ |
Ptolemy Libraries |
Updatesite | Ptolemy | ...ptolemy.repository/pom.xml | KIELER Semantics -> Ptolemy |
Updatesite | /home/kieler/public_html/updatesite/ptolemy/ |