Framesoc development environment setup

Summary

This page describes how to configure a working Eclipse Plugin Development Environment for Framesoc. The procedure described has been tested under Eclipse Kepler. For different versions of Eclipse some change could be necessary.

Requirements

• Java JDK 7
  • You can download it from: http://www.oracle.com/technetwork/java/javase/downloads/index.html
• [optional] MySQL server (optional, since Framesoc uses by default SQLite, which is an embedded DBMS)

System setup

After cloning the git repository follow these steps:

• Install the latest version of 'Eclipse for RCP and RAP Developers'

  • Download the package suitable for your architecture at http://www.eclipse.org/downloads/
  • Extract it
  • Go in the eclipse folder and launch the executable

• Install the Tycho m2e connector

  • Window -> Preferences -> Maven -> Discovery
  • Press the Open Catalog button
  • Activate the Tycho Configurator
  • Click on Finish and follow the installation instructions

  If the Tycho Configurator is not present in the Catalog, you can still install it using the update site:

  • From the Eclipse main menu: Help > Install New Software...
  • Type the following address in the text field Work with:
    • http://repo1.maven.org/maven2/.m2e/connectors/m2eclipse-tycho/0.8.0/N/LATEST/
  • Select the Tycho Configurator
  • Press Next and follow the wizard (accept the license and finish the installation).
  • At the end of the installation, Eclipse will ask for restart.

• Import in the Eclipse workspace all the plugins contained in the repository src directory

  • Launching Eclipse for the first time you will be asked to set a workspace:
    • chose a folder which is outside the repository
  • Import the Framesoc plugins
    • File -> Import -> General -> Existing Projects into Workspace
    • Set the repository src as root directory
    • Be sure that all projects folders are checked
    • Press Finish

• Import in the Eclipse workspace also the plugins available in the framesoc.importers repository

  • clone this repository
  • do the same as before to import the plugins in the Eclipse workspace

• Build all the plugins

  • Project -> Clean... (be sure that Build Automatically is checked)
  • Choose Clean all projects
  • Press Ok

• Launch the Framesoc Eclipse Application

  • Right click on the fr.inria.soctrace.framesoc.core plugin
  • Run As -> Eclipse Application