The .NET Implementation of Apache RocketMQ Client

Here is the .NET implementation of the client for Apache RocketMQ.

Supported .NET Versions

Due to the release of .NET 5 in 2020, which unified .NET Framework and .NET Core, and has gradually become the mainstream platform for .NET development, the RocketMQ client will support .NET 5 and later versions.

See more details about .NET 5 from Introducing .NET 5.

Architecture

The client would be developed using the protocols outlined in rocketmq-apis and built on gRPC-dotnet, leveraging Protocol Buffers for data serialization and deserialization during transmission.

Quickstart & Build

dotnet add package RocketMQ.Client

You can obtain the latest version of RocketMQ.Client from NuGet Gallery. To assist with getting started quickly and working with various message types and clients, we offer examples here.

Layout of this project roughly follows this guide. The solution contains a class library, a unit test module and an example console module. Assuming you are at the home of this repository:

# build the project
dotnet build
# run unit tests
dotnet test -l "console;verbosity=detailed"

Publishing Steps

1. Open the command prompt, and change the directory to the project folder that you want to package.
2. Run the dotnet pack --configuration Release command. This will create a NuGet package in the bin/Release folder of the project.
3. To upload the package to NuGet, go to the NuGet website and sign in. Click on the "Upload" button and select the package file from the bin/Release folder.
4. Follow the instructions on the website to complete the upload process. Once the package is uploaded, it will be available for others to download and use.