Installation¶
In this section, instructions are provided to install the following packages:
The user can decide wether to install the Agent and Client as stand-alone packages, or together. If the first approach is chosen, refer to the Release Notes section in order to match versions that are compatible.
Using pre-installed docker images¶
Download here the Micro XRCE-DDS and Fast-DDS Suite docker image that contains a pre-installed client and agent as well as some compiled examples. More information about this Docker image can be found here.
Installing the Agent standalone¶
Clone the project from GitHub:
$ git clone https://github.com/eProsima/Micro-XRCE-DDS-Agent.git
$ cd Micro-XRCE-DDS-Agent
$ mkdir build && cd build
On Linux, inside of the build
folder, execute the following commands:
$ cmake ..
$ make
$ sudo make install
On Windows first select the Visual Studio version:
$ cmake -G "Visual Studio 15 2017 Win64" ..
$ cmake --build .
$ cmake --build . --target install
Note
The eProsima Micro XRCE-DDS Agent can be configured at compile-time via several CMake definitions. Find them listed in the Configuration section of the eProsima Micro XRCE-DDS Agent page.
Now the the executable eProsima Micro XRCE-DDS Agent is installed in the system. Before running it, add
/usr/local/lib
to the dynamic loader-linker directories.
sudo ldconfig /usr/local/lib/
Important
The eProsima Micro XRCE-DDS Agent executable comes with a rich CLI. Find out all the options offered by this CLI when running the Agent in the Agent CLI section of the eProsima Micro XRCE-DDS Agent page.
Installation from Snap package¶
The eProsima Micro XRCE-DDS Agent can also be installed as a Snap package..
To this aim, simply execute sudo snap install micro-xrce-dds-agent
in the console.
This will download the Snap package corresponding to the stable
version, that is, the master branch on GitHub.
For downloading the Snap image corresponding to the develop branch, add the --edge
flag to the installation command.
Note
The Snap package is only available for Linux.
Installing the Client standalone¶
Clone the project from GitHub:
$ git clone https://github.com/eProsima/Micro-XRCE-DDS-Client.git
$ cd Micro-XRCE-DDS-Client
$ mkdir build && cd build
On Linux, inside of build
folder, execute the following commands:
$ cmake ..
$ make
$ sudo make install
Now the the executable eProsima Micro XRCE-DDS Client is installed in the system. Before running it, add
/usr/local/lib
to the dynamic loader-linker directories.
sudo ldconfig /usr/local/lib/
On Windows first select the Visual Studio version:
$ cmake -G "Visual Studio 15 2017 Win64" ..
$ cmake --build .
$ cmake --build . --target install
Note
In order to install the eProsima Micro XRCE-DDS Client examples, add -DUCLIENT_BUILD_EXAMPLES=ON
to the cmake ..
command-line options. This flag will enable the compilation of the examples.
In addition to this flag, there are several other CMake definitions for configuring the building of the client
library at compile-time.
Find them in the Profiles and configurations
sections of the eProsima Micro XRCE-DDS Client page.
For building a Client app in the host machine, compile against the following libs:
gcc <main.c> -lmicrocdr -lmicroxrcedds_client
Installing the Micro XRCE-DDS Gen tool¶
Install dependencies, clone the project from GitHub and build:
$ git clone https://github.com/eProsima/Micro-XRCE-DDS-Gen.git
$ cd Micro-XRCE-DDS-Gen
$ git submodule init
$ git submodule update
$ ./gradlew assemble
The Micro XRCE-DDS-Gen tool will be available as:
$ ./scripts/microxrceddsgen -help
Installing Agent and Client¶
Clone the project from GitHub:
$ git clone https://github.com/eProsima/Micro-XRCE-DDS.git
$ cd Micro-XRCE-DDS
$ mkdir build && cd build
On Linux, inside of the build
folder, execute the following commands:
$ cmake ..
$ make
$ sudo make install
On Windows choose the Visual Studio version using the CMake option -G, for example:
$ cmake -G "Visual Studio 15 2017 Win64" ..
$ cmake --build . --target install
Now both the eProsima Micro XRCE-DDS Agent and the eProsima Micro XRCE-DDS Client are installed in the system.
Note
In order to install the eProsima Micro XRCE-DDS Gen tool as well, add -DUXRCE_ENABLE_GEN=ON
to the cmake ..
command-line options. This flag will enable the downloading and compilation of the code generating tool.
Note
In order to install the eProsima Micro XRCE-DDS examples, add -DUXRCE_BUILD_EXAMPLES=ON
to the cmake ..
command-line options. This flag will enable the compilation of the examples.