Release Notes

6.1.2

The 6.1.2 release provides robustness improvements over 6.1.1.

See the Core Libraries What's New and Core Libraries Release Notes at https://community.rti.com/documentation.

Supported Platforms

The Connext DDS C# API is supported on .NET Standard 2.0 systems, including .NET 5 (and newer), .NET Core 2.1, .NET Core 3.1, .NET Framework 4.6.1, Unity 2018.1.

It runs on Windows®, Linux® and macOS® platforms. It has been tested on the following systems:

Windows

• Windows 10 (x64)
• Windows 8, server 2012 R2 (x64)

Linux

• CentOS™ 6.0, 6.2-6.4, 7.0 (x64)
• Red Hat® Enterprise Linux 6.0-6.5, 6.7, 6.8, 7, 7.3, 7.5, 7.6, 8 (x64)
• SUSE® Linux Enterprise Server 12 SP2 (x64)
• Ubuntu® 14.04, 16.04, 18.04, 20.04 LTS (x64)
• Ubuntu 16.04, 18.04 LTS (64-bit Arm® v8)

mac OS

• macOS 10.15 (x64)

The C# API is also supported on 32-bit Windows and 32-bit Arm v7 Linux systems. However, support for these platforms is not automatically included in the C# NuGet packages. An additional target package must be installed.

Installation

See the Getting Started Guide to install the Connext DDS C# API and build and run your first application.

To work with Unity, see this tutorial.

Limitations in this release

Limitations related to the Connext DDS API

• The Request-Reply API is not yet available.
• The Distributed Logger API is not yet available. However a custom handler for RTI Connext log messages can be used to redirect log messages using the Rti.Config.Logger.MessageLogged event.
• DomainParticipant and Publisher do not provide events to notify of status changes. Subscriber only provides Rti.Dds.Subscription.Subscriber.DataOnReaders. DataWriter, DataReader, and Topic provide all their events. (Note that DomainParticipant and Publisher do not have statuses of their own; they only define listeners that are notified when the status of a contained entity changes.) (CORE-11384)
• The FlowController class is not implemented, but FlowControllers can be configured with the Rti.Dds.Core.Policy.Property QoS policy. See Writing data and instances. (CORE-11388)
• The TopicQuery class is not implemented. TopicQuery can be enabled on the DataWriter with the Rti.Dds.Core.Policy.TopicQueryDispatch QoS policy, but it can't be used on the DataReader. (CORE-11386)
• The interface to implement custom Content Filters is not supported. The built-in filters (SQL and String MATCH) are supported. (CORE-11388)

Limitations related to the IDL-to-C# code generation

• The @optional annotation cannot be applied to a sequence. The annotation is ignored and a non-optional sequence is generated instead. Note however that a sequence with length zero can be used to represent optionality without the annotation. (CODEGENII-1503)
• Arrays of sequences cannot be used unless the sequence is aliased using a typedef. Otherwise the array is ignored. (CODEGENII-1504)
• The @external annotation is not supported (it is ignored).
• The @csharp_mapping annotation, which allows customizing some aspects of the IDL-to-C# mapping, is not supported. (CODEGENII-1498, CODEGENII-1499)

Other limitations

• Most classes and methods in this API reference provide only brief descriptions and refer to their counterpart in the RTI Connext C API for their full description.

Legacy .NET API

The previous .NET API and IDL binding to C++/CLI is deprecated since 6.1.0 and will be removed in a future version and replaced with this new C# API and C# IDL binding.

The 6.1.0 migration guide provides useful information for developers of the legacy .NET API.

Third Party Software

.NET Core 3.1

• Related to: List.cs source file is taken from the .NET open source repository and adapted to be compiled into RTI Core libraries.
• License: The MIT License

  The MIT License (MIT)
  Copyright (c) .NET Foundation and Contributors
  
  All rights reserved.
  
  Permission is hereby granted, free of charge, to any person obtaining a copy
  of this software and associated documentation files (the "Software"), to deal
  in the Software without restriction, including without limitation the rights
  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  copies of the Software, and to permit persons to whom the Software is
  furnished to do so, subject to the following conditions:
  
  The above copyright notice and this permission notice shall be included in all
  copies or substantial portions of the Software.
  
  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  SOFTWARE.