Skip to content

Latest commit

 

History

History
45 lines (30 loc) · 3.1 KB

INSTALL.md

File metadata and controls

45 lines (30 loc) · 3.1 KB

I want to use the plugin

If you want to use the plugin the best way to start is to download the JOSM, navigate to preferences window → plugins and install the indoorhelper.

I want to work with the source code

Setup a local git-repository

git clone [email protected]:JOSM/indoorhelper.git
cd indoorhelper

Setup the development environment

For developing two IDEs are recommended: IntelliJ IDEA or Eclipse

Setup with IntelliJ IDEA:

First of all make sure the Java SE Development Kit 8 is installed on your local machine

  1. Download IntelliJ IDEA
  2. Open IntelliJ and import the indoorhelper plugin: File → Open → path/to/indoorhelper_folder
  3. You may need to set the current SDK: File → Project Strucuture → Project → Project SDK
  4. You may need to set indoorhelper/src as source folder and indoorhelper/test as test folder. This settings can be found under File → Project Strucuture → Modules (see also jetbrains#adding_content_root)
  5. After editing the src or test folder (in step 4.) you may need to add the dependencies to this modules again. In Project Structure... → Modules ...select the module and select tab Dependencies → + → Library ...add missing libraries
  6. Build the plugin using gradle (thanks to floschers gradle-josm-plugin!): Open the gradle toolbar under View → Tool Windows → gradle. Now you see already defined configurations. Use Tasks → build → build to build the plugin. Use Tasks → josm → runJosm to run the plugin with a clean JOSM instance. For more information see gradle-josm-plugin README.md

Troubleshooting IntelliJ IDEA

  • Check if correct SDK is set (see above 3.)
  • Check if folder src is set to src directory and if folder test is set to test directory (see above 4.)
  • Check if all dependencies are added properly (see above 5.)

Setup with Eclipse:

First of all make sure the Java SE Development Kit 8 is installed on your local machine

This tutorials use Ant to build the plugin. If you want to use gradle to build the plugin you will need to use a plugin.

Additional