wiki:DevelopersGuide/CreateBuild

How to create a build

Checkout JOSM

Using Eclipse

Using command line tools

 $ cd ~/src
 $ svn co http://josm.openstreetmap.de/svn/trunk josm
 ''tons of output here''

Creating a custom build

To create a build run

ant clean dist

This will create josm-custom.jar in the directory ./dist.

The REVISION file

If you build JOSM with JOSMs build.xml the distribution includes a file REVISION. REVISION is a collection of name/value-pairs, formatted in RFC822-style (i.e. name: value).

RevisionThe JOSM version of your local snapshot. This is equal to the SVN revision of your local snapshot.
Build-DateThe date the distribution was created (YY-MM-DD HH:mm:ss)
Build-NameFor custom standard builds - gives identification of build agency (e.g. Debian)
Is-Local-Buildtrue. Indicates that this build isn't an "offical" release provided by josm.openstreetmap.de or another approved organization

Adding custom release information

If you maintain a specific JOSM distribution (i.e. for Ubuntu or any other Linux flavor) you may want to modify the REVISION file.

Update the ant target create-revision in build.xml according to your needs:

<echo file="${build.dir}/REVISION">
# automatically generated by JOSM build.xml - do not edit 			
Revision: ${version.entry.commit.revision}
Is-Local-Build: true
Build-Date: ${build.tstamp}		
</echo>		

Please always include an attribute Revision. Otherwise, JOSM may fail to detect dependencies to particular versions of plugins.

Creating a standard build

The scripts to create an "official" JOSM build (i.e. one of the builds published on http://josm.openstreetmap.de as tested or latest) are not publicly available. Please get in touch with current maintainer if you need more information.

The REVISION file

Currently, the build build procedures for a standard build generates a REVISION file too. Here's an example from one of the more recent JOSM builds:

Path: trunk
URL: http://josm.openstreetmap.de/svn/trunk
Repository Root: http://josm.openstreetmap.de/svn
Repository UUID: 0c6e7542-c601-0410-84e7-c038aed88b3b
Revision: 2255
Node Kind: directory
Last Changed Author: Gubaer
Last Changed Rev: 2255
Last Changed Date: 2009-10-07 21:25:15 +0200 (Wed, 07 Oct 2009)
  • the absence of Is-Local-Build indicates that this is an "official" build
  • note that Revision again denotes the SVN revision

Back to Developers Guide

Last modified 19 months ago Last modified on 2015-10-11T13:34:48+02:00