https://github.com/aguther/rtiddsgen-maven-plugin

Maven plugin to use rtiddsgen (part of RTI Connext DDS) during build.
https://github.com/aguther/rtiddsgen-maven-plugin

dds java maven maven-plugin

Last synced: 23 days ago
JSON representation

Maven plugin to use rtiddsgen (part of RTI Connext DDS) during build.

• Host: GitHub
• URL: https://github.com/aguther/rtiddsgen-maven-plugin
• Owner: aguther
• License: mit
• Created: 2024-08-28T20:38:57.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2024-09-05T11:59:26.000Z (2 months ago)
• Last Synced: 2024-10-01T16:15:22.819Z (about 1 month ago)
• Topics: dds, java, maven, maven-plugin
• Language: Java
• Homepage:
• Size: 23.4 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Maven Plugin for rtiddsgen

This is a repository that contains a maven plugin to use rtiddsgen during build.

## Usage

### Prerequisites

- Environment variable `NDDSHOME` pointing to directory with RTI Connext SDK

- If not disabled a proper development environment with a preprocessor

- RTI Connext 6.1.2 or newer

### Configuration in `pom.xml`

The minimum configuration needed to use the plugin is shown below:

```

  

    

      

        io.github.aguther.dds.maven

        rtiddsgen-maven-plugin

        0.1.0

        

          

            rtiddsgen

            

              rtiddsgen

            

          

        

      

    

  

```

## Features

- The plugin remembers the checksum of the input IDL files and only calls rtiddsgen for changed or new files.

- Support to call `rtiddsgen` in non-server, server and a JVM invocation mode (default and fastest)

- The following options can be used:

  - Unbounded sequences

  - Disable the preprocessor

  - Change preprocessor options

  - Configure the preprocessor executable path

  - Configure the java package prefix for the generated files

  - Change the default output directory

  - Change the default source directory

## Limitations

- When only the configuration of the plugin has been changed, `mvn clean` should be called to ensure the files are

  generated with the new configuration.

  The plugin does not automatically detect changes in the configuration right now

- Only the most commonly used features of `rtiddsgen` are supported right now

- Tests have been done with the current LTS releases RTI Connext 6.1.2 and RTI Connext 7.3.0

- Documentation of the plugin is very little up to now