# Delta Pack - for some parts of the setup you are advised to add a "Delta Pack" to an Eclipse SDK installation. You can download it from the [http://download.eclipse.org/eclipse/downloads/drops/R-3.7.1-201109091335/index.php same page].

+

−

==== Getting the source code ====

+

==== Getting the source code ====

−

There is more than one way of getting the code into your Eclipse workspace. In the next two sections, two recommended ways are shown. After having imported the source code into your workspace, it will show up a lot of errors. Don't worry, they'll disappear when you run through all steps of this HowTo.

+

There is more than one way of getting the code into your Eclipse workspace. The following sections will describe how to get the source code via SVN (recommended!).

−

Both methods descibed below will lead you to the same result: They will provide you with a workspace containing all core SMILA projects (plus <tt>SMILA.releng</tt> when you choose the ''Project Set File'').

+

As an alternative, you could download the complete source code from the [http://www.eclipse.org/smila/downloads.php release download page] or the [http://build.eclipse.org/rt/smila/nightly/ nightly build downloads] and unpack the archive into your workspace.

−

===== Getting the source code manually =====

+

===== Installing SVN Provider =====

+

''(skip this section if SVN Team Provider is already installed in your eclipse IDE)''

−

Getting the source code manually without the ''Project Set File'' is the recommended practice, especially when you wish to update frequently.

* Select the Subversive SVN Connector that you wish to use. We suggest to take the latest SVN Kit that is offered. At the time of writing it was SVN Kit 1.3.5.

−

#Use your favorite SVN client to check out SMILA's source code from the repository located at:<br> <tt>http://dev.eclipse.org/svnroot/rt/org.eclipse.smila/trunk/core</tt> <br> '''Hint:''' ''We recommend to check out the {{code|trunk/core}} as opposed to importing the projects through IDE SVN integrations. By doing so, you can easily get new projects just by updating your working copy and reimporting the sources.''

+

===== Get source code from SVN =====

−

#After having checked out the source code, import it into your workspace:

#*Select the root folder of the local trunk --&gt; (all projects should be selected automatically) --&gt; ''Finish''.

+

−

===== Using the Project Set File to get the source code =====

+

There are two ways for this, automatically by using the ''Project Set File'' or manually. Both are described in the following:

−

If you do not want to check out the source files manually, you can use the provided ''Project Set File'' (.psf) to check out and import all projects automatically.<br>

+

''Manually checking out and importing the projects into eclipse afterwards:''

+

* Use your favorite SVN client (''except the eclipse SVN client'') to check out SMILA's source code from the repository located at:<br> <tt>https://dev.eclipse.org/svnroot/rt/org.eclipse.smila/trunk/core</tt>. If you later want to be able to build a SMILA distribution, all SMILA projects should be located in the same directory.

::'''Note:''' ''The upside of doing so is that you can easily get new projects just by updating your working copy and reimporting the sources into eclipse. Removed projects will be deleted on update. Eclipse will indicate this to the user by displaying an empty project.''

::'''Hint:''': ''New projects should always be added to the .psf file so you can import them (as before): right click on .psf file and click on "Import Project Set...", be sure to click "No To All" to the question whether to overwrite existing projects in the workspace, otherwise it will check out everything again instead of ignoring the projects, that are already checked out. If projects are removed you have to remove them manually from the workspace, this can't be handled via .psf file.''

#Click ''Finish''.<br>Now your IDE starts to download and import the SMILA projects. This will take quite a while.

+

−

'''Hint:''' ''When you want to reimport the .psf file (e.g. because there are new projects available in the SMILA core repository), you have to update the .psf file in the <tt>SMILA.releng</tt> project and import it (right click on it and click on "Import Project Set...", be sure to click "No To All" to the question whether to overwrite existing projects in the workspace, otherwise it will check out everything again instead of ignoring the projects, that are already checked out.''

+

After having imported the source code into your workspace, it will show up a lot of errors. Don't worry, they'll disappear after the next steps below.

−

+

−

===== Enabling the BPEL Designer =====

+

−

+

−

If you want to work with the SMILA extensions for Eclipse BPEL designer, you need to check out the bundles from <tt>trunk/tooling</tt>. Currently, the required bundles are:

+

−

+

−

*<tt>org.eclipse.smila.processing.designer.model</tt>

+

−

*<tt>org.eclipse.smila.processing.designer.ui&lt;/tt&gt;</tt>

+

−

+

−

To compile them you need additional bundles from the [http://www.eclipse.org/bpel Eclipse BPEL Designer] in your target platform. See [[SMILA/BPEL Designer]] for more information.

+

==== Defining the target platform ====

==== Defining the target platform ====

−

The target platform defines the set of bundles and features that you are developing against.

+

The target platform defines the set of bundles and features that you are developing against. SMILA ships a ''Target Definition File'' that you can open in your IDE to configure the target platform automatically. This file contains all the references needed for developing SMILA with Eclipse Juno (Release 4.2).

−

===== Defining the target platform the easy way =====

+

===== Using the target platform provided by SMILA =====

−

SMILA ships a ''Target Definition File'' that you can open in your IDE to configure the target platform automatically. This file contains all the references needed for developing SMILA with Eclipse Indigo SR1 (3.7.1):

* Open the file <tt>SMILA.releng/devenv/SMILA.target</tt> with the ''Target Definition'' editor. <br>Eclipse starts downloading the referenced bundles/features which it tells you by stating "Resolving Target Definition" in its status bar. Be patient, this will take quite a while. After it has finished, you can click the link "Set as Target Platform" on the top right of the ''Target Definition'' editor. Doing so will cause Eclipse to start re-compiling the sources and all error markers should be gone when finished.

−

#If the <tt>SMILA.releng</tt> project is not already contained in your workspace (e.g. because you have chosen the manual way to check out and import the source files), check out [http://dev.eclipse.org/svnroot/rt/org.eclipse.smila/trunk/releng http://dev.eclipse.org/svnroot/rt/org.eclipse.smila/trunk/releng] with your preferred SVN client and import the project into your workspace.<br>

+

===== Defining the target platform manually =====

−

#Open the file <tt>SMILA.releng/devenv/SMILA-indigo-SR1.target</tt> with the ''Target Definition'' editor. <br>Eclipse starts downloading the referenced bundles/features which it tells you by stating "Resolving Target Definition" in its status bar. Be patient, this will take quite a while. After it has finished, you can click the link "Set as Target Platform" on the top right of the ''Target Definition'' editor. Doing so will cause Eclipse to start re-compiling the sources and all error markers should be gone when finished.

+

−

===== Defining the target platform manually =====

+

* Instead of using the target definition file provided by SMILA (see above) you can also [[SMILA/Development Guidelines/Howto set up target platform|manually set your own target platform]].

−

+

−

Instead of using the target definition file you can also [[SMILA/Development Guidelines/Howto set up target platform|manually set your own target platform]].

+

==== Launching SMILA in Eclipse IDE ====

==== Launching SMILA in Eclipse IDE ====

Line 70:

Line 60:

If you've checked out SMILA's trunk correctly, you should have a project called '''SMILA.launch''' in your workspace. This project contains the SMILA's launch configuration for Eclipse IDE. To start SMILA directly in your Eclipse IDE, just follow the steps below:

If you've checked out SMILA's trunk correctly, you should have a project called '''SMILA.launch''' in your workspace. This project contains the SMILA's launch configuration for Eclipse IDE. To start SMILA directly in your Eclipse IDE, just follow the steps below:

#*Uncheck all junit 4 bundles (e.g. <tt>org.junit4</tt>, <tt>org.junit(4.8.2....)</tt> etc.) because they conflict with the junit 3 bundles used in SMILA.

+

−

#Click '''Debug'''. <br> If everything works fine, you will get an output in the '''Console''' view similar to the following:

+

<source lang="text">

<source lang="text">

Line 92:

Line 78:

==== You're done ====

==== You're done ====

−

Congratulations! You've just successfully checked out and configured your SMILA development environment and you can now start [[SMILA/Development_Guidelines/Create_a_bundle_(plug-in)|developing your own bundles]].

+

Congratulations! You've just successfully checked out and configured your SMILA development environment and you can now start [[SMILA/Development Guidelines/Create a bundle (plug-in)|developing your own bundles]].

+

+

==== Additional steps ====

+

+

The following steps may be needed for special purposes. If you are a SMILA user who only wants to integrate an own component you won't need them.

+

+

===== Delta Pack =====

+

''(only needed for building the software outside of eclipse IDE)''

+

+

For building the software you may need to add a "Delta Pack" to an Eclipse SDK installation. You can download it from [http://download.eclipse.org/eclipse/downloads/ here] by selecting the corresponding eclipse version that you have in use. After downloading, you can copy the contained plugins and features in your eclipse installation.

+

+

===== Checkstyle configuration =====

+

+

If you have the [http://eclipse-cs.sourceforge.net/ Eclipse Checkstyle plugin] installed, you will get a lot of error messages complaining about missing check configurations when Eclipse builds the workspace.

Note:The upside of doing so is that you can easily get new projects just by updating your working copy and reimporting the sources into eclipse. Removed projects will be deleted on update. Eclipse will indicate this to the user by displaying an empty project.

Hint:: New projects should always be added to the .psf file so you can import them (as before): right click on .psf file and click on "Import Project Set...", be sure to click "No To All" to the question whether to overwrite existing projects in the workspace, otherwise it will check out everything again instead of ignoring the projects, that are already checked out. If projects are removed you have to remove them manually from the workspace, this can't be handled via .psf file.

After having imported the source code into your workspace, it will show up a lot of errors. Don't worry, they'll disappear after the next steps below.

Defining the target platform

The target platform defines the set of bundles and features that you are developing against. SMILA ships a Target Definition File that you can open in your IDE to configure the target platform automatically. This file contains all the references needed for developing SMILA with Eclipse Juno (Release 4.2).

Using the target platform provided by SMILA

Open the file SMILA.releng/devenv/SMILA.target with the Target Definition editor. Eclipse starts downloading the referenced bundles/features which it tells you by stating "Resolving Target Definition" in its status bar. Be patient, this will take quite a while. After it has finished, you can click the link "Set as Target Platform" on the top right of the Target Definition editor. Doing so will cause Eclipse to start re-compiling the sources and all error markers should be gone when finished.

Defining the target platform manually

Launching SMILA in Eclipse IDE

If you've checked out SMILA's trunk correctly, you should have a project called SMILA.launch in your workspace. This project contains the SMILA's launch configuration for Eclipse IDE. To start SMILA directly in your Eclipse IDE, just follow the steps below:

Click Run--> Debug Configurations and expand OSGI Framework.

Select the SMILA launch file.

Click Debug. If everything works fine, you will get an output in the Console view similar to the following:

You're done

Congratulations! You've just successfully checked out and configured your SMILA development environment and you can now start developing your own bundles.

Additional steps

The following steps may be needed for special purposes. If you are a SMILA user who only wants to integrate an own component you won't need them.

Delta Pack

(only needed for building the software outside of eclipse IDE)

For building the software you may need to add a "Delta Pack" to an Eclipse SDK installation. You can download it from here by selecting the corresponding eclipse version that you have in use. After downloading, you can copy the contained plugins and features in your eclipse installation.

Checkstyle configuration

If you have the Eclipse Checkstyle plugin installed, you will get a lot of error messages complaining about missing check configurations when Eclipse builds the workspace.