Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The following build profiles are available in the KIELER Semantics repository:

...

Warning
titleToDo

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.

  1. 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.
  2. 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.

...

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:

  1. Set the TARGET_PLATFORM environment variable to point to a local copy of our currently used target platform p2 repository. Ask Unknown User (cds) where you can get that.
  2. Set the KIELER_REPOSITORY environment variable to point to a local copy of a p2 repository of our pragmatics build. Again, ask Unknown User (cds) where you can get that.
  3. Run Ant on the build.xml file. This will produce both versions of the KLay layout library.
Note

We would love to switch our KLay library build over to Maven since that would allow us to publish the library in an official Maven artifact repository.

 

Continuous and Nightly Builds

...

  1. 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.
  2. 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.
  3. 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.
  4. 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
titleTimestamps

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.

ArtifactRepositoryBuild FileBamboo Build PlanFinal Directory
KLay Layout LibrariesPragmatics...klay.libraries/build.xmlKIELER Pragmatics -> Nightly KLay/home/kieler/public_html/files/nightly/klayKLighDning RCAPragmatics...klighdning.repository/pom.xmlKIELER Pragmatics -> Nightly KLighDning
/home/kieler/public_html/files/nightly/klighning
KWebS RCAPragmatics...kwebs.repository/pom.xmlKIELER Pragmatics -> Nightly
Product
KWebS/home/kieler/public_html/files/nightly/kwebs
KIELER Pragmatics
Update Site
UpdatesitePragmatics...pragmatics.repository/pom.xmlKIELER Pragmatics -> Nightly
Product
Pragmatics Updatesite/home/kieler/public_html/updatesite/nightly/pragmatics/
Papyrus Layout
Update Site
UpdatesitePragmatics...papyrus.repository/pom.xmlKIELER Pragmatics -> Nightly
Product
Papyrus Updatesite/home/kieler/public_html/updatesite/nightly-papyrus/
KIELER RCASemantics...semantics.repository/pom.xmlKIELER Semantics -> Nightly Semantics Product/home/kieler/public_html/files/nightly/
KIELER Semantics
Update Site
UpdatesiteSemantics...semantics.repository/pom.xmlKIELER Semantics -> Nightly
Product
Semantics Updatesite/home/kieler/public_html/updatesite/nightly/semantics/
Ptolemy Libraries
Update Site
UpdatesitePtolemy...ptolemy.repository/pom.xmlKIELER Semantics -> Ptolemy
Update Site
Updatesite/home/kieler/public_html/updatesite/ptolemy/