安裝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動態庫預設安裝到系統動態庫目錄下，請確保當前帳號擁有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作業系統核心是Debain系統，使用的預設包管理工具為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動態庫的安裝。

後續步驟

範例程式碼