2. Usage

This section explains the usage of Fast DDS-Gen tool and briefly describes the generated files.

2.1. Running the Fast DDS-Gen Java application

First, the steps outlined in Linux installation of Fast DDS-Gen or Window installation of Fast DDS-Gen must be accomplished for the installation of Fast DDS-Gen. According to this section, an executable file for Linux and Windows that runs the Java Fast DDS-Gen application is available in the scripts folder. If the scripts folder path is added to the PATH environment variable, Fast DDS-Gen can be executed running the following commands:

  • Linux:

    $ fastrtpsgen
    
  • Windows:

    > fastrtpsgen.bat
    

Note

In case the PATH has not been modified, these scripts can be found in the <fastrtpsgen_directory>/scripts directory.

2.2. Supported options

The expected argument list of the application is:

fastrtpsgen [<options>] <IDL file> [<IDL file> ...]

Where the option choices are:

Option

Description

-help

Shows the help information.

-version

Shows the current version of eProsima Fast DDS-Gen.

-d <directory>

Sets the output directory where the generated files are created.

-I <directory>

Add directory to preprocessor include paths.

-t <directory>

Sets a specific directory as a temporary directory.

-example <platform>

Generates an example and a solution to compile the generated source code for a specific
platform. The help command shows the supported platforms.

-replace

Replaces the generated source code files even if they exist.

-ppDisable

Disables the preprocessor.

-ppPath

Specifies the preprocessor path.

-typeobject

Generates TypeObject files for the IDL provided and modifies MyType constructor to
register the TypeObject representation into the factory.

Please refer to Dynamic Topic Types for more information on TypeObject representation.