JemmaOnEclipse
This guide will help you setting up Eclipse Plugin Development Environment to contribute to JEMMA code or debug it.
##Requirements
To contribute to the JEMMA project it is essential for you to have:
##Getting bundles
To get a local copy of the JEMMA bundles you need to clone this repository:
git clone https://github.com/ismb/jemma.git
To generate eclipse projects from most of the jemma components, you need to run Maven as follows:
cd jemma/
mvn clean package eclipse:eclipse -Declipse.pde
This will also prepare JEMMA's bundles to be used in eclipse PDE.
##Import Jemma in Eclipse
This section will help you importing project you've generated with maven into your eclipse workspace.
In Eclipse:
- Select "Import..." from "File" menu.
- Select "General" -> "Existing Projects into Workspace"
- Specify project root folder of the jemma project
- Click "Finish".
##Setting required target platform
From Eclipse, open jemma.target file in "jemma" project root, and from the Target Definition editor select "Set as Target Platform" in the top-right corner of the editor as shown in the figure below:
##Caveats for Linux users
Under Linux, you must remember that you must have proper permissions to access the /dev/ttyUSB0 device (the ZigBee dongle). You can check the required permissions with ls -alh /dev/ttyUSB0 and make sure that your user has full access. In Ubuntu and derivatives you can just add your user to the "dialout" group.
##Run from launch configuration Open eclipse menu "Run->Run Configurations". Two launch configuration files are available to let you run jemma plugins in eclipse, they are called jemma Linux or jemma Windows.
Before launching the launch configuration, make sure that -Dzgd.dongle.uri property has a valid value, according to the port assigned by the operating system to your FlexKey as shown in the figure below
##Next steps