截止目前, QingStorTM 对象存储官方已经发布了包括 Go、Ruby、Swift、Java、JavaScript、PHP、Python、Scala 和 .NET 九种 SDK。为了向 C/C++ 开发者提供更好的支持,QingStorTM 对象存储于近日正式发布 C/C++ SDK。
C/C++ SDK 通过开源的 QingStorTM 对象存储的 API Specifications(OpenAPI 格式,亦称 Swagger 2.0 )及 SDK 生成工具 Snips 来生成相应的 SDK 接口和公共基础部分,在 Snips 的帮助下使其能够在短时间内开发出符合生产环境使用的 SDK 。同时大大降低 SDK 的维护成本,保证各语言版本的 SDK 与最新的官方 API 保持一致。C/C++ SDK 同时提供了标准 C 和 C++ 两套接口,接口内部逻辑用 C++ 统一实现,为了提供更好的兼容性,未使用 C++ 11 特性,能够支持较低版本的编译器和较老的平台运行时环境。
下文为简要使用文档,更多详细信息请参见 https://github.com/yunify/qingstor-sdk-cpp 及 https://docs.qingcloud.com/qingstor/sdk/cpp
1. 安装
本 SDK 目前仅支持源码编译安装方式:
- 安装需要的依赖
Windows 平台:
需要 Visual Studio 2013 或更高版本
自行下载或编译安装 curl(libcurl.lib)
和 openssl(libeay32.lib 和 ssleay32.lib)
相关的第三方库,并手动关联到 Visual Studio 解决方案中.
Linux 平台:
需要 GCC 编译器 4.1.2 或更高版本
安装 SDK 依赖的第三方库的: libcurl 和 libopenssl 。
在 Debian/Ubuntu 系列系统请使用以下命令安装
> sudo apt-get install libcurl4-openssl-dev libssl-dev
在 Redhat/Fedora 系列系统请使用以下命令安装
> sudo yum install libcurl-devel openssl-devel
- 下载源代码
> git clone https://github.com/yunify/qingstor-sdk-cpp.git
- 编译步骤
1.安装 CMake 工具
2.建立 build 目录:
> cd BUILD_DIR > cmake <path-to-root-of-this-source-code>
执行以下命令以编译 Release 版本:
> cmake -DCMAKE_BUILD_TYPE=Release <path-to-root-of-this-source-code> > make > sudo make install
- 编译标准C接口
SDK 默认编译不生成标准 C 接口,如果你希望编译包含标准 C 接口的 SDK ,请执行以下命令:
> cmake -DBUILD_C_STYLE_INTERFACE=ON <path-to-root-of-this-source-code>
本SDK提供了 C 和 C++ 两套接口,这两套接口在使用上方式上有所差别,请您阅读相应的使用说明文档,了解具体细节。