SDK versions supported by ApsaraMQ for RocketMQ - ApsaraMQ for RocketMQ

This topic describes the SDK versions supported by ApsaraMQ for RocketMQ.

SDK compatibility description

The following table describes the compatibility between ApsaraMQ for RocketMQ broker versions and client SDK versions. To improve your experience, we recommend that you use ApsaraMQ for RocketMQ 5.x instances. We also recommend that you use Apache RocketMQ 5.x SDKs to access ApsaraMQ for RocketMQ brokers to send and receive messages.

Instance version	Protocol	Client version	Compatibility	Limit
ApsaraMQ for RocketMQ 5.x instance	gRPC v2	Apache RocketMQ 5.x SDKs	Compatible	All features of ApsaraMQ for RocketMQ 5.x instances are supported.
	Remoting	Apache RocketMQ 5.x SDKs	Compatible	The messaging feature is supported. Message trace data and specific metrics cannot be displayed. Note Metrics that are related to producers and consumers cannot be displayed. For more information, see Metric details.
		Apache RocketMQ 4.x and 3.x SDKs	Compatible
		Apache RocketMQ TCP client 1.x SDKs	Compatible
	gRPC v1	ApsaraMQ for RocketMQ TCP client 2.x SDKs	Incompatible	ApsaraMQ for RocketMQ 5.x instances cannot be accessed by using Apache RocketMQ TCP client 2.x SDKs.
	HTTP	ApsaraMQ for RocketMQ HTTP client SDKs	Incompatible	ApsaraMQ for RocketMQ 5.x SDKs do not support the HTTP protocol.
ApsaraMQ for RocketMQ 4.x instance	gRPC v2	ApsaraMQ for RocketMQ 5.x SDKs	Incompatible	You cannot access ApsaraMQ for RocketMQ 4.x instances by using SDKs that correspond to ApsaraMQ for RocketMQ 5.x instances.
	Remoting	Apache RocketMQ 4.x and 3.x SDKs	Compatible	All features of ApsaraMQ for RocketMQ 4.x instances are supported.
	Remoting	Apache RocketMQ TCP client 1.x SDKs	Compatible
	gRPC v1	Apache RocketMQ TCP client 2.x SDKs	Compatible
	HTTP	Apache RocketMQ HTTP client SDKs	Compatible

Apache RocketMQ 5.x SDKs (recommended)

Protocol	Programming language	References
gRPC v2	SDK for Java	Version description Environment preparation Sample code
	SDK for C#	Version description Environment preparation Sample code
	SDK for Go	Version description Environment preparation Sample code
	SDK for Python	Version description Environment preparation Sample code

Apache RocketMQ 5.x SDKs (compatible)

Protocol	Programming language	References
Remoting	SDK for Java	Version description Environment preparation Sample code

Apache RocketMQ 4.x and 3.x SDKs (compatible)

Protocol	Programming language	References
Remoting	SDK for Java	Overview Preparations Sample code
Remoting	SDK for C++	Overview Install the C++ dynamic library Sample code

Apache RocketMQ TCP client 1.x SDKs (compatible)

Protocol	Programming language	References
Remoting	SDK for Java	Release notes Environment preparation Sample code
	SDK for C++	Release notes Environment preparation Sample code
	SDK for .NET	Release notes Environment preparation Sample code