Skip to content

Latest commit

 

History

History
197 lines (134 loc) · 6.53 KB

RELEASES.md

File metadata and controls

197 lines (134 loc) · 6.53 KB

ImageJ2 uses several major components, each of which is released on its own development cycle.

Component releases are done using the SciJava release-version.sh script, which uses the maven-release-plugin to do some of the work. All releases are tagged in their respective Git repositories, with binary builds deployed to the ImageJ Maven repository.

SCIJAVA COMMON

SciJava Common provides the core plugin framework and application container.

cd scijava-common
release-version.sh 1.0.0
  • Where 1.0.0 is the new release version.

Optionally, after performing the release, tell Jenkins to update scijava-common.version in pom-scijava.

IMGLIB2

ImgLib2 provides the core data model and image processing.

cd imglib
release-version.sh 2.0.0-beta-7
  • Where 2.0.0-beta-7 is the new release version.

Optionally, after performing the release, tell Jenkins to update imglib2.version in pom-scijava.

SCIFIO

SCIFIO provides core I/O functionality.

cd scifio
release-version.sh 0.1.0
  • Where 0.1.0 is the new release version.

Optionally, after performing the release, tell Jenkins to update scifio.version in pom-scijava.

CPPTASKS-PARALLEL

CppTasks Parallel is used by the NAR plugin. We deploy unofficial release builds for use with the ImageJ launcher.

cd cpptasks-parellel
release-version.sh 1.1.1-scijava-1
git push scijava cpptasks-parallel-1.1.1-scijava-1
  • Where 1.1.1-scijava-1 is the new release version.
  • The -scijava-X qualifier indicates an unofficial release.
  • Note that release:prepare will be called in interactive mode.

NAR-MAVEN-PLUGIN

The NAR plugin is used to build the ImageJ launcher. We deploy unofficial release builds.

cd maven-nar-plugin
release-version.sh 3.0.0-scijava-1
git push scijava nar-maven-plugin-3.0.0-scijava-1
  • Where 3.0.0-scijava-1 is the new release version.
  • The -scijava-X qualifier indicates an unofficial release.
  • Note that release:prepare will be called in interactive mode.

Optionally, after performing the release, tell Jenkins to update nar.version in pom-scijava.

IMAGEJ LAUNCHER

The ImageJ launcher is a native launcher for ImageJ.

cd imagej-launcher
release-version.sh 2.0.0
  • Where 2.0.0 is the new release version.

Then, to deploy:

open http://jenkins.imagej.net/job/ImageJ-launcher/build

And build the newly pushed release tag; e.g., ij-launcher-2.0.0.

Optionally, after performing the release, tell Jenkins to update imagej-launcher.version in pom-scijava.

IMAGEJ

The following steps perform a release of ImageJ itself:

Use the latest version of ImageJ 1.x

Verify that the pom-scijava version used by ImageJ references the latest available version of ImageJ 1.x:

cd imagej
sj-version.sh | grep imagej1.version

If not, tell Jenkins to update imagej1.version in pom-scijava. Otherwise, uploading a new release to the update site will downgrade all ImageJ2 and Fiji users to an obsolete ImageJ 1.x version.

Tag a release candidate

cd imagej
release-version.sh --skip-push --skip-deploy --tag=temp 2.0.0-beta-7
git push origin temp
  • Where 2.0.0-beta-7 is the new release version.
  • The --tag=temp argument creates a temporary tag named temp, from which we will build the release candidate in the next step.

Build the release candidate

open http://jenkins.imagej.net/job/ImageJ-release-build/build

And specify the newly pushed temp tag.

Test the release candidate

  • Download the resultant application ZIP from Jenkins and perform desired tests.
  • Fix any critical bugs found on master
  • Delete the temp tag locally and remotely
  • Start the release process over again

Tag, build and deploy the actual release

cd imagej
release-version.sh 2.0.0-beta-7
  • Where 2.0.0-beta-7 is the new release version.

Update pom-scijava

Optionally, after performing the release, tell Jenkins to update imagej.version in pom-scijava.

Upload artifacts to the ImageJ update site

  • Unpack the application ZIP

  • Add upload information for the ''ImageJ'' update site:

    ./ImageJ-linux64 --update edit-update-site ImageJ http://update.imagej.net/ \
        <user>@update.imagej.net /home/imagej/update-site/

  • Simulate an upload (to make sure everything is correct):

    ./ImageJ-linux64 --update upload-complete-site --simulate ImageJ

  • If the upload will render files obsolete that Fiji still relies on, upload them to the Fiji site using the --force-shadow option:

    ./ImageJ-linux64 --update upload --force-shadow --site Fiji <file>...

  • When everything is alright, upload it for real:

    ./ImageJ-linux64 --update upload-complete-site ImageJ

Update web resources

  1. Create a blog post on the ImageJ web site. It should be modeled after a previous blog entry.

  2. Rename the artifact ij-app-XYZ-application.zip to imagej-XYZ.zip where XYZ is the release version number. Add it as an attachment to the post.

  3. Update the Downloads page.

  4. Send a release announcement to the mailing lists (ImageJ and imagej-devel). It should be an abbreviated version of the blog post, modeled after a previous release announcement.