How to create a build

Checkout JOSM

Using Eclipse

• ​How to checkout a JOSM plugin into Eclipse.

Using command line tools

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

Revision	The JOSM version of your local snapshot. This is equal to the SVN revision of your local snapshot.
Build-Date	The date the distribution was created (YY-MM-DD HH:mm:ss)
Build-Name	For custom standard builds - gives identification of build agency (e.g. Debian)
Is-Local-Build	true. 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 https://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:

URL:https://josm.openstreetmap.de/svn/trunk
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
Revision:13554
Redirecting:to URL 'https://josm.openstreetmap.de/svn/trunk':
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