Building deegree3

tfr42 edited this page Sep 7, 2018 · 29 revisions

This page describes how to build deegree3 from the command line.

System requirements

Cloning the deegree3 repository

First, you will need to clone the deegree3 repository. On the command line, change to a suitable directory and enter:

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

You'll probably want to fork the deegree3 repository and clone your fork instead (just replace the deegree part with your GitHub username).

Choosing the version to build

Now, change to the deegree3 directory and check out the version that you want to build, e.g.

git checkout 3.3-master

Hint: Use git checkout master to get the latest development version. Use git tag to find out all tags (versions) that can be checked out. The following command shows the list of all tags:

git tag | grep "^deegree-[0-9].*\|^[0-9]." | sort

Pick a tag and enter:

git checkout tags/deegree-3.4-RC2

Invoking Maven

Invoke Maven to start the build process:

mvn install

This will build deegree-webservices and all dependent deegree3 modules. You can find the deegree-webservices artifacts in deegree-services/deegree-webservices/target.

List of Maven profiles

The are several Maven profiles available to modify the build process, e.g. use

mvn install -Poracle,mssql

to enable support for Oracle Spatial and Microsoft SQL Server.

Here's a full list of available Maven profiles:

  • handbook: builds the deegree webservices handbook
  • integration-tests: runs integration tests (these take a couple of minutes)
  • mssql: builds the MSSQL Server SQL dialect
  • oracle: builds the Oracle SQL dialect

To show all available profiles use

mvn help:all-profiles | grep 'Profile Id' | sort -u

Running integration tests

In order to check if your code changes compile correctly and do not break any existing functionality, perform a clean build and run the integrations tests:

export MAVEN_OPTS="-XX:MaxPermSize=128m" (Linux/Mac)
SET MAVEN_OPTS="-XX:MaxPermSize=128m" (Windows)
mvn clean install -Pintegration-tests

Building API documentation with JavaDoc

To build the API documentation run:

export MAVEN_OPTS="-Xmx2g -XX:MaxPermSize=1g" (Linux/Mac)
SET MAVEN_OPTS="-Xmx2g -XX:MaxPermSize=1g" (Windows)
mvn javadoc:javadoc
# or to build the complete Maven site:
mvn site 

To deploy the site use:

mvn site-deploy

How to setup your IDE

Proceed with setting up deegree local working copy in your IDE.

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.