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:
- Eclipse EE (Eclipse IDE for Java EE Developers )
- Oracle Java 1.6+ (JDK)
- Maven 3
2. SVN checkout
At first, check out the deegree SVN.
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 trunk via following console command:
Anonymous access
svn co https://wald.intevation.org/svn/deegree/deegree3/trunk/
Developer access
svn co svn+ssh://${USERNAME}@svn.wald.intevation.org/deegree/deegree3/trunk
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.
5. Import project to Eclipse
Start eclipse.
Select "File" ==> "Import" ==> "General" ==> "Existing projects into workspace" ==> Select your checkout directory ==> "Finish".
That is it. You are done.
6. Troubleshooting
If you still have a lot of errors in the project try the following steps:
- Delete the project
- Close eclipse
- Go to the checkout directory
Update SVN svn up
- Run
mvn eclipse:clean eclipse:eclipse deegree:eclipse -Dwtpversion=2.0 -DdownloadSources=true -DdownloadJavadocs=true -Declipse.workspace=/home/user/d3-workspace/
- Open eclipse
- Import the project again.