This page is work in progress while we're conducting the current release and updating the old ToDo list for the new release process. |
So it's time for a release again, is it? Well, you're in for quite a bit of work to ensure everything's in order. But fear not – this handy guide will help you find your way through the daunting but important pile of steps you'll have to wade through on your way to releasing the next version of KIELER. So, as usual, go and help yourself to a nice cup of tea or coffee and start...
Follow this list and be rewarded by a smoothly running release process.
MANIFEST.MF
and pom.xml
files. To that end, take a look at the changes performed on each one of them since then. For the moment, we'll leave the major version number (the first number) alone. If there have been breaking API changes (a method added to a public interface, changed public method signatures, removed public methods, that sort of thing), you will want to increase the minor version number (the second number). If there were any changes that didn't break the API, increase the revision number (the third number). There is one other case for changing the minor version number: if an important dependency has changed. For instance, regenerating Xtend-based code with a new version of Xtend will justify increasing the minor version number. If the dependency only concerns a KIELER component, however, increasing the revision number will suffice. In such cases, we just assume that users will update the plugin on which we depend anyway.feature.xml
and pom.xml
files. The concrete part of the version number to be increased depends on the version number increases of plug-ins included in the feature.feature.xml
and pom.xml
files. You might easily forget that since we don't have working Eclipse projects for our source features at the moment. You will have to manually navigate to the source features and change their version numbers from outside Eclipse.kieler.product
(part of the core.product
plugin) and kwebs.product
(part of the kwebs.server
plugin). Open both inside Eclipse and update the version numbers of the features they include. Once you're finished, the product files have to be made available to the build system. Copy kieler.product
to build/de.cau.cs.kieler.repository
and copy kwebs.product
to build/de.cau.cs.kieler.kwebs.repository
.category.xml
files in the KIELER and KWebS update site folders (build/de.cau.cs.kieler.repository
and build/de.cau.cs.kwebs.repository
, respectively).feature.xml
file and is best done through mass search & replace.compositeArtifacts.xml
and compositeContent.xml
. These two files are in /home/kieler/public_html/updatesite
./home/kieler/public_html/files
.