COS 兼容 aws-sdk-ios 指南

EricCheung

目前COS支持了通过Path-Style的方式来访问，所以使用Path-Style的Amazon iOS SDK也可以在COS上面使用了。

1. Amazon iOS S3 SDK 地址

Github地址 https://github.com/aws/aws-sdk-ios

2. 一小步适配工作

使用 AWS iOS SDK 向 COS 发出的例如 Put Bucket Life Cycle 的请求是没有包含Content-MD5这个Header的，所以需要通过插件的
方式加进去。在这里我们可以Hook签名的方法，在最后把这个Header加进去。简单地讲，就是在项目里创建AWSSignatureV4Signer+ExtraSignatureSteps.h 和 AWSSignatureV4Signer+ExtraSignatureSteps.m 这两个文件，并且将下面的代码粘贴到对应的文件里即可。

AWSSignatureV4Signer+ExtraSignatureSteps.h ：

1. //
   
2. //  AWSSignatureV4Signer+ExtraSignatureSteps.h
   
3. //  S3TransferManagerSample
   
4. //
   
5. //  
   
6. //  Copyright © 2017 Amazon Web Services. All rights reserved.
   
7. //
   
8. 
   
9. #import <AWSCore/AWSCore.h>
   
10. 
    
11. @interface AWSSignatureV4Signer (ExtraSignatureSteps)
    
12. 
    
13. @end
    

复制代码

AWSSignatureV4Signer+ExtraSignatureSteps.m：

1. //
   
2. //  AWSSignatureV4Signer+ExtraSignatureSteps.m
   
3. //  S3TransferManagerSample
   
4. //
   
5. //  
   
6. //  Copyright © 2017 Amazon Web Services. All rights reserved.
   
7. //
   
8. 
   
9. #import "AWSSignatureV4Signer+ExtraSignatureSteps.h"
   
10. #import <objc/runtime.h>
    
11. @implementation AWSSignatureV4Signer (ExtraSignatureSteps)
    
12. + (void)load {
    
13.     static dispatch_once_t onceToken;
    
14.     dispatch_once(&onceToken, ^{
    
15.         Class class = [self class];
    
16.         
    
17.         SEL originalSelector = @selector(signRequestV4:credentials:);
    
18.         SEL swizzledSelector = @selector(swizzle_signRequestV4:credentails:);
    
19.         
    
20.         Method originalMethod = class_getInstanceMethod(class, originalSelector);
    
21.         Method swizzledMethod = class_getInstanceMethod(class, swizzledSelector);
    
22.         
    
23. 
    
24.         
    
25.         BOOL didAddMethod =
    
26.         class_addMethod(class,
    
27.                         originalSelector,
    
28.                         method_getImplementation(swizzledMethod),
    
29.                         method_getTypeEncoding(swizzledMethod));
    
30.         
    
31.         if (didAddMethod) {
    
32.             class_replaceMethod(class,
    
33.                                 swizzledSelector,
    
34.                                 method_getImplementation(originalMethod),
    
35.                                 method_getTypeEncoding(originalMethod));
    
36.         } else {
    
37.             method_exchangeImplementations(originalMethod, swizzledMethod);
    
38.         }
    
39.     });
    
40. }
    
41. 
    
42. 
    
43. - (NSString*)swizzle_signRequestV4:(NSMutableURLRequest*)request credentails:(AWSCredentials*)credentials {
    
44.     NSString* authentication = [self swizzle_signRequestV4:request credentails:credentials];
    
45.    
    
46.     //added by eric
    
47.     if (([ request.HTTPMethod i**alToString:@"PUT"] && ([[[request URL] query] hasPrefix:@"tagging"] ||
    
48.                                                           [[[request URL] query] hasPrefix:@"lifecycle"] ||
    
49.                                                           [[[request URL] query] hasPrefix:@"cors"]))
    
50.         || ([request.HTTPMethod i**alToString:@"POST"] && [[[request URL] query] hasPrefix:@"delete"])
    
51.         ) {
    
52.         if (![request valueForHTTPHeaderField:@"Content-MD5"]) {
    
53.             [request setValue:[NSString aws_base64md5FromData:request.HTTPBody] forHTTPHeaderField:@"Content-MD5"];
    
54.         }
    
55.     }
    
56.     //add end
    
57.     return authentication;
    
58.    
    
59. }
    
60. @end
    

复制代码

然后完成，就可以直接使用AWS iOS SDK的所有功能了。

3. 使用指南

因为是向COS发请求，所以要在初始化时候配置为COS的域名。下面演示了一段初始化的过程，可以参照代码和注释来进行操作。

1. - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
   
2. {
   
3.    
   
4. //以Region为ap-guangzhou为例，那么域名就是cos.ap-guangzhou.myqcloud.com。
   
5. //如果使用的是其它的region，那么对应的域名就是cos.<region>.myqcloud.com, <region>指的是具体的地域名称，例如ap-beijing等等
   
6.     NSURL* bucketURL = [NSURL URLWithString:@"http://cos.ap-guangzhou.myqcloud.com"];
   
7.    
   
8.     AWSEndpoint* endpoint = [[AWSEndpoint alloc] initWithRegion:AWSRegionUnknown service:AWSServiceS3 URL:bucketURL];
   
9. 
   
10. //设置Secret ID与Secret Key
    
11. //如果使用的是临时签名的话，可以生成一个[[AWSBasicSessionCredentialsProvider alloc] initWithAccessKey:@"临时的Secret ID" secretKey:@"临时的SecretKey" sessionToken:@"临时密钥的token"]
    
12. 
    
13. 
    
14.     self.credentialProvider = [[AWSStaticCredentialsProvider alloc] initWithAccessKey:@"填入COS的Secret ID" secretKey:@"填入COS的Secret Key"];
    
15. 
    
16.    
    
17. //这里的Region其实无所谓，可以随便选一个
    
18.     AWSServiceConfiguration* configuration = [[AWSServiceConfiguration alloc] initWithRegion:AWSRegionCNNorth1 endpoint:endpoint credentialsProvider:self.credentialProvider];
    
19.         
    
20.     [[AWSServiceManager defaultServiceManager] setDefaultServiceConfiguration:configuration];
    
21.     return YES;
    
22. }

复制代码

还有一点需要注意的是，在使用AWS接口的时候，Bucket需要填 <name>-<Appid>的形式，例如 test-123456789 ，才可以正常访问。

剩下的就可以直接按照AWS的文档来操作了，COS是兼容的。