Skip to content

Commit

Permalink
Fixes #3
Browse files Browse the repository at this point in the history
Signed-off-by: Kai Kreuzer <[email protected]> (github: @kaikreuzer)
  • Loading branch information
kaikreuzer committed Jul 18, 2014
1 parent 72c9032 commit ac0f42d
Showing 1 changed file with 5 additions and 4 deletions.
9 changes: 5 additions & 4 deletions docs/sources/development/ide.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,21 +8,22 @@ Note that the project build is completely mavenized - so running "mvn install" o

Make sure that you have the following things installed on your computer:

1. Git
1. Maven 3.x
1. Oracle JavaSE 7 or 8
1. [Yoxos Installer](https://yoxos.eclipsesource.com/downloadlauncher.html)

## Setup Instructions

Here are step-by-step instructions:


1. Create [your own fork of the openHAB2 repository](https://github.com/openhab/openhab2/fork) at Github
1. Create a local clone of your repository on the local filesystem by running `git clone https://github.com/<your_github_user>/openhab2.git`
1. Download and execute the file [openHAB2.yoxos](https://raw.githubusercontent.com/openhab/openhab2/master/targetplatform/openhab2.yoxos) (in linux that can be done via command line ./yoxos openhab2.yoxos
). This will install you an Eclipse IDE with all required features to develop for openHAB 2. Alternatively, you can install all required plugins on top of an existing Eclipse 4.4 installation using this [update site](http://yoxos.eclipsesource.com/userdata/profile/ffb4645d9f172d6d927e2b25f19d1813) or [download a full distribution from Yoxos](http://yoxos.eclipsesource.com/userdata/profile/ffb4645d9f172d6d927e2b25f19d1813), if you register an account there.
1. Create a new workspace and you are all set!
1. Create a new workspace and choose `File->Import->General->Existing Projects into Workspace`, enter your repository root folder and press "Finish". All project should directly compile without errors.
1. To launch openHAB from within your IDE, go to Run->Run Configurations->Eclipse Application->openHAB_Runtime

The IDE setup will automatically do a git clone into the workspace folder under '.repositories/openhab2', so you will find all files located in there.

To produce a binary zip of the runtime yourself, you can simply call `mvn clean install` from the repository root and you will find the result in the folder distribution/target.

To run a single test you have to use following command: `mvn -o org.eclipse.tycho:tycho-surefire-plugin:0.20.0:test` which activates the tycho-surefire-specific goal for OSGI unit test using the fragment bundle xxxx.test on xxxx bundle. The maven -o (offline) option accelerates the project dependency resolution by 10-20x since it lets maven search its local repository. Normally, snapshot-enabled projects are using external repositories to find latest built packages.

0 comments on commit ac0f42d

Please sign in to comment.