SetupEclipse

Setting up Eclipse for Kalypso

Kalypso 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

• Oracle's JDK 7
• Eclipse 3.8 SDK

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

Starting Eclipse

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

-vm <path to your java 6 sdk>/bin/javaw.exe (required)

Kalypso MUST be started with the Java Developer Kit (JDK) (NOT the Runtime Edition (JRE)), else some of the ant-code generation will not work properly

-data <path to workspace directory> (optional)

use a distinquished workspace directory for your Kalypso sources

-vmargs -Xmx1024m

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:

Additionally required Eclipse-Plug-ins

Eclipse Plug-Ins

Name	Remark	Use	Source / Update Site
Subversive SVN Team Provider	Required to fetch Kalypso sources	Optional	Juno Update Site
Mylyn Team Support	For easy access to Kalypso Trac(s)	Optional	Juno Update Site
Eclipse XML Editors and Tools		Required	Juno Update Site
Babel Language Packs	Kalypso depends on Babel - Required packs: 'eclipse', xxx?	Required	http://download.eclipse.org/technology/babel/update-site/R0.11.0/juno/
KalypsoDevelopTools	Helper for exporting/importing i10n property files to and from excel	Optional	http://dev.bjoernsen.de/updatesites/KalypsoDevelopTools/
NatTable	Kalypso depends on NatTable	Required	http://download.eclipse.org/nattable/releases/1.0.1/repository/
NSIS	Eclipse NSIS - Setup Tool	Optional	http://eclipsensis.sf.net/update
UOMo	Eclipse UOMo -	Required	http://download.eclipse.org/uomo/0.6/repository/

Note: Features Kalypso has real dependencies on (i.e. are required to compile Kalypso) are marked as 'required'.

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...

Linux: before getting the sources, set the workspace encoding of eclipse to ISO-8859-1:

Menu: Window->Preferences...

Page General/Workspace

Text File Exncoding:Other ISO-8859-1

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 configure 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
• .ort
• _others_?

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