Introduction

If you are a developer and not a pure user yourself, you might want to setup your Eclipse IDE, so that you can debug and develop openHAB bundles yourself.

Setup Instructions

Here are step-by-step instructions on how to get there:

1. Download and install the Mercurial binaries for your platform.
2. Download and install the Yoxos Installer.
3. Download and execute the file openHAB.yoxos. This will install you an Eclipse IDE with all required features to develop for openHAB.
4. Create a new workspace and configure the path to your "hg" executable in Preferences->Team->Mercurial.
5. Choose File->Import->Mercurial->Clone Existing Mercurial Repository and enter https://openhab.googlecode.com/hg/ as the repository URL.
6. After the import is done, you have to select the target platform by selecting Preferences->Plug-in Development->Target Platform->openHAB from the main menu.
7. Now you need to run code generation for a few parts of openHAB. To do so, go to the project org.openhab.model.codegen and open the folder "workflows". For each of the contained files, select "Run As->MWE2 Workflow" from the context menu.
8. All your project in the workspace should now correctly compile without errors. If you still see error markers, try a "clean" on the concerned projects.
9. To launch openHAB from within your IDE, go to Run->Run Configurations->Eclipse Application->openHAB Runtime (resp. openHAB Designer).

To produce a binary zip yourself from your code, you can simply call "mvn clean install" from the repository root and you will find the results in the folder distribution/target (you will of course need a Maven 3.0 installation as a prerequisite).