使用前需知

版本变更

兼容性

• 版本修订记录信息：ChangeLog。
• 推荐使用的Android系统版本：Android 7.0，8.0，8.1，9.0，10.0版本（HTTP/HTTPS协议）。
• jdk1.8环境建议使用3.21.12版本的OBS Android SDK。
• 命名空间：与旧版本（2.1.x）保持兼容，对外的接口都包含在com.obs.services，com.obs.services.model和com.obs.services.exception三个包中。
• 接口函数：与旧版本（2.1.x）保持兼容。

Android 4.4及以下版本只能使用配置HTTP协议访问OBS服务。

其他使用前须知

开发过程中，您有任何问题可以在github上提交issue。接口参考文档详细介绍了每个接口的参数和使用方法。

• 请确认您已经熟悉OBS的基本概念，如桶（Bucket）、对象（Object）、访问密钥（AK和SK）等。
• 您可以先参考OBS客户端通用示例，了解OBS Android SDK接口调用的通用方式。
• 使用OBS客户端进行接口调用操作完成后，没有异常抛出，则表明返回值有效；如果抛出异常，则说明操作失败，此时应可SDK自定义异常实例中获取错误信息。
• 使用OBS客户端进行接口调用成功后，均会返回包含响应头信息的SDK公共响应头实例（或其子类实例）。
• 当前各区域特性开放不一致，部分特性只在部分区域开放，使用过程中如果接口HTTP状态码为405，请确认该区域是否支持该功能特性。