Installing RST¶
See also
- C++ Tutorial
- Using installed RST in a C++ project
- Java Tutorial
- Using installed RST in a Java project
- Python Tutorial
- Using installed RST in a Python project
There are currently two ways to install the 0.12 version of RST:
From Source¶
Preconditions¶
In order to build RST, the following tools and libraries are required:
- Google protocol buffers
protoc
compiler executable starting with version 2.4 (Ubuntu packageprotobuf-compiler
) - C++ binding:
libprotobuf
library in the same version asprotoc
(Ubuntu packagelibprotobuf-dev
)- RSC library (Installation is explained as part of installing RSB).
- Python binding:
- Python in version 2.x
- Pypi package
protobuf
in the same version asprotoc
(Ubuntu packagepython-protobuf
) - Setuptools (Ubuntu package
python-setuptools
)
- Java binding:
- Any JDK starting with version 1.5 (must include
javac
executable, Ubuntu package:openjdk-7-jdk
) - Apache ant (Ubuntu package
ant
) - Google protocol buffers library for java (Ubuntu package
libprotobuf-java
)
- Any JDK starting with version 1.5 (must include
Build Instructions¶
The whole source tree of RST, including all sub-projects, can be obtained by executing the command:
$ git clone -b 0.12 --recursive https://code.cor-lab.org/git/rst.git $ git submodule foreach git checkout 0.12 $ git submodule foreach git pull
After that, RST can be built and installed like this:
$ cd rst/rst-proto # after "git clone" command $ mkdir -p build && cd build $ cmake -DCMAKE_BUILD_TYPE=debug -DCMAKE_INSTALL_PREFIX=
PREFIX
.. $ make $ make installwhere
PREFIX
is the directory into which RST should be installed (which is sometimes called “install prefix”).Note
During the cmake call a list of enabled language bindings will be printed. Please verify that the language you want to work with is included. If this is not the case, a warning should have been printed to the console before that indicates which dependency could not be found.
Example output:
-- Matlab not supported by protoc. Not generating matlab bindings. -- Enabled features: * cpp binding * java binding * python binding
Optional: Install converters bundled with RST
$ cd rst-converters/cpp # in cloned "rst" directory $ mkdir -p build && cd build $ cmake -DCMAKE_BUILD_TYPE=debug -DCMAKE_INSTALL_PREFIX=
PREFIX
.. $ make $ make installwhere
PREFIX
is the directory into which the RST converters should be installed.
Debian Packages¶
Debian packages for several versions of Ubuntu GNU/Linux are available from the CoR-Lab package repository.
Configure your computer to use the repository as described here: http://packages.cor-lab.de
After that, packages can be installed via
$ sudo apt-get install rst0.12 librstconverters0.12
Of course, it also possible to only install a subset of the above packages.