Eclipse: Set up project and example extension from git sources

Download and install eclipse (if not already available)

Download and unzip from

https://www.eclipse.org/downloads/packages/

either

Package for Enterprise Java and Web Developers

Package for Java Developers

each will do fine for OJ development

All the below was tested with eclipse version 2024.06.

Import into eclipse IDE

NOTE: The file system paths below are for windows but can analogous be some unix/linux/mac paths.

1. Start the eclipse application
2. Create and open a new workspace e.g. C:\workspace-OpenJUMP
3. File > Import...
   1. Git > Projects from Git (with smart import) ; Next>
   2. Clone URI ; Next>
   3. enter URI https://github.com/openjump-gis/openjump.git ; Next>
   4. make sure at least branch main is selected ; Next>
   5. choose a location for the project folder e.g. C:\workspace-OpenJUMP\OpenJUMP ; Next>
   6. eclipse will now clone the git repository into the project folder
4. Import Projects dialog pops up
   1. Folder OpenJUMP should be preselected Import as Maven
   2. Finish>

eclipse should now build the maven project without errors (warnings can be ignored)

Create a run configuration

When the project builds fine you will need to provide some information to be able to run OJ directly from the built project.

1. Run > Run Configurations...
   1. Right click Java Application on the left side ; Select New Configuration
   2. change Name above tabs from
      New Configuration
      to
      OpenJUMP
   3. tab Main
      1. make sure Project is
         OpenJUMP
      2. add Main Class
         com.vividsolutions.jump.workbench.JUMPWorkbench
   4. tab Arguments
      1. add Program arguments
         -default-plugins scripts\default-plugins.xml -extensions-directory "lib\ext" -extensions-directory "target\lib.ext.core" -extensions-directory "target\lib.ext.plus" -I18n en_US -v info
         NOTE: you can
         change the language/region with the parameter -I18n or
         raise the log verbosity to debug with -v or
         remove -extensions-directory "target\lib.ext.plus" to simulate OJ CORE
      2. add VM arguments
         -Djava.system.class.loader=com.vividsolutions.jump.workbench.plugin.PlugInClassLoader
   5. save configuration with button Apply (bottom right)
   6. run configuration with button Run (bottom right)

eclipse should now start OJ