Wireloom.Dds.Cpp.Generator 1.1.0

dotnet add package Wireloom.Dds.Cpp.Generator --version 1.1.0
                    
NuGet\Install-Package Wireloom.Dds.Cpp.Generator -Version 1.1.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Wireloom.Dds.Cpp.Generator" Version="1.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Wireloom.Dds.Cpp.Generator" Version="1.1.0" />
                    
Directory.Packages.props
<PackageReference Include="Wireloom.Dds.Cpp.Generator" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Wireloom.Dds.Cpp.Generator --version 1.1.0
                    
#r "nuget: Wireloom.Dds.Cpp.Generator, 1.1.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Wireloom.Dds.Cpp.Generator@1.1.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Wireloom.Dds.Cpp.Generator&version=1.1.0
                    
Install as a Cake Addin
#tool nuget:?package=Wireloom.Dds.Cpp.Generator&version=1.1.0
                    
Install as a Cake Tool

Wireloom.Dds.Cpp.Generator 1.1.0

Wireloom.Dds.Cpp.Generator generates Modern C++ contracts from RTI Connext DDS IDL during native CMake and Visual Studio/MSBuild builds. Version 1.1.0 bundles Windows x64 and Linux x64 executables; generation needs no installed .NET SDK/runtime or RTI SDK.

Use the 1.1.0 release record for supported configurations, package hashes, and known limits. The C++ support and stability contract defines the public API and compatibility policy. Source and reference links target v1.1.0; the release record retains later qualification clarifications.

For a complete first application, follow the C++ Hello World walkthrough: install the package, generate during a native build, and run a publisher and subscriber in two terminals.

Obtain and pin the generator

Install Wireloom.Dds.Cpp.Generator 1.1.0 from NuGet.org. Pin this exact version in your build configuration.

Build your application with a compatible RTI native SDK and C++ toolchain. Use CMake 3.20 or later, or Visual Studio's native MSBuild integration. Running DDS requires the RTI runtime and applicable license.

CMake

Download the exact .nupkg and extract it into a version-specific directory. For a stable package on Linux, using curl and CMake 3.20 or later:

version='1.1.0'
package="wireloom.dds.cpp.generator.$version.nupkg"
curl --fail --location --output "$package" \
  "https://api.nuget.org/v3-flatcontainer/wireloom.dds.cpp.generator/$version/$package"
# Check the package SHA-256 against the version's retained release evidence.
sha256sum "$package"
mkdir -p "packages/Wireloom.Dds.Cpp.Generator.$version"
(
  cd "packages/Wireloom.Dds.Cpp.Generator.$version"
  cmake -E tar xf "../../$package"
)

On Windows, the NuGet CLI can perform the download and extraction:

