Changes between Initial Version and Version 1 of DevelopersGuide/CreateBuild

Timestamp:

2009-11-01T09:10:01+01:00 (16 years ago)

Author:

Gubaer

Comment:

--

DevelopersGuide/CreateBuild

@@ +1 @@
+= How to create a build =
+
+[[TOC(inline)]]
+
+== Checkout JOSM ==
+=== Using Eclipse ===
+
+ * [http://www.youtube.com/watch?v=Z3OjG3nDvzA 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. 
+
+