Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "SMILA/Development Guidelines/How to set up integration environment"
(→WORK IN PROGRESS) |
(→Preconditions) |
||
Line 8: | Line 8: | ||
Here is the list of things that you will definitely need for developing SMILA components: | Here is the list of things that you will definitely need for developing SMILA components: | ||
#JDK 1.6 | #JDK 1.6 | ||
− | #Eclipse SDK - This howto was tested with [http://www.eclipse.org/downloads/packages/eclipse-classic-362/heliossr2 Eclipse 3.6.2] | + | #Eclipse SDK - This howto was tested with [http://www.eclipse.org/downloads/packages/eclipse-classic-362/heliossr2 Eclipse 3.6.2 (Helios)] and [http://www.eclipse.org/downloads/packages/eclipse-classic-37/indigor Eclipse 3.7 (Indigo)] (some details like bundle version numbers may be slightly different when using Indigo) |
#SMILA binary distribution | #SMILA binary distribution | ||
Revision as of 09:44, 23 September 2011
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.
Contents
Preconditions
Here is the list of things that you will definitely need for developing SMILA components:
- JDK 1.6
- Eclipse SDK - This howto was tested with Eclipse 3.6.2 (Helios) and Eclipse 3.7 (Indigo) (some details like bundle version numbers may be slightly different when using Indigo)
- SMILA binary distribution
Install the binary distribution
Just pick up the latest binary distribution of SMILA:
- nightly build - the following currently works only with the nightly build
- release 0.9 or higher - not yet available
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 let it create a new workspace at a location of your choice. Then you 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:
- Open Windows -> Preferences
- Window --> Preferences --> Plug-in Development --> Target Platform --> Add...
- Initialize the target definition with: Nothing --> Next
- Insert some sensible name (how about "SMILA", maybe? ;-)
- In the "Location" tab, click "Add"
- Select "Installation" --> Click "Next"
- In the "Location" slot, browse to your directory where you installed SMILA (do not press <Enter>)
- --> click "Finish"
- In the "Location" tab, click "Add" again
- select "Features" --> Click "Next"
- in the "Location" slot select "${eclipse_home}"
- select Features "org.eclipse.platform" and "org.eclipse.jdt"
- --> click "Finish"
- switch to "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"
- Set the new target platform active
- --> 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:
- Either checkout the contents of https://dev.eclipse.org/svnroot/rt/org.eclipse.smila/trunk/examples from our SVN repository into your workspace
- or download them as one package from http://build.eclipse.org/rt/smila/nightly/SMILA-integrator-examples.zip and unpack and import them into your workspace.
In the menu, open "Run" -> "Run Configurations" or "Debug Configurations" and you should find an entry "OSGi Frameworks" -> "SMILA". Select it and click "Run" or "Debug" and SMILA should start just like when started from the command line. The configuration of this SMILA instance is in your workspace in "SMILA.application/configuration".