SMILA/Development Guidelines/How to set up integration environment

This how-to describes the necessary steps for setting up SMILA integration environment. Normally this setup is only interesting for SMILA integrators who just want to integrate their components in SMILA. SMILA committers and contributors should work with another setup described at How to set up the development environment.

Install the binary distribution

Simply unzip the file you downloaded into a new directory on your local hard disk and you've done with the installation.

Create a new Workspace and setup target platform

Start your Eclipse SDK and create a new workspace at a location of your choice. Then use the SMILA binaries as the target platform for plugin develoment. This enables you to create own bundles that can use the code in the SMILA bundles:

To set up the target platform

Open "Windows" -> "Preferences".

Select "Plug-in Development" --> "Target Platform" --> "Add".

Initialize the target definition with: "Nothing --> Next".

Enter a reasonable name (how about "SMILA", maybe? ;-).

In the "Locations" tab, click "Add".

Select "Installation" --> Click "Next".

Click "Browse" and navigate to the directory where you installed SMILA (do not press <Enter> yet).

--> Click "Finish".

Back on the "Locations" tab, click "Add" again.

Select "Features" --> Click "Next"

In the "Location" text field enter "${eclipse_home}" (without parentheses).

Select the features "org.eclipse.jdt" and "org.eclipse.platform".

--> Click "Finish"

Switch to the "Content" tab:

Filter for "junit" and deselect the bundles "org.junit (4.8.1)" and "org.junit4 (4.8.1)". Only "org.junit (3.8.2)" must be selected.

--> Click "Finish"

Select the new target platform.

--> Click "OK", you're done.

Create a launch configuration for SMILA

Getting right the launch configuration for SMILA is a bit tedious, so we prepared an example package: