2. Windows installation from binaries¶
The instructions for installing eProsima Fast DDS in a Windows environment from binaries are provided in this page. It is organized as follows:
First of all, the Requirements and Dependencies detailed below need to be met.
2.1. Requirements¶
The installation of eProsima Fast DDS in a Windows environment from binaries requires the following tools to be installed in the system:
2.1.1. Visual Studio¶
Visual Studio is required to
have a C++ compiler in the system. For this purpose, make sure to check the
Desktop development with C++
option during the Visual Studio installation process.
If Visual Studio is already installed but the Visual C++ Redistributable packages are not,
open Visual Studio and go to Tools
-> Get Tools and Features
and in the Workloads
tab enable
Desktop development with C++
. Finally, click Modify
at the bottom right.
2.1.2. Chocolatey¶
Chocolatey is a Windows package manager. It is needed to install some of eProsima Fast DDS’s dependencies. Download and install it directly from the website.
2.2. Dependencies¶
eProsima Fast DDS has the following dependencies, when installed from binaries in a Windows environment:
2.2.1. TinyXML2¶
TinyXML2 is a simple, small and efficient C++ XML parser. It can be downloaded directly from here.
After downloading this package, open an administrative shell with PowerShell and execute the following command:
choco install -y -s <PATH_TO_DOWNLOADS> tinyxml2
where <PATH_TO_DOWNLOADS>
is the folder into which the package has been downloaded.
2.2.2. OpenSSL¶
OpenSSL is a robust toolkit for the TLS and SSL protocols and a general-purpose cryptography library.
The latest OpenSSL version for Windows can be found in the OpenSSL website.
After installing, add the environment variable OPENSSL_ROOT_DIR
pointing to the installation root directory.
For example:
OPENSSL_ROOT_DIR=C:\Program Files\OpenSSL-Win64
2.3. Install¶
The latest release of eProsima Fast DDS for Windows is available at the company website downloads page. Once downloaded, execute the installer and follow the instructions, choosing the preferred Visual Studio version and architecture when prompted.
Note
By default, eProsima Fast DDS does not compile tests. To activate them, please refer to the Windows installation from sources page.
2.3.1. Contents¶
By default, the installation will download all the available packages, namely:
foonathan_memory_vendor
, an STL compatible C++ memory allocator library.fastcdr
, a C++ library that serializes according to the standard CDR serialization mechanism.fastrtps
, the core library of eProsima Fast DDS library.fastrtpsgen
, a Java application that generates source code using the data types defined in an IDL file.
2.3.2. Environment variables¶
eProsima Fast DDS requires the following environment variable setup in order to function properly:
FASTRTPSHOME
: Root folder where eProsima Fast DDS is installed.Additions to the
PATH
: The location of eProsima Fast DDS scripts and libraries should be appended to thePATH
.
These variables are set automatically by checking the corresponding box during the installation process.