Menu Content/Inhalt
Startseite arrow First steps
First steps Drucken

Before beginning

If you'd like to develop for Elexis, we ask you to follow a few rules as described here.

To begin, prepare your build environment as described below. In the Developer-Menu at the left lower side, you'll find more informations on specific topics that might be useful.

Prerequisites

  1. If you don't have java installed on your PC already, go to Sun and download the latest J2SE-JRE or J2SE-SDK for your operating system (at least 1.5/5.0).
  2. Go to Eclipse and get the latest version of the "eclipse sdk" for your operating system (Version 3.2.0 or newer)
  3. Get the subversion plugin for eclipse: Follow the instructions here: http://subclipse.tigris.org/install.html
  4. Go to OpenOffice.org and get the latest version for your operating system. At least v2.0 is required.

Checkout the sources

  1. In Eclipse, open the menu  "window - open perspective - other". Select "SVN repository exploring" and click "OK".
  2. Right-click in the left pane and choose "new - Repository location".
  3. Enter the following location URL: https://elexis.svn.sourceforge.net/svnroot/elexis/trunk
  4. Open that newly created location, and you'll see all Projects that constitute elexis. We recommend to check out all projects you see there: Select them all, right-click and choose "checkout".
  5. The first checkout of all sources will take quite a long time (up to 15 Minutes), independend of the connection speed.

Prepare the Eclipse environment

The Elexis sources are encoded as utf-8 (8-Bit-unicode), to be compatible with all types of operating systems.  therefore, your development environment must  use the same encoding.  In Eclipse, choose the Menu "window-preferences-general-workspace", and there "Text File encoding". Select "UTF-8".

Next, in the same preferences dialog, find the "Java - Compiler" page and make sure that the compiler compliance level is set at least to 5.0. Then click "Apply"

Possibly, eclipse will complain about "build path errors". In that case, right-click on the elexis-project and select "PDE-Tools - Update classpath". Then, in the Main menu, select  "Project - clean..", and then "Clean all". Eclipse will recompile all projects and the errors should be solved.

Create run configuration

In Eclipse, open the Menu "Run - run...". Right-click on "Eclipse application" and select "New". The following dialog will appear:

Run configuration, page 1

Choose "run a product" and select ch.elexis.ElexisProduct. Go to (x) Arguments.You'll see the following dialog: 

 

run configuration page 2

For the program arguments, you can select the desired language, fr for the french, de for the german version. If you omit this entry, the language will be determined from your system settings.

In the VM arguments, you should insert the path to the "program" subdirectory of your OpenOffice installation. In Linux, this might rather be an entry like /usr/lib/ooo-2.0/program.


Finally, go to the "Plug-ins" tab:

run configuration page 3

First, choose "deselect all". Then, in the upper part, "Workspace plug-ins", select the elexis main plugin and all plugins you want to include in the launch (we recommend to select all of the workspace plug-ins). Then, click "add required plugins" which will select from the bottom part "target Platform" only those elements that are required for the launch. Finally, click on "validate plug-in Set and push "Apply". Then your run configuration should be ready.
 
[ Zurück ]