Skip to content

Setting up deegree3 in your IDE

deegree-ci edited this page May 1, 2019 · 27 revisions

This page describes how you can load the deegree sources into your favorite IDE.

Eclipse

Tested version: Eclipse EE 4.3.1

NOTE: Currently, it is not recommended to use the m2eclipse builder with deegree3 -- it chokes on the number of modules and not all Maven plugins used by deegree3 are supported. Therefore, the recommended workflow to get deegree3 working in Eclipse is:

  • Clone the deegree3 repository
  • Run Maven's Eclipse plugin
  • Import the deegree3 clone directory in Eclipse

Clone the deegree3 repository

First, clone the deegree3 repository to a local directory and check out the version that you want to work on. See Building deegree3 for details.

NOTE: Don't use m2eclipse functionality like "Checkout Maven Projects from SCM" or "Materialize Maven Projects from SCM" for cloning. It would automatically activate the m2eclipse builder.

Run Maven's Eclipse plugin

On the command line, change to your clone directory and run the following command (you need to have Apache Maven 3 installed):

mvn eclipse:clean eclipse:configure-workspace eclipse:eclipse deegree:eclipse -Declipse.workspace=/home/kelvin/workspace -Dwtpversion=2.0

NOTE: You need to adapt the eclipse.workspace parameter to point to your Eclipse workspace directory.

The command will create Eclipse config files (.classpath, .project, .settings) for all deegree modules and also apply several settings (e.g formatters) to your Eclipse workspace.

Import the deegree3 repository directory

In Eclipse, select "File" -> "Import..." -> "Existing Projects into Workspace" -> "Next". Click "Browse..." and select the deegree3 repository directory. Click "OK" and "Finish". After a while, you should have all deegree3 modules compiled in Eclipse without any errors.

If you want to run deegree-webservices inside Eclipse: Right click on the "deegree-webservices" project and select "Run As" -> "Run on Server".

IntelliJ IDEA

Clone the deegree3 repository

First, clone the deegree3 repository to a local directory and check out the version that you want to work on. See Building deegree3 for details.

Import the deegree3 project sources

In IntelliJ IDEA, navigate to "File" -> "Import Project", choose the folder containing the deegree sources and click on "okay". In the next window choose "Import Project from external model" and "maven". The next window does not need any configuration and the import should start after clicking on "finish".

Use the deegree3 formatter

At the moment the deegree project provides no formatter settings for IntelliJ IDEA. So the easiest way is possibly to import the Eclipse formatter settings using the eclipse formatter plugin. Download the plugin, install it, download the deegree formatter configuration file for eclipse and import the settings.

Clone this wiki locally