This is the procedure for making a formal release of the uDig application; the goal here is to make a release that can be supported.

• we need to be able to check out the release from a tag
• all jar dependencies (such as GeoTools) must also be tagged and deployed

We only need to use this procedure when making:

• a Major release (such as uDig 2.0.0)
• a Minor release (such as uDig 1.1.0)
• a Patch release (such as uDig 1.1.3)

Related Information:

Prepair Product

Code Freeze

Send out a nice email kicking people out of the pool.

Prepare Help

1. Export Home into the net.refractions.udig.help plug-in following these instructions: Export Online Help
2. Commit!

Prepare Docs

1. Export the Home into the net.refractions.udig.docs plug-in
2. Commit

Tag Trunk

1. Make a folder under tags

   svn mkdir http://svn.geotools.org/udig/tags/[UDIG:releaseID]

2. svn copy trunk (or 1.1.x) to tag

   svn cp http://svn.geotools.org/udig/branches/1.1.x http://svn.geotools.org/udig/tags/1.1.0

Code Thaw

You can invite everyone back into the pool now.

Release Product

Prepare Jars Used by Libs

1. Change net.refractions.udig.libs over to use real jars; none of this 2.1.x or SNAPSHOT stuff.
   • Yes that means you may have to release Geotools
   • Yes that means taking the geoapi-SNAPSHOT.jar on the listserver and make a geoapi-yearmonthday.jar out of it.
     (You should open up the jar with zip before hand to see when the files inside were created).
   • Yes that means you need to upload your geotools-2.1.M# jars onto the listserver
2. Update build.properties (or copy.properties on trunk) with the correct version
3. Rename your repository so build.xml does not trip over it; and try refreshing libs

Update Version

1. Update Product version number
   • Update the about.mappings version number
2. Update plugin version numbers for changed plugins: plugin.xml or plugin.properties
   • Update a the revision number (0,#,0) if new functionality is available
   • Update a the patch number (0,7,##) for simple bug fixes
   • When making a full release the version number (#,0,0) will be changed on plugins.
3. Update version numbers on Features that have changed
   • feature.xml files (ie. change the Version)

Release and Test Application

1. uDig Export Procedure
2. Test the following:
   • Quickstart - check that it works at all
   • Walkthrough 1 - check basic functionality
   • Walkthrough 2 - check editing
3. SDK Export Procedure
   • 1 SDK Quickstart - to check if plug-ins have been exported
   • 2 Plugin Tutorial - to check if schema files have been exported
   • 3 Custom Application Tutorial - to confirm all RCP plug-ins are present

Note you may need to update the pdf files; they can be checked out from:

svn co http://svn.refractions.net/udig_training/trunk training

Prepare zip files and create Installers:

• Linux Instructions:
  For linux there is a export script in the repository to help automate the preparation process: http://svn.geotools.org/udig/trunk/scripts/releases. The scripts require WINE to be installed as well as NSIS.
  1. Unzip linux-jre.zip into the bin directory.
  2. Unzip win-jre.zip into the bin/win-installer directory.
  3. Set the NSIS_HOME environment variable
  4. Run the do_release.sh script
     • ./do_release.sh version-number udig_zip_directory
       The script will prompt you if it can't find the files it requires.
• Windows Instructions:

1. Create an installer using NSIS

Tell the World

Create Release Notes

Make the release in Jira:

1. Hit the big release button under Admin
2. Assign and leftovers to the next release

Note: You may need to give the items in the release notes a once over (so they reflect reality).

Create Download Page

1. Using the Release templates provided:
   • Create a child page of Downloads for major releases (like 1.1), and change Downloads to {include} your new page
   • Create a child page of UDIG 1.0 for stable releases, and change UDIG 1.0 to {include} your new page
2. Using the SDK template provided:
   • Create a child page of Source Downloads for your SDK release

For Latest Releases Ensure there is a disclaimer on RND downloads of these snapshots regarding known deficiencies and missing functionality.

Update Website

To update the links across the website:

Links for updating the above:
Latest Eclipse releases
Latest GEF releases
Latest EMF releases
Latest JRE releases
Latest JAI releases

Package up Eclipse Extras

#Package up all the resources needed beyond the base Eclipse SDK:

1. • the net.refractions.udig.doc - this plug-in contains updated developers instructions
   • EMF
   • GEF
   • Testing
   • Language Support
2. Create a zipfile of the extras-3.3 and upload here:

   extras-3.3.2.zip

We may be able to use an update site to publish documentation as it becomes available.

Announce

Here is a sample anouncement:

List of places that want to know ...

udig.refractions.net

1. Click Add News
2. News Title: UDIG 1.0.4 Released
3. Contents - allows wiki links

Freshmeat.net

1. http://freshmeat.net/add-branch/50237/
2. Branch: tba
3. Version: 1.0.4
4. Changes: Text Jira
5. You can also update the screen snapshot to reflectthe current uDig application.

Rich Clients

1. http://www.richclients.org/modules/news/

CodeHaus

We use jira, we can announce - anyone know how?

Email Lists

1. GeoTools: geotools-gt2-users@lists.sourceforge.net
2. UDIG: mailto:udig-devel@lists.refractions.net

You can also consider posting to the GeoServer release, especially when modifications have been made to Walkthrough 2 to match their current release.

Freegis.org

The http://freegis.org/ website is a nice list of GIS resources.

1. Send email to: jan@intevation.de
2. Subject: UDIG update for FreeGIS site
3. Text: as above

Java.net

The http://java.net/ website is a nice clearing house for java projects, Jody Garnett even has a blog there.

1. Submit a news article
2. Use form at: http://today.java.net/cs/user/create/n
3. Source: udig.refractions.net
4. URL: http://udig.refractions.net/
5. http://udig.refractions.net/confluence/display/UDIG/News
6. Note Membership required

Note you will of had to make the uDig news item first.

SlashGIS

Who knows if http://slashgisrs.org/ will be successful?

Programmer Sites

http://Eclipse.org

• Submit, they may actually decide to list us one of these days.

http://techforge.com/

• Not sure if we can submit News, as we are not on SF

http://www.eclipsezone.com/

• Try it how much can it hurt? A lot since they moved to Java Lobby

http://www.eclipse-plugins.info/eclipse/

• http://www.eclipse-plugins.info/eclipse/plugin_details.jsp?id=855