安装SDK工具包

安装步骤

  1. 官方网站下载SDK压缩包。
  2. 解压得到frameworks。frameworks包含Basic、BOS和STS三部分,其中Basic和BOS为必须部分,STS根据是否进行临时授权可选。
  3. 根据需要将frameworks复制到您的Xcode工程目录下,例如lib目录。
  4. 在Xcode右键工程->Add files to "your project",导入您刚才复制的frameworks。
  5. 在Build Setttings中的Other Linker Flags选项里需要加上-ObjC。

配置 App Transport Security (ATS)

说明:如果BOS使用https endpoint则不需要进行ATS相关配置,只有使用http endpoint时需要配置info.plist文件。

从 iOS 9.0 和 OS X v10.11 开始,App Transport Security (ATS)功能默认开启。ATS强制使用HTTPS访问Web服务,并且必须使用TLS v1.2以上版本保证通信的安全性。ATS的详细需求请参考:Requirements for Connecting

如果App支持iOS 9.0而且需要访问不满足上述要求的Web服务,必须在info.plist文件中使用 NSAppTransportSecurity元素添加例外处理规则。NSAppTransportSecurity的使用方法请参考:App Transport Security

SDK目录结构

Baidu-BOS-SDK-iOS-v1.0.0
|_BaiduBCEBasic.framework                   // 基础模块
| |____Headers
|   |____BCEClient.h                        // BCE服务基类
|   |____BCEClientConfiguration.h           // BCE服务配置基类
|   |____BCECredentials.h                   // BCE AK、SK签名类
|   |____BCEError.h                         // BCE通用的错误码
|   |____BCERegion.h                        // BCE提供服务的区域
|   |____BCERequest.h                       // BCE网络请求类
|   |____BCEResponse.h                      // BCE网络响应类
|   |____BCEResponseMetadata.h              // BCE网络响应元数据类
|   |____BCESTSCredentials.h                // BCE临时授权签名类
|   |____BCETask.h                          // BCE通用的任务类
|
|_BaiduBCEBOS.framework                     // BOS模块
| |____Headers
|   |____BOSClient.h                        // BOS客户端入口类
|   |____BOSClientConfiguration.h           // BOS特有的Client配置
|   |____BOSListBucketModel.h               // 罗列Bucket相关类
|   |____BOSGetOBjectModel.h                // 下载Object相关类
|   |____ .
|   |____ .                                 // ...
|   |____ .
|   |____BOSPutObjectModel.h                // 上传Object相关类
|
|_BaiduBCESTS.framework                     // STS授权模块
| |____Headers
|   |____STSClient.h                        // STS服务入口类
|   |____STSClientConfiguration.h           // STS特有的Client配置
|   |____STSGetSessionTokenModel.h          // 获取token相关类