TaxonomicEditorRelease » History » Revision 22
Revision 21 (Andreas Müller, 06/27/2012 06:21 PM) → Revision 22/52 (Andreas Müller, 06/27/2012 06:51 PM)
# 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).
{{>toc}}
----
## Prerequisites
1. Make sure that all relevant changes have been merged from the SNAPSHOT development branch into the trunk so the trunk can be used to make the release
1. Lock the current SNAPSHOT branch so that no more commits can be made. In a fresh checkout you can lock the whole directory in zsh with
~~~
svn lock <root>/**/*(.)
~~~
in bash with
<pre>
find <root> -type f | xargs svn lock
</pre>
1. 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 ONLY the version number of cdmlib (cdmlib.version) to the desired version e.g. from 3.0.9-SNAPSHOT to 3.0.10-SNAPSHOT
1. In eu.etaxonomy.taxditor.cdmlib, `mvn validate` to let maven copy the desired cdmlib jars.
1. Adapt the classpath to includethe desired cdmlib version in eu.etaxonomy.taxeditor.cdmlib
1. Open MANIFEST.MF in 'Plugin Manifest Editor'
1. Select 'Runtime' tab
1. In the "Classpath" section, remove the entries for cdmlib
1. Add the cdmlib jars with the desired version (these were copied into eu.etaxonomy.taxeditor.cdmlib/lib by the mvn validate step)
### Setting the release version number
Bump the version number to <version>.BUILDQUALIFIER, e.g. 3.0.10-RELEASE. From taxeditor-parent execute (replacing the <version> with the release number and replacing the BUILDQUALIFIER with a timestamp e.g. 3.0.10.201205251209:
NOTE: Test if -DnewVersion=3.0.10.RELEASE works.
~~~
mvn -Dtycho.mode=maven org.eclipse.tycho:tycho-versions-plugin:set-version -DnewVersion=<version>.BUILDQUALIFIER
~~~
The outcome of running this command is that the version numbers in poms and MANIFEST.MF files have been changed.
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), we also changed it manually for the 3.0.10 release on 25.05.2012.
## Create products
You can create the products with
~~~
mvn package
~~~
taxeditor parent.
* 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.10) in http://wp5.e-taxonomy.eu/download/taxeditor/ located under /var/www/download
* 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/
For example use subclipse we also changed it manually for the 3.0.10 release on 25.05.2012.
## 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), we also changed it manually to 3.0.11-SNAPSHOT on 25.05.2012. Edit the parent pom manually with 3.0.11-SNAPSHOT in 3 places.
## 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/ e.g. use Tortoise SVN to create branch/tag and set the URL to http://dev.e-taxonomy.eu/svn/branches/taxeditor/3.0.11-SNAPSHOT
1. In eu.etaxonomy.taxditor.cdmlib, `mvn validate` to let maven copy the desired cdmlib jars.
1. Adapt the classpath to includethe desired cdmlib version in eu.etaxonomy.taxeditor.cdmlib
1. Open MANIFEST.MF in 'Plugin Manifest Editor'
1. Select 'Runtime' tab
1. In the "Classpath" section, remove the entries for cdmlib
1. Add the cdmlib jars with the desired version (e.g. 3.0.11-SNAPSHOT jars).