Taxonomic Editor Release

The Taxonomic Editor is using eclipse tycho for integrating the OSGI build process into maven. Unfortunately the maven release plugin is not yet working with eclipse tycho (version 0.13) . This document explains all steps necessary to create a new release of the Taxonomic Editor. It is desirable to automate this process (see #xxxx).

Table of Contents

1. Prerequisites
2. Adapting cdmlib version
   1. Setting the release version number
3. Create products
4. Create tag for release
5. Bump trunk to new version
6. Create new development branch

---

Prerequisites

1. Make sure that all relevant changes have been merged into the branch (or trunk) you want to do the release from
2. There has to be a released cdmlib version (no snapshot), which the Taxonomic Editor depends on

Adapting cdmlib version

1. In taxeditor-parent's pom.xml, change the version number of cdmlib to the desired version
2. In eu.etaxonomy.taxditor.cdmlib, mvn validate to let maven copy the desired cdmlib jars.
3. Adapt the classpath to includethe desired cdmlib version in eu.etaxonomy.taxeditor.cdmlib
   1. Open MANIFEST.MF in 'Plugin Manifest Editor'
   2. Select 'Runtime' tab
   3. In the "Classpath" section, remove the entries for cdmlib
   4. Add the cdmlib jars with the desired version.

Setting the release version number

Bump the version number to <version>.BUILDQUALIFIER, e.g. 3.0.10-RELEASE. From taxeditor-parent execute:

mvn -Dtycho.mode=maven org.eclipse.tycho:tycho-versions-plugin:set-version -DnewVersion=<version>.BUILDQUALIFIER

This version numbers in poms and MANIFEST.MF files should be changed now.

Attention: This procedure did not work for the eu.etaxonomy.taxeditor.product file in the eu.etaxonomy.taxeditor project and the version number change had to be added manually (2012-02-07).

Create products

You can create the products with

mvn package

• The created products reside in eu.etaxonomy.taxeditor/target
• The packages should be moved to a folder with the name of the unqualified version (e.g. 3.0.9) in http://wp5.e-taxonomy.eu/download/taxeditor/
• Update the stable symbolic link to point to the new folder

Create tag for release

Commit the changes and create a tag with the release version number in http://dev.e-taxonomy.eu/svn/tags/taxeditor/release/

Bump trunk to new version

Update the version number to <version+1>-SNAPSHOT. From taxeditor-parent execute:

mvn -Dtycho.mode=maven org.eclipse.tycho:tycho-versions-plugin:set-version -DnewVersion=<version+1>-SNAPSHOT

Attention: This procedure did not work for the eu.etaxonomy.taxeditor.product file in the eu.etaxonomy.taxeditor project and the version number change had to be added manually (2012-02-07).

Create new development branch

Commit the changes and create a new branch named <version+1>-SNAPSHOT in http://dev.e-taxonomy.eu/svn/branches/taxeditor/