Robotics Service Bus

h1. Installation of C++ Implementation

{{>toc}}

h2. Dependencies

h3. Required Dependencies

* "Boost":http://www.boost.org/ >= 1.38 (for hardy available in the gar-installer, 1.34.1 untested)
* "Boost.UUID":http://www.boost.org/doc/libs/1_42_0/libs/uuid/uuid.html (header-only, officially included in Boost since 1.42, headers from this version can be used with all older versions of boost, gar-installer package available)
* "Google Protocol Buffers":http://code.google.com/p/protobuf/
** Ubuntu Lucid packages are ok (libprotobuf-dev, protobuf-compiler)
** can also be installed from GAR installer via contrib/protobuf
* "Spread Toolkit":http://spread.org/ >= 4.0
** Ubuntu Lucid package does *not* work, due to outdated version 3
** Can be installed through GAR installer via contrib/spread or from source
* "CMake":http://www.cmake.org/ (tested with 2.8)

h3. Optional Dependencies

_The C++ implementation can be built without these, but some features will be missing._


* optional:
** "Doxygen":http://www.doxygen.nl/ for API generation
* ** "Lcov":http://ltp.sourceforge.net/coverage/lcov.php for code coverage analysis
* ** "cppcheck":http://sourceforge.net/apps/mediawiki/cppcheck/index.php?title=Main_Page for static code analysis

h3. Installation of Dependencies apt-get command line to install all dependencies on Debian-based Systems

Example for Ubuntu 10.04:
<pre>
$ swrede@ubuntu:~$ sudo apt-get install libprotobuf-dev protobuf-compiler build-essential libboost-dev
</pre>

h2. Supported Operating Systems and Compilers

* Linux (GCC 4.x)
* Windows (MS Visual Studio 9 2008)

Other combination may be possible but are currently untested.

h2. Installation of RSC, RSBProtocol and RSB

* Checkout RSB and its immediate dependencies from the Subversion repository:
** RSC: https://code.cor-lab.org/svn/rsc/trunk/rsc
** RSB Protocol: https://code.cor-lab.org/svn/rsb/trunk/protocol
** RSB C++: https://code.cor-lab.org/svn/rsb/trunk/cpp/core
* CMake is required to configure the projects.
* Build and install the RSB C++ core and its dependencies (in the order given below):
*# Build and install RSC Library:
<pre>
cd rsc/build && cmake .. -DCMAKE_INSTALL_PREFIX=$prefix && make && make install
</pre>
*# Install RSB Protocol Definitions
<pre>
cd protocol/build && cmake .. -DCMAKE_INSTALL_PREFIX=$prefix && make && make install
</pre>
_Note: these protocol definitions are shared across programming languages._
*# Build and install RSB C++ Core
<pre>
cd core/build && cmake .. -DCMAKE_INSTALL_PREFIX=$prefix -DRSC_DIR=$prefix/share/rsc && make && make install
</pre>