How to create a build

Checkout JOSM

Using Eclipse

Using command line tools

 $ cd ~/src
 $ svn co 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.


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 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}		

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 as tested or latest) are not publicly available. Please get in touch with current maintainer if you need more information.


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:

Repository:UUID: 0c6e7542-c601-0410-84e7-c038aed88b3b
Last:Changed Date: 2018-03-24 00:03:37 +0100 (Sat, 24 Mar 2018)
Build-Date:2018-03-24 02:34:21
Redirecting:to URL '':
Relative:URL: ^/trunk
  • 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 5 years ago Last modified on 2018-03-24T19:21:23+01:00