本文介绍 TOS C++ SDK 的下载地址及安装方式。 ## 环境准备安装 TOS C++ SDK 前，请确保您已安装以下依赖： * C++ 11 及以上版本 * CMake 3.1 及以上版本 * GCC 4.8 及以上版本 * Clang 3.3 及以上版本 * Windows 环境下，要求 Visual Studio 2019 及以上版本 ## 下载地址 * 最新源码地址：[源码地址](https://github.com/volcengine/ve-tos-cpp-sdk) * 示例代码地址：[示例代码](https://github.com/volcengine/ve-tos-cpp-sdk/tree/main/example) * 版本修订记录：[修订记录](https://github.com/volcengine/ve-tos-cpp-sdk/blob/main/CHANGELOG.md) * 历史版本地址：[历史版本](https://github.com/volcengine/ve-tos-cpp-sdk/tags) ## 安装方式 :::warning C++ SDK 暂不支持在 Android 、 Linux ARM 系统安装使用。 ::: ## ```mixin-react return ( ); ``` CMake 编译选项 ### BUILD_SHARED_LIB 默认关闭，CMake 默认只编译静态库。打开后，CMake 会同时编译静态库和动态库，同时 SDK 会链接到动态库。 ```bash cmake .. -DBUILD_SHARED_LIB=ON ``` :::warning 当前在 Windows 环境下不支持 BUILD_SHARED_LIB 编译选项。 ::: ### BUILD_DEMO 默认关闭。打开后，CMake 会对 example 文件夹中的示例进行编译，可直接运行。具体见 example 文件夹中示例。 ```bash cmake .. -DBUILD_DEMO=ON ``` ### BUILD_UNITTEST 默认关闭。打开后 CMake 会编译test文件夹中的单测用例。注意如果需要编译单测部分，要求 cmake 大于3.14。 ```bash cmake .. -DBUILD_UNITTEST=ON ``` ## 升级到 V2 要升级到 TOS C++ SDK V2，需要修改客户端初始化方式。相比于 V1 版本， V2 版本具有以下特点： * 更丰富接口能力，V2 支持更多的接口能力并持续进行迭代。 * 更多的增值功能，V2 部分接口支持事件回调、进度通知、限流等增值特性。 :::tip 后续新增加特性不会在 V1 版本迭代，建议您使用 V2 版本。 ::: ### 修改前客户端初始化 TosClient 客户端如下。 ```cpp #include "TosClient.h" using namespace VolcengineTos; int main(void){ std::string endpoint = "Your Endpoint"; std::string region = "Your Region"; // 从环境变量中获取访问密钥 std::string accessKey = std::getenv("TOS_ACCESS_KEY"); std::string secretKey = std::getenv("TOS_SECRET_KEY"); // 初始化 SDK InitializeClient(); // 初始化交互的 client TosClient client(endpoint, region, accessKey, secretKey); /* 使用 SDK */ // 关闭 SDK CloseClient(); return 0; } ``` ### 修改后客户端初始化 TosClientV2 客户端如下。 ```cpp #include "TosClientV2.h" using namespace VolcengineTos; int main(void){ // 初始化 TOS 账号信息 // Your Region 填写 Bucket 所在 Region std::string region = "Your Region"; std::string accessKey = std::getenv("TOS_ACCESS_KEY"); std::string secretKey = std::getenv("TOS_SECRET_KEY"); // 初始化 SDK InitializeClient(); // 初始化交互的 client TosClientV2 client(region, accessKey, secretKey); /* 使用 SDK */ // 关闭 SDK CloseClient() return 0; } ``` :::warning 升级到 V2 的客户端初始化参数有所变化，endpoint 参数由 Client V1 中的首个必选参数，修改为了 Client V2 中的可选参数。如您仍需指定 endpoint，具体步骤，请参见[设置可选参数](/docs/6349/107398)。 :::

对象存储