QingStor 对象存储的 C/C++ SDK 已在 GitHub 开源,本文为简要使用文档。更多详细信息请参见 GitHub 项目

本 SDK 使用 Snips 工具生成,各接口的调用均与 QingStor 对象存储的 API 相对应。其返回码、请求头、错误码等规定请参照具体的 Qingstor API 文档。

本 SDK 提供了 C 和 C++ 两套接口,这两套接口在使用上方式上有所差别,请您阅读相应的使用说明文档,了解具体细节。

安装

本 SDK 目前仅支持源码编译安装方式,详细操作如下。

安装依赖

  • 需在本地安装 Visual Studio 2013 或更高版本,或者 GCC 编译器 4.1.2 或更高版本。

  • 若用户使用 Linux 平台进行编译,还需安装 SDK 依赖的第三方库:libcurl 和 libopenssl。可以参照以下操作步骤。

    • 在 Debian/Ubuntu 系列系统请使用以下命令行安装。

      sudo apt-get install libcurl4-openssl-dev libssl-dev
    • 在 Redhat/Fedora 系列系统请使用以下命令行安装。

      sudo yum install libcurl-devel openssl-devel

获取源码

qingstor-sdk 目前正在 GitHub 上活跃开发中,代码开源在此处。您可以执行如下命令行 Clone 这个公开的仓库。

git clone https://github.com/yunify/qingstor-sdk-cpp.git

编译步骤

  1. 安装 CMake 工具。若您当前使用的 CMake 工具版本低于 2.8,请参照 CMake 的官方安装指导下载安装最新版本,或通过源码编译安装。

  2. 创建 build 目录:

    cd BUILD_DIR
    cmake <path-to-root-of-this-source-code>
  3. 若用户需要编译 Release 版本,请执行以下 CMake 命令。

    cmake -DCMAKE_BUILD_TYPE=Release  <path-to-root-of-this-source-code>
    make
    sudo make install

编译标准 C 接口

SDK 默认编译不生成标准 C 接口,若用户希望编译包含标准 C 接口的 SDK,请执行以下 CMake 命令。

cmake -DBUILD_C_STYLE_INTERFACE=ON  <path-to-root-of-this-source-code>