Robotics Service Bus

h1. Installation of C++ Implementation

*The information on this page has been superseded by the "RSB Manual":http://docs.cor-lab.org/rsb-manual/trunk/html.*

{{>toc}}

h2. Prerequisites

h3. Supported Operating Systems and Compilers

* Linux (GCC 4.x)

* Windows (MS Visual Studio 9 2008)

Other combinations may be possible but are currently untested.

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._

* "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 on Debian-based Systems

Example for Ubuntu 10.04:

<pre>

$ sudo apt-get install libprotobuf-dev protobuf-compiler build-essential libboost-dev

</pre>

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>