Skip to content

Releasing

Jump to bottom
Marc Philipp edited this page Feb 15, 2015 · 35 revisions

Prerequisites

  • Maven 3
  • Ant 1.8.2
  • Subversion 1.6
  • Git

Steps

Document the release

  1. Check the Release Notes (in org.projectusus.documentation/Release Notes). Complete them if required. Commit & push.
  2. Determine the version number to release.
    You can look at the parent POM if you are unsure. If it says 0.7.3-SNAPSHOT the version number will most likely be 0.7.3.
  3. Create and push a git tag for the version, name it vA.B.C (replace A.B.C with the real version number): git tag -a vA.B.C -m "tag vA.B.C"

Build and append to update site

  1. In the repository root directory, execute mvn clean install.
    If some tests fail when run in Maven that work in Eclipse, blame Maven Tycho and run mvn clean install -DskipTests.
  2. Change into org.projectusus.updatesite and execute ant merge.
  3. Change into org.projectusus.updatesite/svn and execute svn status. If your Subversion client is newer than the one used by Ant run svn upgrade to upgrade the working copy and then call svn status.
  4. If everything looks good (i.e. plugins and features with the correct version number have been added), execute svn commit -m "Release A.B.C" (replace A.B.C with the real version number). (login: same as google account, password: see https://code.google.com/hosting/settings)

Ship release-only update site

  1. Go to org.projectusus.updatesite-latest and run mvn clean install. This will create a ZIP called org.projectusus.updatesite-latest-0.7.5-SNAPSHOT.zip in the target folder.
  2. Rename the file to org.projectusus.updatesite-latest-A.B.C.zip (replace A.B.C with the real version number).
  3. Create a new release on GitHub for the previously created tag.
  4. Upload org.projectusus.updatesite-latest-A.B.C.zip.

Spread the word

  1. Update the version in the Eclipse Marketplace.
  2. Send a tweet!

Prepare for next release

  1. Decide which version number the next release should have.
    Normally, this is simply done by incrementing the last part of the version number by one.
  2. Go back to org.projectusus.updatesite and run ant increment-versions -Dnew.version=A.B.D (replace A.B.D with the number of the next version you are going to work on).
  3. Commit and push the changed files to git: git commit -a -m "Release A.B.C"; git push origin master
  4. Celebrate!

Clone this wiki locally