Difference between revisions of "SetupEclipse"
Thomasjung (Talk | contribs) |
Gernotbelger (Talk | contribs) |
||
Line 4: | Line 4: | ||
Download and install the current versions of | Download and install the current versions of | ||
− | * [http://java.sun.com][Sun's JDK | + | * [http://java.sun.com][Sun's JDK 6] (use OpenJDK under Linux, with Sun's SDK Kalypso will freeze) |
− | * [http://www.eclipse.org][Eclipse 3. | + | * [http://www.eclipse.org][Eclipse 3.5.1 SDK] |
− | Tip: The installation path of eclipse should not contain any whitespace ' ', else some of the ant-scripts used to compile Kalypso will get into trouble. | + | Tip: The installation path of eclipse should not contain any whitespace ' ', else some of the ant-scripts used to compile Kalypso will get into trouble. |
==Starting Eclipse== | ==Starting Eclipse== | ||
Line 13: | Line 13: | ||
We recommend the following command-line options when starting eclipse: | We recommend the following command-line options when starting eclipse: | ||
− | ;-vm <nowiki><path to | + | ;-vm <nowiki><path to your java 6 sdk>/bin/javaw.exe</nowiki> (required) |
− | :kalypso <big>MUST</big> be started with | + | :kalypso <big>MUST</big> be started with the <big>Java Developer Kit (JDK)</big> (NOT the Runtime Edition (JRE)), else some of the ant-code generation will not work properly |
;-data <nowiki><path to workspace directory></nowiki> (optional) | ;-data <nowiki><path to workspace directory></nowiki> (optional) | ||
:use a distinquished workspace directory for your kalypso sources | :use a distinquished workspace directory for your kalypso sources | ||
− | ; -vmargs -Xmx1024m | + | ; -vmargs -Xmx1024m |
:Kalypso is quite big, give eclipse enough memory to handle all this stuff | :Kalypso is quite big, give eclipse enough memory to handle all this stuff | ||
Line 34: | Line 34: | ||
:::Tab <tt>Properties</tt> | :::Tab <tt>Properties</tt> | ||
::::Button:<tt>Add Property...</tt> | ::::Button:<tt>Add Property...</tt> | ||
+ | |||
+ | Linux: before getting the sources, set the workspace encoding of eclipse to ISO-8859-1: | ||
+ | |||
+ | :Menu: <tt>Window->Preferences...</tt> | ||
+ | ::Page <tt>General/Workspace</tt> | ||
+ | ::::Text File Exncoding:<tt>Other ISO-8859-1</tt> | ||
===ManualJRE (optional)=== | ===ManualJRE (optional)=== |
Revision as of 23:03, 26 November 2009
Kalypso is a java application being developed with Eclipse. This article describes how to set up eclipse in order to start developing with Kalypso.
Contents |
Installation of Java and Eclipse
Download and install the current versions of
- [1][Sun's JDK 6] (use OpenJDK under Linux, with Sun's SDK Kalypso will freeze)
- [2][Eclipse 3.5.1 SDK]
Tip: The installation path of eclipse should not contain any whitespace ' ', 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:
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...
- Tab Properties
- Page Ant/Runtime
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
- Page General/Workspace
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...
- Page: Java/Installed JREs
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
- Page: Generel/Content types
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.