安装CPP动态库

使用C++ SDK接入阿里云云消息队列 RocketMQ 版收发消息前,您需按本文提供的操作步骤安装CPP动态库。

重要
  • 推荐您使用最新的RocketMQ 5.x系列SDK,5.x系列SDK作为主力研发版本,和云消息队列 RocketMQ 版5.x服务端完全兼容,提供了更全面的功能并支持更多增强特性。更多信息,请参见5.x系列SDK
  • RocketMQ 4.x/3.x系列SDK和ONS系列SDK后续仅做功能维护,建议仅存量业务使用。

前提条件

在开始做准备工作前,请确保您的操作系统满足以下条件:

  • Linux:CentOS 6.8、CentOS 7.2、RHEL 6.x、RHEL 7.x

  • Darwin:macOS Mojave 10.14.x

  • Debian:Ubuntu 18.04

说明

本文不提供gcc环境的安装指导,请确保机器的gcc/g++环境版本在4.8以上。

安装CPP动态库

重要

CPP动态库默认安装到系统动态库目录下,请确保当前账号拥有sudo权限或请使用root账号来执行操作。

目前CPP的动态库已经提供了二进制release,可直接获取开源代码。更多信息,请参见Release Notes。为方便安装,本文以社区版2.0.1版本为例,针对不同的操作系统分别进行说明:

  • CentOS 7.2和RHEL 7.x

    CentOS默认支持RPM管理,RPM包名为rocketmq-client-cpp-2.0.1,可以执行以下rpm命令直接安装。

    rpm -ivh https://github.com/apache/rocketmq-client-cpp/releases/download/2.0.1/rocketmq-client-cpp-2.0.1-centos7.x86_64.rpm

  • CentOS 6.8和RHEL 6.x

    CentOS 6.8与CentOS 7相比,安装步骤相同,仅使用的RPM包不一样,参考以下命令。

    rpm -ivh https://github.com/apache/rocketmq-client-cpp/releases/download/2.0.1/rocketmq-client-cpp-2.0.1-centos6.x86_64.rpm

  • macOS Mojave 10.14

    macOS下不提供包管理工具,您可以执行以下命令手动安装动态库。

    mkdir cppsdk
    cd cppsdk
    wget https://github.com/apache/rocketmq-client-cpp/releases/download/2.0.1/rocketmq-client-cpp-2.0.1-bin-release-darwin.tar.gz
    tar -xzf rocketmq-client-cpp-2.0.1-bin-release-darwin.tar.gz
    cp rocketmq-client-cpp/lib/* /usr/local/lib/
    mkdir -p /usr/local/include/rocketmq/
    cp rocketmq-client-cpp/include/* /usr/local/include/rocketmq/
    install_name_tool -id "@rpath/librocketmq.dylib" /usr/local/lib/librocketmq.dylib
  • Ubuntu 18.04

    Ubuntu 18.04操作系统内核是Debian系统,使用的默认包管理工具为dpkg,包名为rocketmq-client-cpp-2.0.1.amd64.deb。您可执行以下命令安装。

    wget https://github.com/apache/rocketmq-client-cpp/releases/download/2.0.1/rocketmq-client-cpp-2.0.1.amd64.deb
    dpkg -i rocketmq-client-cpp-2.0.1.amd64.deb

至此,您已完成CPP动态库的安装。

后续步骤

示例代码