This topic describes the release notes for the TCP client SDK for C++. The release notes include the release date, download link, and feature updates for each release. You can select a version of the TCP client SDK for C++ that meets your business requirements to send and receive messages based on the description of this topic.

After you obtain the TCP client SDK for C++, you must prepare an environment based on the usage notes of the SDK for C++. The procedure for preparing an environment varies based on the version of the SDK.
  • For information about how to prepare an environment for the SDK V2.0.0 or later, see Environment preparation (V2.X.X).
  • For information about how to prepare an environment for the SDK V1.x.x and how to upgrade the SDK to V2.0.0, see Environment preparation (V1.X.X).
  • You can use the TCP client SDK for C++ V3.x.x to access only instances that contain namespaces. If the instance that you use does not contain a namespace, do not upgrade the TCP client SDK for C++ to V3.x.x.

    By default, all ApsaraMQ for RocketMQ 5.x instances contain namespaces. If you use a ApsaraMQ for RocketMQ 4.x instance, you can check whether the instance contains a namespace in the Basic Information section of the Instance Details page in the ApsaraMQ for RocketMQ console.

3.x.x

Release dateDescriptionDownload link
2021-10-18

Optimized feature

  • Load balancing: Load balancing is performed based on messages. This makes message loads more balanced.
  • Dashboard: Various metrics are added. The added metrics include the number of accumulated messages and the duration and success rate of each step from message production to message consumption.
  • Message tracing: More parameters are included in trace query results. These parameters are related to scheduled messages, delayed messages, transactional messages, and message consumption.
  • Ordered messages: The maximum number of retries is changed to 16.
  • Broadcasting consumption: The consumer offset can be customized when you start a consumer.
  • Push mode: The consumption throttling feature is supported. The processing logic for scenarios in which the number of consumption threads is abnormal is optimized.
  • Changes in API operations.
Note For more information, see Release notes for the SDK for C++.
ons-client-cpp

2.1.1

Release dateDescriptionDownload link for WindowsDownload link for LinuxDownload link for Darwin
TAR.GZDebianRPM
2020-11-26

Added features

  • The 64-bit version of Windows is supported.

Fixed issues

  • The maximum heap memory of Substrate VM (SVM) is 64 MB, and the maximum runtime memory is 300 MB.
aliyun-ons-win64-sdk.zipaliyun-mq-linux-cpp-sdk.tar.gzaliyun-mq-linux-cpp-amd64.debaliyun-mq-linux-cpp-1.alios7.x86-64.rpmaliyun-mq-darwin-cpp-sdk.tar.gz

2.1.0

Release dateDescriptionDownload link for WindowsDownload link for LinuxDownload link for Darwin
2020-11-06

Fixed issues

  • The ROCKETMQ_LOG_HOME environment variable and the ONSFactoryProperty::LogPath configuration item can be used to specify a log path.
  • The following issue is fixed: The Count the Number of Trailing Zero Bits (TZCNT) instruction causes message bodies to be truncated in the Sandy Bridge microarchitecture.
  • The ons::Message(const std::string&topic, const std::string&body) constructor is added to ensure compatibility with V1.x.x.
Noaliyun-mq-linux-cpp-sdk.tar.gzaliyun-mq-darwin-cpp-sdk.tar.gz

2.0.0

Release dateDescriptionDownload link for WindowsDownload link for LinuxDownload link for Darwin
2019-06-28

Added features

  • A native image is used to generate a C++ native library based on the kernel of the SDK for Java V1.8.0. The features of the SDK for C++ V2.0.0 are the same as those of the SDK for Java V1.8.0.
  • Backward compatibility is ensured based on the interfaces of ons-cpp V1.x.x.
  • Faster startup and more efficient execution are supported with no need to use third-party dependencies.
Noaliyun-mq-linux-cpp-sdk.tar.gzaliyun-mq-darwin-cpp-sdk.tar.gz

1.1.2

Release dateDescriptionDownload link for WindowsDownload link for Linux
2019-01-16

Added features

  • The following methods of accessing ApsaraMQ for RocketMQ are available for users who use instantiated resources. The access methods for users who do not use instantiated resources remain unchanged.
    • Configure NAMESRV_ADDR that contains InstanceId.
    • Configure InstanceId and NAMESRV_ADDR that does not contain InstanceId.
  • Producer IDs and consumer IDs are replaced with group IDs.
aliyun-mq-windows-cpp-sdk.zipaliyun-mq-linux-cpp-sdk.tar.gz

1.1.1

Release dateDescriptionDownload link for WindowsDownload link for Linux
2018-07-31

Added features

  • SSL encryption is supported for message transmission. Take note that this feature is available only in ApsaraMQ for RocketMQ Enterprise Platinum Edition.
  • The PushConsumer class can be used to pull messages in asynchronous mode at a higher speed.

Fixed issues

  • The issues related to ordered messages are fixed.
  • The logging feature is optimized to return logs only when rebalancing results change.
  • The following issue is fixed: The system flag cannot be serialized to the header of a one-way request.
aliyun-mq-windows-cpp-sdk.zipaliyun-mq-linux-cpp-sdk.tar.gz

Earlier versions

1.1.0

Release dateDescriptionDownload link for WindowsDownload link for Linux
2017-07-25

Fixed issues

  • The following issue is fixed: Core dumps are caused when a consumer is shut down.
  • The following issue is fixed: Access over HTTP is unavailable to the underlying URL class in Windows.
  • The following issue is fixed: Timestamp errors occur in message traces.
  • The following issue is fixed: Incorrect local IP addresses are displayed in message traces.
  • Memory leaks in Windows are fixed.
aliyun-mq-windows-cpp-sdk.zipaliyun-mq-linux-cpp-sdk.tar.gz

1.0.9

Release dateDescriptionDownload link for WindowsDownload link for Linux
2016-12-29

Added features

  • Messages can be sent in one-way mode.
  • Ordered messages are supported.
  • The timeout period for sending messages can be set.
  • The maximum number of retries for messages can be set.

Fixed issues

  • Resource leaks during shutdown are fixed.
  • Core dumps during shutdown are fixed.
None.None.

1.0.8

Release dateDescriptionDownload link for WindowsDownload link for Linux
2016-12-02

Added features

  • The earlier version of the SDK for C# is no longer supported. An updated version of the SDK for C# is generated by using SWIG. The updated version provides more stable support for ASP.NET.
  • Log paths can be customized.
  • Built-in UTF-8 encoding is provided to support implicit encoding and decoding.
  • The MQ_GUIDE documentation is provided. The ASP.NET demo is provided.

Optimized features

  • The boost library is updated to V1.6.2.

Fixed issues

  • The following issue is fixed: Core dumps occur when the producers or consumers of ordered messages are shut down.
None.None.

1.0.7

Release dateDescriptionDownload link for WindowsDownload link for Linux
2016-11-15

Added features

  • Consumption throttling is supported for consumers. By default, 1,000 messages are pulled and stored in the memory and then called back by the callback function one by one.
  • Ordered messages are supported.
  • The timeout period for sending messages can be set.
  • The maximum number of retries for messages can be set.

Optimized features

  • The message tracing feature is optimized. A separate thread pool is used to send trace data.
  • The granularity of the TCP lock is optimized.

Fixed issues

  • Issues related to message tracing are fixed.
  • Core dumps caused by shutdown are fixed.
  • Memory leaks are fixed.
  • The following issue is fixed: An exception is thrown if a message tag contains double vertical bars (||).
None.None.