How to create a build

TOC(inline)

Checkout JOSM

Using Eclipse

• ​How to checkout a JOSM plugin into Eclipse.

Using command line tools

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

Create a build

To create a build run

ant clean
ant dist 

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

The standard 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)
Is-Local-Build	true. Indicates that this build isn't an "offical" release provided by josm.openstreetmap.de

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 for 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.