Skip to content

Setting up deegree3 in your IDE

Jump to bottom
Jeronimo Wanhoff edited this page Nov 23, 2013 · 27 revisions

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

Eclipse

Tested version: Eclipse EE 4.3.1

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

  • Clone the deegree3 repository in a separate directory (NOT into your Eclipse workspace)
  • Create the .project files for Eclipse using 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] (wiki/Building-deegree3) for details.

Note that you shouldn't clone directly into Eclipse's workspace directory, but into a different folder. Otherwise, the import step may fail, as Eclipse will not recognize the modules correctly.

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

This command will create Eclipse .project files for every deegree module and also apply several settings (e.g formatters) to your Eclipse workspace. You need to adapt the eclipse.workspace parameter to point to your Eclipse workspace directory.

Import the deegree3 clone directory

In Eclipse, select "File" -> "Import..." -> "Existing Projects into Workspace" -> "Next". Click "Browse..." and select the deegree3 clone directory. Click "OK" and "Finish". It will take a moment, but after a while, you should have all deegree3 modules compiled in Eclipse without any errors.

It's also easy to run deegree-webservices inside Eclipse: Right click on the "deegree-webservices" project and select "Run As" -> "Run on Server".

Netbeans

IDEA

Clone the deegree3 repository

Import the deegree3 project sources

If you use IDEA it is quite simple to import the sources: In the IDE 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 IDEA. So the easiest way is possibly to import the eclipse formatter settings using the eclipse formatter plugin [1]. Download the plugin, install it, download the deegree formatter configuration file for eclipse [2] and import the settings.

[1] https://code.google.com/p/eclipse-code-formatter-intellij-plugin/downloads/list?can=1&q=

[2] http://wiki.deegree.org/deegreeWiki/Eclipse?action=AttachFile&do=get&target=deegree-style.xml

Clone this wiki locally