Building OpenRemote Controller

OpenRemote Controller project is divided into to parts: Java Services and System Services.

Java Services contain, as the name implies, service implementations written in Java. System Services contain native code for a specific Operating System distribution (at the moment Linux), mainly driver code to integrate with home automation hardware.

Building Java Services

You need to install JDK 1.6 or later to compile the source.

Once you've checked out the controller source code, you'll find the following directory structure under the 'trunk' directory (or tags/[release dir] if you've checked out a specific release of OpenRemote Controller):

/trunk/Controller/JavaServices
    /build
    /src
    /docs
    /etc

To build the controller Java Services, go to the build directory and execute build.sh script (or build.bat for Windows).

Note that you need to have the top level 'trunk/Tools' directory checked out as well which includes Ant build tool, or if you have Ant installed separately on your machine, you can execute the build.xml script directly.

The controller Java services are currently built using Ant version 1.7.0. The build files have not been tested with other versions of Ant.

$ cd trunk/Controller/JavaServices/build
$ sh build.sh [build.bat for Windows]

Successful execution of the build should yield output similar to shown below.

$ sh build.sh
Buildfile: build.xml

init:

compile:
     [echo] --------------------------------------------------------------------
     [echo]  Compiling Java classes...
     [echo] --------------------------------------------------------------------
     [echo]
    [mkdir] Created dir: c:\Personal\Java\openremote\trunk\Controller\JavaServices\output\classes
    [javac] Compiling 3 source files to c:\Personal\Java\openremote\trunk\Controller\JavaServices\output\classes

     ...

    
BUILD SUCCESSFUL
Total time: 1 second

All the build artifacts will be found under '/trunk/Controller/JavaServices/output' directory. See Running OpenRemote Controller for more information.

Building System Services

Nothing here yet.