文档中心

对象存储

请输入

C++

安装 C++ SDK

本文介绍 TOS C++ SDK 的下载地址及安装方式。

环境准备

安装 TOS C++ SDK 前，请确保您已安装以下依赖：

C++ 11 及以上版本

CMake 3.1 及以上版本

GCC 4.8 及以上版本

Clang 3.3 及以上版本

Windows 环境下，要求 Visual Studio 2019 及以上版本

下载地址

最新源码地址：源码地址

示例代码地址：示例代码

版本修订记录：修订记录

历史版本地址：历史版本

安装方式

注意

C++ SDK 暂不支持在 Android 、 Linux ARM 系统安装使用。

通过源码编译

Linux

macOS

Windows

注意

SDK 依赖 libcurl 和 openssl 两个库。在构建 SDK 之前，请确保您已安装这两个库。

下载源码。您可以通过以下方式下载源码：

直接下载：TOS C++ SDK 的源码地址，请参见 TOS C++ SDK。最新版本请以 Git 更新为准。

通过 Git 下载：执行以下命令，将源码克隆到本地。

git clone https://github.com/volcengine/ve-tos-cpp-sdk

执行以下命令，使用 CMake 3.1 及以上版本构建。

cd ve-tos-cpp-sdk
mkdir build
cd build

CMake 编译选项

BUILD_SHARED_LIB

默认关闭，CMake 默认只编译静态库。打开后，CMake 会同时编译静态库和动态库，同时 SDK 会链接到动态库。

注意

当前在 Windows 环境下不支持 BUILD_SHARED_LIB 编译选项。

BUILD_DEMO

默认关闭。打开后，CMake 会对 example 文件夹中的示例进行编译，可直接运行。具体见 example 文件夹中示例。

BUILD_UNITTEST

默认关闭。打开后 CMake 会编译test文件夹中的单测用例。注意如果需要编译单测部分，要求 cmake 大于3.14。

升级到 V2

要升级到 TOS C++ SDK V2，需要修改客户端初始化方式。相比于 V1 版本， V2 版本具有以下特点：

更丰富接口能力，V2 支持更多的接口能力并持续进行迭代。

更多的增值功能，V2 部分接口支持事件回调、进度通知、限流等增值特性。

说明

后续新增加特性不会在 V1 版本迭代，建议您使用 V2 版本。

修改前

客户端初始化 TosClient 客户端如下。

修改后

客户端初始化 TosClientV2 客户端如下。

注意

升级到 V2 的客户端初始化参数有所变化，endpoint 参数由 Client V1 中的首个必选参数，修改为了 Client V2 中的可选参数。如您仍需指定 endpoint，具体步骤，请参见设置可选参数。

最近更新时间：2025.09.10 14:18:26

这个页面对您有帮助吗？

有用

无用