[FrontPage] [TitleIndex] [WordIndex

How to set up deegree 3 in Eclipse

1. Requirements

To create a working deegree 3 workspace in eclipse, make sure your system meets the following requirements:

2. git checkout

At first, clone the git repository.
You can choose the location of the checkout freely.
The later to be created workspace will be linked to the checkout directory (e.g. /home/user/d3-checkout).

We recommend to checkout the deegree 3 master via following console command:

Anonymous access

git clone git://github.com/deegree/deegree3.git

Developer access

git clone git@github.com:deegree/deegree3.git

3. Create a new Eclipse workspace

It is recommended to create a new workspace in eclipse.
There will be a lot of deegree modules listed in the chosen workspace.
If you don't mind that fact, you can use your existing workspace.

To create a new workspace open eclipse.

Afterwards select "File" ==> "Switch workspace" ==> "Other" ==> Select the new workspace path (e.g. /home/user/d3-workspace)==> Hit "Ok".
(Keep in mind that the workspace directory and the eclipse workspace are two different directories).

Close eclipse.

4. Prepare Maven project

Switch to your deegree 3 checkout directory (e.g. /home/user/d3-checkout/trunk).

Run the following command via console:

mvn eclipse:clean eclipse:eclipse eclipse:configure-workspace deegree:eclipse -Dwtpversion=2.0 -DdownloadSources=true -DdownloadJavadocs=true -Declipse.workspace=/home/user/d3-workspace/

Adjust the -Declipse.workspace property to match your chosen workspace. It is recommended have eclipse closed while this process takes place.

4.1. Explanation of the used Maven plugins and goals

5. Import project to Eclipse

Start eclipse.

That is it. You are done.

For better overview, it's recommended to configure some working sets (eg. d3-core) to group projects/modules.

6. Troubleshooting

If you still have a lot of errors in the project try the following steps:

mvn eclipse:clean eclipse:eclipse deegree:eclipse -Dwtpversion=2.0 -DdownloadSources=true -DdownloadJavadocs=true -Declipse.workspace=/home/user/d3-workspace/ 

7. The deegree maven plugin

The deegree3/Maven page has a more detailed explanation regarding the deegree maven plugin's capabilities and usage.


2018-04-20 12:05