This page presents a high level overview and instructions for building the various components of the OCAP Reference Implementation as well as supporting tools, which include
- PC Platform Emulator
- OCAP Stack
- Common Source
- atelite
- tru2way Workbench
You should always compile changes to the RI Platform before compiling changes to the OCAP stack.
Build Environment Summary
More detailed instructions on how to set up your complete build environment can be found at RI Build Environment.
From a build perspective the key environment variables to understand are
- PLATFORMROOT: directory from which to perform platform build commands
- OCAPROOT: directory from which to perform stack build commands
- RICOMMONROOT: must be defined correctly ri to execute.
- PLATFORMTC: extension from $PLATFORMROOT/target (such as Win32/debug)
- PLATFORMHOST: either "Linux" or "Win32-Cygwin" (child dir of $PLATFORMROOT/hostconfig)
Building the Various RI Components
Platform Build & Test Run
- cd $PLATFORMROOT
- make
does not give success response, last line says "make[[1]]: Leaving directory '/cygdrive/.../RI_Platform/launcher'
- to determine success, look in \trunk\ri\RI_Platform\install\Win32\debug\bin on Windows to see if ri.exe was built
- executing
- build stack - see below
- edit ./platform_win32.cfg on Windows or ./platform_linux.cfg on Linux. Use your ethernet card's IP address, 127.0.0.1 does not work.
- ./runPlatform.sh
For more details about platform make targets see RI PC Platform Build Targets
OCAP Stack Build
- NOTE: by default JVM will not be compiled. To enable JVM compiling do the following:
- In $OCAPROOT/target/$OCAPTC/buildrules.properties comment out the following value: build.jvm.exclude=true
- cd $OCAPROOT
- ant
tru2way Workbench
Image Map Editor
The image map editor is a tool used to create the remote and front panel user interface meta-data employed by the RI Emulator.
To build this tool, the following environment variables must be set:
- RISDKROOT: directory from which to perform SDK build commands
- RISDKTC: extension from $RISDKROOT/target (such as Win32/debug)
- RISDKHOST: target host environment (such as Win32)
- RI_BUILD_SUPPORTLIBS: flag to build supporting libraries
To build the Image Map Editor:
- cd $RISDKROOT/3rdParty
- make (be sure that RI_BUILD_SUPPORTLIBS=1)
- cd $RISDKROOT/ImageMapEditor
- make
The result is placed in $RISDKROOT/install/$RISDKTC/bin/imeditor