SetupEclipse

KalypsoBASE is a java application being developed with Eclipse. This article describes how to set up eclipse in order to start developing with Kalypso.

Installation of Java and Eclipse

Download and install the current versions of

• [1][Sun's JDK 5]
• [2][Eclipse 3.3 SDK]

Tip: The installation path of eclipse should not contain any whitespace ' ', else some of the ant-scripts used to compile KalypsoBase will get into trouble.}}

Starting Eclipse

We recommend the following command-line options when starting eclipse:

-vm <path to you rjava 5 sdk>/bin/javaw.exe (required)

kalypso MUST be started with a Java 5 SDK, else some of the ant-code generation will not work

-data <path to workspace directory> (optional)

use a distinquished workspace directory for your kalypso sources

-vmargs -Xmx1024m -Xxxxx TODO add permgen stuff here (optional)

Kalypso is quite big, give eclipse enough memory to handle all this stuff

Configure Eclipse

In order to be able to compile kalypso, eclipse should be configured as follows:

workspace_loc (required)

In order make the ant-scripts compiling parts of kalpyso work, the ant-property

workspace = ${workspace_loc}

must be defined via

Menu: Window->Preferences...

Page Ant/Runtime

Tab Properties

Button:Add Property...

ManualJRE (optional)

In order to build the DocBook manuals of Kalypso, a 1.4.2 JRE named 'ManualJRE' must be defined under

Menu Window->Preferences...

Page: Java/Installed JREs

Button Add...

Network connections (optional)

Do not forget to confugure your network connections via

Menu: Window->Preferences...

Page General/Network connection

in order to use the help system or install additional eclipse features.

XML-Files (optional)

Define kalypso specific file extensions as xml content via

Menu: Window preferences...

Page: Generel/Content types

Entry: XML

Add the following extensions:

• .gml
• .gft
• .gmt
• .gtt
• .ott
• .odt
• .kod
• .sld
• _others_?

You should do this right now, as changing anything here later will result in a complete rebuild of kalypso.