Aliyun OSS iOS SDK 使用说明
baocai zhang
1 简介
Aliyun OSS iOS SDK 使用Objective-‐c 实现了Aliyun OSS 提供的功能,主要包括 Bucket 的创建、删除、浏览。Object 的创建、删除浏览以及多点上传等功能, 关于OSS 提供的服务请参考OSS API 说明文档。
2 主要内容
Aliyun OSS iOS SDK 主要包括源代码(BSD 协议开源)、说明文档、示例工程、 在线帮助文档和本地帮助文档等。 在线帮助文档地址:http://osssdkhelp.sinaapp.com/ 本SDK 同样支持在Mac OS X 系统中使用,并提供了相关工程。
3 主要依赖
本SDK 依赖下列主要lib 和framework:
Foundation.framework
CFNetwork.framework
SystemConfiguration.framework
MobileCoreServices.framework
libz.dylib
4 第三方库
本SDK 使用到的第三方类库包括以下部分:
Reachability
ASIHttpRequest
GHKit
tbxml
5 使用步骤
将OSSSDK 和第三方库的源代码或framework 加入到你的应用工程中
在开发中既可以使用源代码的方式也可以使用framework 的方式来使用本SDK 。 2) 添加依赖库的引用,将3 中提到的依赖添加到工程依赖中,依赖库列表如下:
Foundation.framework
CFNetwork.framework
SystemConfiguration.framework
MobileCoreServices.framework
libz.dylib
3) 在build setting 选项中将Other linker Flags 设为-ObjC,
4)使用OSS SDK 进行OSS 对象操作
4.1 在需要使用OSS SDK 的文件中包含OSS 头文件
#import "OSS.h"
4.2 声明OSSClient 类
OSSClient * _client;
4.3 初始化client 对象
_client = [[OSSClient alloc] initWithAccessId:accessid andAccessKey:accesskey];
其中accessid 为OSS 访问需要的accessid,accesskey 为accessid 对应的key。
accessed 和accesskey 的获取请参考OSS 帮助文档。
4.4 设置client 对象的代理,用来响应client 的请求结果 类实现OSSClientDelegate 协议
@interface ViewController ()
将delegate 设为self
_client.delegate = self;
4.5 使用client 的方法进行OSS 对象操作,例如创建bucket [_client createBucket:@"barrycc11"];
4.6 实现OSSClientDelegate 中关于createBucket 的方法,主要是创建成功和创建 失败的方法,用来获取请求的结果。
-(void)bucketCreateFinish:(OSSClient*) client result:(Bucket*) bucket
{
NSLog(@"%@",bucket);
}
-(void)bucketCreateFailed:(OSSClient*) client error:(OSSError*) error
{
NSLog(@"%@",error.errorMessage);
}
其他OSS 对象的操作同样使用上面的流程进行处理。 关于其他方法的使用请参考示例工程和帮助文档。