Setting up Eclipse

KalypsoBASE is a java application being developed with http://www.eclipse.org Eclipse. This article describes how to set up eclipse in order to start developing with KalypsoBASE.

Installation of Java and Eclipse

Download and install the current versions of

• Sun's JDK 6
• Eclipse 3.4 SDK

TODO sepcify distribution/package.. maybe we should add our own profile to yoxos?

Remark tip|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 <nowiki><path to="" your="" java="" 6="" sdk="">/bin/javaw.exe</path></nowiki> (required)
:kalypso MUST be started with a Java 6 SDK, else some of the ant-code generation will not work

;-data <nowiki><path to="" workspace="" directory=""></path></nowiki> (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.