Skip to main content
Jump to: navigation, search

Difference between revisions of "EclipseSmartHome/Development/Build"

(Created page with "Building Eclipse SmartHome == Prerequisites == The build infrastructure is based on Maven in order to make it as easy as possible to get up to speed. If you know Maven alrea...")
 
 
Line 27: Line 27:
  
 
The build result will be available in the folder  
 
The build result will be available in the folder  
smarthome/distribution/target. Both the runtime as well as
+
smarthome/distribution/target. Both the repository as well as
 
the designer zips are placed in there.
 
the designer zips are placed in there.
  
== Starting the demo runtime ==
+
== The repository as a build result ==
  
* unzip the file eclipsesmarthome-incubation-0.x.0-runtime.zip to a local folder
+
As Eclipse SmartHome is a framework, i.e. a set of OSGi bundles, the main build artifact is a p2 repository which contains all these bundles with their meta-information.
* launch the runtime with the "start.sh" (resp. "start.bat") script
+
You will find the repository packaged as a zip as eclipsesmarthome-incubation-0.x.0-SNAPSHOT-repo.zip
* check if everything has started correctly: http://localhost:8080/smarthome.app?sitemap=demo
+
 
 +
There is currently no launchable binary of a runtime available.
 +
If you want to launch the framework on Equinox as an OSGi container and Jetty as an HTTP server, you can do so from within the [https://github.com/eclipse/smarthome/blob/master/docs/sources/development/ide.md development environment] by running the provided launch configuration.  
 +
If you are looking for an example of how a solution can be built using the Eclipse SmartHome framework, you might want to have a look at [https://github.com/openhab/openhab2#openhab-1-vs-openhab-2 this project].
  
 
== Starting the designer ==
 
== Starting the designer ==
  
* unzip the file eclipsesmarthome-incubation-0.x.0-designer-<platform>.zip to a local folder
+
* unzip the file eclipsesmarthome-incubation-0.x.0-SNAPSHOT-designer-<platform>.zip to a local folder
 
* run the executable „Eclipse-SmartHome-Designer.exe"
 
* run the executable „Eclipse-SmartHome-Designer.exe"
  

Latest revision as of 03:15, 28 November 2014

Building Eclipse SmartHome

Prerequisites

The build infrastructure is based on Maven in order to make it as easy as possible to get up to speed. If you know Maven already then there won't be any surprises for you. If you have not worked with Maven yet, just follow the instructions and everything will miraculously work ;-)

What you need before you start: - Maven3 from http://maven.apache.org/download.html

Make sure that the "mvn" command is available on your path

Checkout

Checkout the source code from GitHub, e.g. by running

git clone https://github.com/eclipse/smarthome.git

Building with Maven

To build Eclipse SmartHome from the sources, Maven takes care of everything:

  • change into the smarthome directory ("cd smarthome“)
  • set MAVEN_OPTS to "-Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m"" in order to avoid memory problems during the build process.
  • run "mvn clean install" to compile and package all sources

The build result will be available in the folder smarthome/distribution/target. Both the repository as well as the designer zips are placed in there.

The repository as a build result

As Eclipse SmartHome is a framework, i.e. a set of OSGi bundles, the main build artifact is a p2 repository which contains all these bundles with their meta-information. You will find the repository packaged as a zip as eclipsesmarthome-incubation-0.x.0-SNAPSHOT-repo.zip

There is currently no launchable binary of a runtime available. If you want to launch the framework on Equinox as an OSGi container and Jetty as an HTTP server, you can do so from within the development environment by running the provided launch configuration. If you are looking for an example of how a solution can be built using the Eclipse SmartHome framework, you might want to have a look at this project.

Starting the designer

  • unzip the file eclipsesmarthome-incubation-0.x.0-SNAPSHOT-designer-<platform>.zip to a local folder
  • run the executable „Eclipse-SmartHome-Designer.exe"

Eclipse Hudson instance

http://hudson.eclipse.org/smarthome/job/SmartHomeDistribution/

Back to the top