Changes between Version 24 and Version 25 of DevelopersGuide/Compiling

Timestamp:

2018-06-01T21:47:13+02:00 (8 years ago)

Author:

michael2402

Comment:

Note about requirement to build with ant once before using eclipse + gradle build instructions

DevelopersGuide/Compiling

@@ -16 +16 @@
 === Compiling using Eclipse ===
 
+You need to have `ant` installed on your system.
+
 Download and install Eclipse: https://www.eclipse.org/
 
@@ -22 +24 @@
 You will have problems compiling, due to problems compiling Mappaint MapCSS with a fresh install of Eclipse. First you will need the [http://www.engr.mun.ca/~theo/JavaCC-FAQ/javacc-faq-moz.htm JavaCC] [http://eclipse-javacc.sourceforge.net/ plugin for Eclipse]. To install it in Eclipse, go to Help->New Software... then add the site [http://eclipse-javacc.sourceforge.net/] as a source, and install the JavaCC Eclipse Plug-in. Then in the Package Explorer, expand org.openstreetmap.josm.gui.mappaint.mapcss, right-click on MapCSSParser.jj, and "Compile with JavaCC". This should put new java files in a package called org.openstreetmap.josm.gui.mappaint.mapcss.parsergen, but if it doesn't, you will have to create the package manually (right-click and create package), then drag the new files into the package you just created (they should be easy to identify based on the light gray text that denotes it was compiled from MapCSSParser.jj). This should resolve any import issues in MapCSSStyleSource.java, and you should now be able to compile JOSM.
 
+Before being able to run JOSM from eclipse, you need to compile the project using `ant epsg-compile` one time. Otherwise, you will get a resource not found error on startup.
+
 If you try to compile the JOSM sources in Eclipse and get errors like "The method marktr(String) is undefined for the type SomeType" look at [https://lists.openstreetmap.org/pipermail/josm-dev/2008-August/001585.html solution suggested at mailing list].
 
 There are also two Videos available at youtube, which show [https://www.youtube.com/watch?v=-LoWGf-hqiQ how to checkout JOSM into Eclipse] and [https://www.youtube.com/watch?v=Z3OjG3nDvzA how to checkout a JOSM plugin into Eclipse].
+
+=== Compiling using Gradle + Eclipse ===
+
+Not officially supported.
+
+1. Delete `.settings`, `.project`, `.classpath` files/dirs
+2. Download the zip file with the gradle build files form #8269 and extract it into your JOSM directory.
+3. Then in eclipse, go to `File` -> `Import` -> `Existing Gradle project` and select the JOSM directory.
+
+You can start JOSM using the `run` target of gradle (found in the `Gradle Tasks` view).
 
 === Compiling using Netbeans ===