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 date | Description | Download 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.
| ons-client-cpp |
2.1.0
Release date | Description | Download link for Windows | Download link for Linux | Download 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.
| No | aliyun-mq-linux-cpp-sdk.tar.gz | aliyun-mq-darwin-cpp-sdk.tar.gz |
2.0.0
Release date | Description | Download link for Windows | Download link for Linux | Download 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.
| No | aliyun-mq-linux-cpp-sdk.tar.gz | aliyun-mq-darwin-cpp-sdk.tar.gz |
1.1.2
Release date | Description | Download link for Windows | Download 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.zip | aliyun-mq-linux-cpp-sdk.tar.gz |
1.1.1
Release date | Description | Download link for Windows | Download 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.zip | aliyun-mq-linux-cpp-sdk.tar.gz |
Earlier versions
1.1.0
Release date | Description | Download link for Windows | Download 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.zip | aliyun-mq-linux-cpp-sdk.tar.gz |
1.0.9
Release date | Description | Download link for Windows | Download 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 date | Description | Download link for Windows | Download 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 date | Description | Download link for Windows | Download 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. |