$version = '1.1.0'
nuget install Wireloom.Dds.Cpp.Generator -Version $version `
  -Source https://api.nuget.org/v3/index.json -OutputDirectory packages -NonInteractive

Add generation to an existing target that already has its RTI include paths, libraries, and application sources configured:

find_package(WireloomCpp CONFIG REQUIRED)
wireloom_add_idl(my_app IDL "${CMAKE_CURRENT_SOURCE_DIR}/Contract.idl")

This attaches the four generated files and their include directory to my_app. Include Contract.hpp from your application. The integration accepts one IDL root per target; that root may include other files.

Configure and build from your application directory, pointing WireloomCpp_DIR at the installed package's build/cmake directory:

cmake -S . -B build "-DWireloomCpp_DIR=$PWD/packages/Wireloom.Dds.Cpp.Generator.$version/build/cmake" "-DWIRELOOM_CPP_RTI_VERSION=7.7.0"
cmake --build build

Keep the generator package and RTI profile pinned independently; match WIRELOOM_CPP_RTI_VERSION to the native SDK used by your application. CMake selects the host executable and restores its Linux execute permission, so keep the package directory writable. Rebuild after editing a root or included IDL file. Unchanged builds skip generation; missing outputs are regenerated.

Visual Studio / MSBuild

For an existing native .vcxproj, use Visual Studio's NuGet Package Manager with packages.config. In its Package Manager Console, select that project:

$version = '1.1.0'
Install-Package Wireloom.Dds.Cpp.Generator -Version $version -Source https://api.nuget.org/v3/index.json

Commit packages.config and the .vcxproj changes, including the package's .props and .targets imports. Add IDL inputs to the project:

<ItemGroup>
  <WireloomIdl Include="Contract.idl" />
</ItemGroup>
<PropertyGroup>
  <WireloomCppRtiVersion>7.7.0</WireloomCppRtiVersion>
</PropertyGroup>

Restore on CI using Visual Studio MSBuild, then build with your RTI SDK configuration:

MSBuild.exe MyApp.vcxproj -t:Restore -p:RestorePackagesConfig=true
MSBuild.exe MyApp.vcxproj -t:Build -p:Configuration=Release -p:Platform=x64

Keep feed and trust settings in your team's NuGet configuration. The package adds generation and generated sources; the application supplies RTI compiler and linker settings.

Update and roll back

Read the target version's release notes and support matrix. Keep the previous package and build configuration until validation of the replacement completes. For CMake, acquire the new package alongside the old one, update the pinned WireloomCpp_DIR, and configure a clean build directory. For Visual Studio, update the native project through Package Manager Console:

$version = '1.1.0'
Update-Package Wireloom.Dds.Cpp.Generator -Version $version -Source https://api.nuget.org/v3/index.json

Commit the updated version and imports together, restore, and rebuild all generated sources. Recheck application compilation and your DDS compatibility tests with the same RTI SDK/profile. Change the RTI version separately when possible so each change has clear evidence.

To roll back, restore the previous committed pin and imports (or CMake package path), restore that exact package, and rebuild in a clean directory. Do not mix generated sources or plugin files from different generator versions.

Generator reference

For each IDL root, generation emits <name>.hpp, <name>.cxx, <name>Plugin.hpp, and <name>Plugin.cxx. Public values, operations, and topic traits have Doxygen documentation. The executable follows the build host; the application's target architecture does not select the generator.

CLI and build settings

You can also generate sources directly from your application directory. On Windows, run the installed executable in PowerShell:

.\packages\Wireloom.Dds.Cpp.Generator.1.1.0\tools\win-x64\Wireloom.Dds.Cpp.exe generate Contract.idl generated --rti-version 7.7.0

On Linux, restore the execute permission after extracting the package:

tool='./packages/Wireloom.Dds.Cpp.Generator.1.1.0/tools/linux-x64/Wireloom.Dds.Cpp'
chmod +x "$tool"
"$tool" generate Contract.idl generated --rti-version 7.7.0

Pass --help for the complete syntax. Set --rti-version to match the native SDK profile; the implemented profiles are 6.1.2, 7.3.1, and 7.7.0. Add the generated sources and include directory to your application build when using the CLI directly; CMake and MSBuild perform that integration automatically.

Setting CLI CMake
RTI profile --rti-version WIRELOOM_CPP_RTI_VERSION
Includes and preprocessing --include-directory, --define, --undefine INCLUDE_DIRECTORIES, DEFINES, UNDEFINES
Validation and identifiers --strict, --enable-escape-char STRICT, ENABLE_ESCAPE_CHAR
Finite fallback sizes --sequence-size, --string-size SEQUENCE_SIZE, STRING_SIZE
Unbounded or finite mode --unbounded-support, --finite-support UNBOUNDED_SUPPORT, FINITE_SUPPORT
Declaring-file overrides --file-sequence-size, --file-string-size, --file-unbounded-support FILE_SEQUENCE_SIZES, FILE_STRING_SIZES, FILE_UNBOUNDED_SUPPORT

Quoted includes are searched beside the including file; include directories supply additional search locations. Per-file overrides use path/value pairs and apply to declarations in that file. The bundled native MSBuild target exposes WireloomIdl, WireloomCppRtiVersion, and WireloomCppGeneratedDir. Use the CLI or CMake when you need the additional generation options above; they are not forwarded by that MSBuild target.

MSBuild tracks root IDL and transitive includes automatically. Comment-only or timestamp-only edits run generation once, then unchanged builds skip it. Deleting a generated file regenerates it; Clean removes generated files and build state. For custom build integrations, --dependency-file <path> writes the absolute input paths, one per line, after successful generation.

Generated APIs and bounds

The generator handles documented scalar and enum values, constants, aliases, strings, collections, aggregates, keys, unions, optional members, and annotations. Availability and runtime support depend on the exact shape and RTI profile. See C++ value semantics for public fields, optional presence, copying, and union branch operations.

Source-unbounded sequences default to 100 elements and source-unbounded strings to 255. Explicit IDL bounds remain effective. Opt-in unbounded mode uses RTI unbounded metadata and the supported dynamic storage paths; it does not qualify arbitrary sample sizes or recursive graphs.

Capability and qualification limits

Use the 1.1.0 release record and support policy before adopting an IDL shape or native environment. Accepted IDL does not guarantee that every generated type can be registered or serialized on every RTI profile.

  • Match the generation profile, native SDK, and application toolchain. Rebuild generated contracts when upgrading either the generator or RTI SDK.
  • Recursive sequences and recursive optional arrays have separate limits. RTI 7.7.0 TypeObject v2 rejects recursive strongly connected components; follow the documented recursion restrictions.
  • FlatData is limited to the documented final, unkeyed, fixed-size two-long, XCDR2-only shape on RTI 7.7.0.0.
  • Optional sequences of wide strings have known Linux failures. Review the version-specific limitations before using that shape.
  • Use public value APIs and topic traits. Generated plugin callbacks and native adapter internals are not application extension points.

Troubleshooting

Symptom Check and next step
CMake cannot find WireloomCpp Set WireloomCpp_DIR to the extracted 1.1.0 package's build/cmake directory, then configure again.
Linux reports Permission denied for the CLI Run chmod +x on the packaged Linux executable, or use the CMake integration to restore its permission.
MSBuild does not generate sources Restore packages.config, check the package's .props and .targets imports, and declare a WireloomIdl item in the native project. Use Visual Studio MSBuild.
An IDL include cannot be resolved Check quoted includes relative to their declaring file. Use CLI --include-directory or CMake INCLUDE_DIRECTORIES for additional search directories.
Generated sources do not compile against RTI Match --rti-version, WIRELOOM_CPP_RTI_VERSION, or WireloomCppRtiVersion to the application's native SDK and verify its compiler/linker configuration.
Registration or serialization is rejected Check the release limits for the exact IDL shape and RTI profile. Generation alone does not establish runtime support.
The CLI exits with a nonzero code Exit 1 reports generation failure; exit 2 reports invalid usage. Read the diagnostic path/message and use --help for accepted options.

For DDS runtime, license, discovery, and peer setup, follow the C++ Hello World troubleshooting guide.

Learn more

Product Compatible and additional computed target framework versions.
native native is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.1.0 77 11/14/2026