ApsaraMQ for RocketMQ:C++ SDK (V1.x.x) のセットアップ

パッケージの内容

パッケージを展開すると、ディレクトリには以下が含まれます。

ライブラリファイル

Linux

Windows

オプション 1：静的リンク（推奨）

プロジェクトが既に Boost に依存していない場合にこのオプションを使用します。lib/lib-boost-static/libonsclient4cpp.a に含まれる静的ライブラリは、上記 4 つの Boost ライブラリをすべてバンドルしているため、別途 Boost をインストールする必要はありません。

付属の Makefile を使用したビルド

cd aliyun-mq-linux-cpp-sdk    # 展開後の SDK のルートディレクトリ
cd example                     # トピックおよびアクセスキーを設定するよう、サンプルファイルを編集
make static=1

完全な静的ビルドでは、以下の警告が出力される場合があります。

warning: Using 'gethostbyaddr' in statically linked applications requires at runtime
the shared libraries from the glibc version used for linking

推奨アプローチ：SDK のみを静的リンク

この警告を回避するには、libonsclient4cpp のみを静的リンクし、システムライブラリは動的リンクのままにします。

g++ -ggdb -Wall -O3 -I../include \
    ../example/ProducerExampleForEx.cpp \
    -Wl,-static -lonsclient4cpp -L../lib/lib-boost-static/ \
    -Wl,-Bdynamic -lpthread -ldl -lrt \
    -o ../example/ProducerExampleForEx

オプション 2：動的リンク

プロジェクトが既に Boost に依存している場合、または共有ライブラリを好む場合にこのオプションを使用します。この方法では、ローカルに Boost 1.62.0 をインストールする必要があります。

cd aliyun-mq-linux-cpp-sdk    # 展開後の SDK のルートディレクトリ
cd example                     # トピックおよびアクセスキーを設定するよう、サンプルファイルを編集

g++ -Wall -Wno-deprecated \
    -L ../lib/lib-boost-share/ -I ../include/ \
    ProducerExampleForEx.cpp \
    -lonsclient4cpp -lboost_system -lboost_thread -lboost_chrono -lboost_filesystem \
    -lpthread

export LD_LIBRARY_PATH="../lib/lib-boost-share/"
./a.out

Visual Studio 2015

1. Visual Studio 2015 で新しいプロジェクトを作成します。

2. 構成マネージャー を開き、以下の設定を行います。

   • アクティブなソリューション構成 を リリース に設定

   • アクティブなソリューションプラットフォーム を x64 に設定

3. 出力ディレクトリを構成します。

   • プロパティ > 構成プロパティ > 全般 に移動します。

   • 出力ディレクトリ を任意のディレクトリ（例：C:\myproject\output）に設定します。

   • SDK の lib\64\ ディレクトリ内のすべてのファイルを出力ディレクトリにコピーします。

4. インクルードパスを構成します。

   • プロパティ > 構成プロパティ > C/C++ > 全般 に移動します。

   • 追加のインクルードディレクトリ にディレクトリ（例：C:\myproject\include）を追加します。

   • SDK の include\ ヘッダーファイルをこのディレクトリにコピーします。

5. ライブラリパスを構成します。

   • プロパティ > 構成プロパティ > リンカー > 全般 に移動します。

   • ステップ 3 で指定した出力ディレクトリを、追加のライブラリディレクトリ に追加します。

6. SDK のライブラリ依存関係を追加します。

   • プロパティ > 構成プロパティ > リンカー > 入力 に移動します。

   • ONSClient4CPP.lib を 追加の依存関係 に追加します。

7. プリプロセッサマクロを追加します。

   • プロパティ > 構成プロパティ > C/C++ > プリプロセッサ に移動します。

   • WIN32 を プリプロセッサ定義 に追加します。

8. ビルド をクリックしてコンパイルします。実行可能ファイルを実行する前に、SDK の DLL を出力ディレクトリまたはシステム PATH 内のディレクトリにコピーしてください。

その他の Visual Studio バージョン

1. 上記の Visual Studio 2015 の手順に従ってプロジェクトを構成します。

2. ターゲットマシンに Visual C++ 2015 ランタイム（vc_redist.x64）をインストールします。