Release Procedure

Prepare source code for release

• Check out all projects from scratch.
• Update copyright remarks to the current year (e.g. 2003-2011) if necessary:
  • All *.java files
  • header-template.txt in qpe.base
• Update version specifiers to new version:
  • META-INF/MANIFEST.MF in following projects:
    • qpe.base
    • qpe.simqpn.kernel
    • qpe.simqpn.ui
  • /qpe.base/qpe.product
  • In file /qpe.simqpn.kernel/src/de/tud/cs/simqpn/kernel/Simulator.java adapt value of constant QPME_VERSION
  • Update welcome page
• Run regression tests and watch out for significant deviations in the results.
• Commit changes to svn.

Check IP compliance

• All sourcecode files should have the standard header with reference to the EPL and a current copyright statement
• For each third-party library check:
  • The library sourcecode is available in redistributable_libraries/sources
  • A copy of the license file of each library is available in redristributable_libraries/licenses
  • The file redristributable_libraries/README.txt is update accordingly
  • In each third-party library project the corresponding license file is available

Update subversion

• Check in all changes
• Create a tag for the new release in the subversion repository

Update User Documentation

• Update version specifier.
• Include descriptions for new features.

Create distributions

• Binary distribution
  • Install RCP delta pack. See here for details how to install it.
  • In Eclipse call Export/Plug-in Development/Eclipse product
    • Configuration: /qpe.base/qpe.product
    • Root directory: qpme
    • Deselect generate metadata repository
    • Select export for multiple platforms
  • Export product for following platforms:
    • Linux gtk x86
    • Linux gtk x86_64
    • MacOS cocoa x86
    • Win32 x86
  • Delete jre directory in Win32 export (if existing).
  • Copy following files and folders to the qpme folder in each platform folder.
    • change_logs/QPME_ChangeLog.txt
    • README.txt
    • version.txt
    • examples/
    • licence/
    • doc/ (without theses subfolder)
    • redistributable_libraries/ (without sources subdirectory)
    • sources/qpe.simqpn.kernel/SimQPN.bat
    • sources/qpe.simqpn.kernel/SimQPN.sh
  • Rename qpme subfolder of each platform folder to qpme-[version]-[win|linux-x86|linux-x86_64|macos]
  • Zip the qpme-[version]-[win|linux-x86|linux-x86_64|macos] subfolder of each platform folder to an archive of the same name.
  • Install distributions on a windows, linux and macos computer and check that they are starting correctly.
• Source distribution
  • Create an export of the sources subfolder from the subversion repository to a folder named qpme-sources
  • Add following files and folders to the qpme-sources folder:
    • change_logs/QPME_ChangeLog.txt
    • README.txt
    • DEVELOPMENT.txt
    • version.txt
    • examples/
    • licence/
    • doc/ (without theses subfolder)
  • Zip qpme-sources folder to archive with the same name

Update sourceforge information

• Add new artifact group named "Version x.x" to bugs tracker.
• Add new artifact group for the next version to the task tracker.
• Upload binary and source archives to sourceforge
  • Details on how to do this follow.

Release Announcement

• Create change-log
• Create Entry in Release Announcement forum thread.
• Publish news item on descartes and qpme site.
• Send a release announcement e-mail to the qpme mailing list.