fix: AliyunOSSiOS.frameworupgrade

Example/ios/AliyunOSSiOS.framework/Headers/AliyunOSSiOS.h

@@ -6,7 +6,7 @@
 //  Copyright © 2016 xuyecan. All rights reserved.
 //
 
-#import <UIKit/UIKit.h>
+#import <Foundation/Foundation.h>
 
 //! Project version number for AliyunOSSiOS.
 FOUNDATION_EXPORT double AliyunOSSiOSVersionNumber;
@@ -18,3 +18,4 @@ FOUNDATION_EXPORT const unsigned char AliyunOSSiOSVersionString[];
 
 #import "OSSService.h"
 #import "OSSCompat.h"
+#import "OSSXMLDictionary.h"

Example/ios/AliyunOSSiOS.framework/Headers/NSMutableData+OSS_CRC.h

@@ -0,0 +1,15 @@
+//
+//  NSMutableData+OSS_CRC.h
+//  AliyunOSSSDK
+//
+//  Created by 怀叙 on 2017/11/29.
+//  Copyright © 2017年 阿里云. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+@interface NSMutableData (OSS_CRC)
+
+- (uint64_t)oss_crc64;
+
+@end

Example/ios/AliyunOSSiOS.framework/Headers/OSSAllRequestNeededMessage.h

@@ -0,0 +1,56 @@
+//
+//  OSSAllRequestNeededMessage.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/22.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "OSSConstants.h"
+#import "OSSTask.h"
+
+/**
+ All necessary information in one OSS request.
+ */
+@interface OSSAllRequestNeededMessage : NSObject
+@property (nonatomic, strong) NSString * endpoint;
+@property (nonatomic, strong) NSString * httpMethod;
+@property (nonatomic, strong) NSString * bucketName;
+@property (nonatomic, strong) NSString * objectKey;
+@property (nonatomic, strong) NSString * contentType;
+@property (nonatomic, strong) NSString * contentMd5;
+@property (nonatomic, strong) NSString * range;
+@property (nonatomic, strong) NSString * date;
+@property (nonatomic, strong) NSMutableDictionary * headerParams;
+@property (nonatomic, copy) NSDictionary * querys;
+@property (nonatomic, copy) NSString *contentSHA1;
+
+@property (nonatomic, assign) BOOL isHostInCnameExcludeList;
+
+- (instancetype)initWithEndpoint:(NSString *)endpoint
+                      httpMethod:(NSString *)httpMethod
+                      bucketName:(NSString *)bucketName
+                       objectKey:(NSString *)objectKey
+                            type:(NSString *)contentType
+                             md5:(NSString *)contentMd5
+                           range:(NSString *)range
+                            date:(NSString *)date
+                    headerParams:(NSMutableDictionary *)headerParams
+                          querys:(NSMutableDictionary *)querys __attribute__((deprecated("Use -initWithEndpoint:httpMethod:bucketName:objectKey:type:md5:range:date:headerParams:querys:sha1: instead")));
+
+- (instancetype)initWithEndpoint:(NSString *)endpoint
+                      httpMethod:(NSString *)httpMethod
+                      bucketName:(NSString *)bucketName
+                       objectKey:(NSString *)objectKey
+                            type:(NSString *)contentType
+                             md5:(NSString *)contentMd5
+                           range:(NSString *)range
+                            date:(NSString *)date
+                    headerParams:(NSMutableDictionary *)headerParams
+                          querys:(NSMutableDictionary *)querys
+                            sha1:(NSString *)contentSHA1;
+
+- (OSSTask *)validateRequestParamsInOperationType:(OSSOperationType)operType;
+
+@end

Example/ios/AliyunOSSiOS.framework/Headers/OSSCancellationToken.h

@@ -17,7 +17,7 @@ NS_ASSUME_NONNULL_BEGIN
 /*!
  A block that will be called when a token is cancelled.
  */
-typedef void(^OSSCancellationBlock)();
+typedef void(^OSSCancellationBlock)(void);
 
 /*!
  The consumer view of a CancellationToken.

Example/ios/AliyunOSSiOS.framework/Headers/OSSClient.h

@@ -14,19 +14,25 @@
 @class OSSGetBucketRequest;
 @class OSSGetBucketACLRequest;
 @class OSSGetObjectRequest;
+@class OSSGetObjectACLRequest;
 @class OSSPutObjectRequest;
 @class OSSPutObjectACLRequest;
 @class OSSDeleteObjectRequest;
+@class OSSDeleteMultipleObjectsRequest;
 @class OSSCopyObjectRequest;
 @class OSSInitMultipartUploadRequest;
 @class OSSUploadPartRequest;
 @class OSSCompleteMultipartUploadRequest;
 @class OSSListPartsRequest;
+@class OSSListMultipartUploadsRequest;
 @class OSSAbortMultipartUploadRequest;
 @class OSSAppendObjectRequest;
 @class OSSResumableUploadRequest;
+@class OSSMultipartUploadRequest;
 @class OSSTask;
 @class OSSExecutor;
+@class OSSCallBackRequest;
+@class OSSImagePersistRequest;
 
 @class OSSNetworking;
 @class OSSClientConfiguration;
@@ -35,49 +41,51 @@
 NS_ASSUME_NONNULL_BEGIN
 
 /**
- OSSClient是OSS服务的iOS客户端，它为调用者提供了一系列的方法，用于和OSS服务进行交互。
- 一般来说，全局内只需要保持一个OSSClient，用来调用各种操作。
+ OSSClient is the entry class to access OSS in an iOS client. It provides all the methods to communicate with OSS.
+ Generally speaking, only one instance of OSSClient is needed in the whole app.
  */
 @interface OSSClient : NSObject
 
 /**
- OSS访问域名
+ OSS endpoint. It varies in different regions. Please check out OSS official website for the exact endpoints for your data.
  */
 @property (nonatomic, strong) NSString * endpoint;
 
 /**
- 用以收发网络请求
+ The networking instance for sending and receiving data
  */
 @property (nonatomic, strong) OSSNetworking * networking;
 
 /**
- 提供访问所需凭证
+ The credential provider instance
  */
 @property (nonatomic, strong) id<OSSCredentialProvider> credentialProvider;
 
 /**
- 客户端设置
+ Client configuration instance
  */
 @property (nonatomic, strong) OSSClientConfiguration * clientConfiguration;
 
 /**
- 任务队列
+ oss operation task queue
  */
 @property (nonatomic, strong, readonly) OSSExecutor * ossOperationExecutor;
 
 /**
- 初始化OSSClient，使用默认的本地设置
- @endpoint 指明Bucket所在的Region域名，2017年以后苹果要求APP符合ATS政策，这里要写https的endpoint，如 "https://oss-cn-hangzhou.aliyuncs.com"
- @credentialProvider 需要实现的签名器
+ Initializes an OSSClient instance with the default client configuration.
+ @endpoint it specifies domain of the bucket's region. Starting 2017, the domain must be prefixed with "https://" to follow Apple's ATS policy.
+             For example: "https://oss-cn-hangzhou.aliyuncs.com"
+ @credentialProvider The credential provider
  */
 - (instancetype)initWithEndpoint:(NSString *)endpoint
               credentialProvider:(id<OSSCredentialProvider>) credentialProvider;
 
 /**
- 初始化OSSClient，使用自定义设置
- @endpoint 指明Bucket所在的Region域名，2017年以后苹果要求APP符合ATS政策，这里要写https的endpoint，如 "https://oss-cn-hangzhou.aliyuncs.com"
- @credentialProvider 需要实现的签名器
- @conf 可以设置一些本地参数如重试次数、超时时间等
+ Initializes an OSSClient with the custom client configuration.
+ @endpoint it specifies domain of the bucket's region. Starting 2017, the domain must be prefixed with "https://" to follow Apple's ATS policy.
+             For example: "https://oss-cn-hangzhou.aliyuncs.com"
+ @credentialProvider The credential provider
+ @conf The custom client configuration such as retry time, timeout values, etc.
  */
 - (instancetype)initWithEndpoint:(NSString *)endpoint
               credentialProvider:(id<OSSCredentialProvider>)credentialProvider
@@ -86,188 +94,257 @@ NS_ASSUME_NONNULL_BEGIN
 #pragma mark restful-api
 
 /**
- 对应RESTFul API：GetService
- 获取请求者当前拥有的全部Bucket。
- 注意：
- 1. 尚不支持STS;
- 2. 当所有的bucket都返回时，返回的xml中不包含Prefix、Marker、MaxKeys、IsTruncated、NextMarker节点，如果还有部分结果未返回，则增加上述节点，其中NextMarker用于继续查询时给marker赋值。
+ The corresponding RESTFul API: GetService
+ Gets all the buckets of the current user
+ Notes：
+ 1. STS is not supported yet in this call.
+ 2. When all buckets are returned, the xml in response body does not have nodes of Prefix, Marker, MaxKeys, IsTruncated and NextMarker.
+    If there're remaining buckets to return, the xml will have these nodes. The nextMarker is the value of marker in the next call.
  */
 - (OSSTask *)getService:(OSSGetServiceRequest *)request;
 
 /**
- 对应RESTFul API：PutBucket
- 用于创建Bucket（不支持匿名访问）。默认情况下，创建的Bucket位于默认的数据中心：oss-cn-hangzhou。
- 用户可以显式指定Bucket位于的数据中心，从而最优化延迟，最小化费用或者满足监管要求等。
- 注意：
- 1. 尚不支持STS。
+ The corresponding RESTFul API: PutBucket
+ Creates a bucket--it does not support anonymous access. By default, the datacenter used is oss-cn-hangzhou.
+ Callers could explicitly specify the datacenter for the bucket to optimize the performance and cost or meet the regulation requirement.
+ Notes:
+ 1. STS is not supported yet.
  */
 - (OSSTask *)createBucket:(OSSCreateBucketRequest *)request;
 
 /**
- 对应RESTFul API：DeleteBucket
- 用于删除某个Bucket。
+ The corresponding RESTFul API: DeleteBucket
+ Deletes a bucket.
  */
 - (OSSTask *)deleteBucket:(OSSDeleteBucketRequest *)request;
 
 /**
- 对应RESTFul API：GetBucket
- 用来list Bucket中所有Object的信息，可以通过prefix，marker，delimiter和max-keys对list做限定，返回部分结果。
+The corresponding RESTFul API: GetBucket
+ Lists all objects in a bucket. It could be specified with filters such as prefix, marker, delimeter and max-keys.
  */
 - (OSSTask *)getBucket:(OSSGetBucketRequest *)request;
 
 /**
- 对应RESTFul API：GetBucketACL
- 用来获取某个Bucket的访问权限。
+The corresponding RESTFul API: GetBucketACL
+ Gets the bucket ACL.
  */
 - (OSSTask *)getBucketACL:(OSSGetBucketACLRequest *)request;
 
 /**
- 对应RESTFul API：HeadObject
- 只返回某个Object的meta信息，不返回文件内容。
+The corresponding RESTFul API: HeadObject
+ Gets the object's metadata information. The object's content is not returned.
  */
 - (OSSTask *)headObject:(OSSHeadObjectRequest *)request;
 
 /**
- 对应RESTFul API：GetObject
- 用于获取某个Object，此操作要求用户对该Object有读权限。
+The corresponding RESTFul API: GetObject
+ Gets the whole object (includes content). It requires caller have read permission on the object.
  */
 - (OSSTask *)getObject:(OSSGetObjectRequest *)request;
 
 /**
- 对应RESTFul API：PutObject
- 用于上传文件。
+ * Gets the Access Control List (ACL) of the OSS object.
+ *
+ * @param bucketName
+ *            Bucket name.
+ * @param key
+ *            Object Key.
+ * @return The OSSTask with result of objectAcls instance of the object.
+ */
+- (OSSTask *)getObjectACL:(OSSGetObjectACLRequest *)request;
+
+/**
+The corresponding RESTFul API: PutObject
+ Uploads a file.
  */
 - (OSSTask *)putObject:(OSSPutObjectRequest *)request;
 
 /**
- Put Object ACL接口用于修改Object的访问权限。目前Object有三种访问权限：private, public-read, public-read-write。
- Put Object ACL操作通过Put请求中的“x-oss-object-acl”头来设置，这个操作只有Bucket Owner有权限执行。如果操作成功，则返回200；否则返回相应的错误码和提示信息。
+ Sets the object's ACL. Right now an object has three access permissions: private, public-ready, public-read-write.
+ The operation specifies the x-oss-object-acl header in the put request. The caller must be the owner of the object.
+ If succeeds, it returns HTTP status 200; otherwise it returns related error code and error messages.
  */
 - (OSSTask *)putObjectACL:(OSSPutObjectACLRequest *)request;
 
 /**
- 对应RESTFul API：AppendObject
- 以追加写的方式上传文件。通过Append Object操作创建的Object类型为Appendable Object，而通过Put Object上传的Object是Normal Object。
+The corresponding RESTFul API: AppendObject
+ Appends data to an existing or non-existing object. The object created by this operation is appendable. 
+ As a comparison, the object created by Put Object is normal (non-appendable).
  */
 - (OSSTask *)appendObject:(OSSAppendObjectRequest *)request;
 
 /**
- 对应RESTFul API：copyObject
- 拷贝一个在OSS上已经存在的object成另外一个object，可以发送一个PUT请求给OSS，并在PUT请求头中添加元素“x-oss-copy-source”来指定拷贝源。
- OSS会自动判断出这是一个Copy操作，并直接在服务器端执行该操作。如果拷贝成功，则返回新的object信息给用户。
- 该操作适用于拷贝小于1GB的文件。
+ @brief : Appends data to an existing or non-existing object on the OSS server. The object created by this operation is appendable.
+ request    : request
+ crc64ecma  : 如果服务器上面已经存在对象,需要客户端先调用headObject获取到对象的crc64ecma,然后再调用
+              该接口上传数据
+ */
+- (OSSTask *)appendObject:(OSSAppendObjectRequest *)request withCrc64ecma:(nullable NSString *)crc64ecma;
+
+/**
+The corresponding RESTFul API: copyObject
+ Copies an existing object to another one.The operation sends a PUT request with x-oss-copy-source header to specify the source object.
+ OSS server side will detect and copy the object. If it succeeds, the new object's metadata information will be returned.
+ The operation applies for files less than 1GB. For big files, use UploadPartCopy RESTFul API.
  */
 - (OSSTask *)copyObject:(OSSCopyObjectRequest *)request;
 
 /**
- 对应RESTFul API：DeleteObject
- 用于删除某个Object。
+ * Batch deletes the specified files under a specific bucket. If the files
+ * are non-exist, the operation will still return successful.
+ *
+ * @param deleteObjectsRequest
+ *            A OSSDeleteMultipleObjectsRequest instance which specifies the
+ *            bucket and file keys to delete.
+ * @return A OSSTask with result of OSSDeleteMultipleObjectsResult instance which specifies each
+ *         file's result in normal mode or only failed deletions in quite
+ *         mode. By default it's quite mode.
+ */
+- (OSSTask *)deleteMultipleObjects:(OSSDeleteMultipleObjectsRequest *)request;
+
+/**
+ The corresponding RESTFul API: DeleteObject
+ Deletes an object
  */
 - (OSSTask *)deleteObject:(OSSDeleteObjectRequest *)request;
 
 /**
- 对应RESTFul API：InitiateMultipartUpload
- 使用Multipart Upload模式传输数据前，必须先调用该接口来通知OSS初始化一个Multipart Upload事件。该接口会返回一个OSS服务器创建的全局唯一的Upload ID，用于标识本次Multipart Upload事件。
- 用户可以根据这个ID来发起相关的操作，如中止Multipart Upload、查询Multipart Upload等。
+The corresponding RESTFul API: InitiateMultipartUpload
+ Initiates a multipart upload to get a upload Id. It's needed before starting uploading parts data. 
+ The upload Id is used for subsequential operations such as aborting the upload, querying the uploaded parts, etc.
  */
 - (OSSTask *)multipartUploadInit:(OSSInitMultipartUploadRequest *)request;
 
 /**
- 对应RESTFul API：UploadPart
- 初始化一个Multipart Upload之后，可以根据指定的Object名和Upload ID来分块（Part）上传数据。
- 每一个上传的Part都有一个标识它的号码（part number，范围是1~10,000）。
- 对于同一个Upload ID，该号码不但唯一标识这一块数据，也标识了这块数据在整个文件内的相对位置。
- 如果你用同一个part号码，上传了新的数据，那么OSS上已有的这个号码的Part数据将被覆盖。除了最后一块Part以外，其他的part最小为100KB；
- 最后一块Part没有大小限制。
+The corresponding RESTFul API: UploadPart
+ After the multipart upload is initiated, this API could be called to upload the data to the target file with the upload Id.
+ Every uploaded part has a unique id called part number, which ranges from 1 to 10,000. 
+ For a given upload Id, the part number identifies the specific range of the data in the whole file. 
+ If the same part number is used for another upload, the existing data will be overwritten by the new upload. 
+ Except the last part, all other part's minimal size is 100KB.
+ But no minimal size requirement on the last part.
  */
 - (OSSTask *)uploadPart:(OSSUploadPartRequest *)request;
 
 /**
- 对应RESTFul API：CompleteMultipartUpload
- 在将所有数据Part都上传完成后，必须调用Complete Multipart Upload API来完成整个文件的Multipart Upload。
- 在执行该操作时，用户必须提供所有有效的数据Part的列表（包括part号码和ETAG）；OSS收到用户提交的Part列表后，会逐一验证每个数据Part的有效性。
- 当所有的数据Part验证通过后，OSS将把这些数据part组合成一个完整的Object。
+The corresponding RESTFul API: CompleteMultipartUpload
+ This API is to complete the multipart upload after all parts data have been uploaded.
+ It must be provided with a valid part list (each part has the part number and ETag). 
+ OSS will validate every part and then complete the multipart upload.
+ If any part is invalid (e.g. the part is updated by another part upload), this API will fail.
  */
 - (OSSTask *)completeMultipartUpload:(OSSCompleteMultipartUploadRequest *)request;
 
 /**
- 对应RESTFul API：ListParts
- 可以罗列出指定Upload ID所属的所有已经上传成功Part。
+The corresponding RESTFul API: ListParts
+ Lists all uploaded parts of the specified upload id.
  */
 - (OSSTask *)listParts:(OSSListPartsRequest *)request;
 
 /**
- 对应RESTFul API：AbortMultipartUpload
- 该接口可以根据用户提供的Upload ID中止其对应的Multipart Upload事件。
- 当一个Multipart Upload事件被中止后，就不能再使用这个Upload ID做任何操作，已经上传的Part数据也会被删除。
+ The corresponding RESTFul API: ListMultipartUploads
+ Lists all multipart uploads with the specified bucket.
+ */
+- (OSSTask *)listMultipartUploads:(OSSListMultipartUploadsRequest *)request;
+
+/**
+The corresponding RESTFul API: AbortMultipartUpload
+Aborts the multipart upload by the specified upload Id.
+ Once the multipart upload is aborted by this API, all parts data will be deleted and the upload Id is invalid anymore.
  */
 - (OSSTask *)abortMultipartUpload:(OSSAbortMultipartUploadRequest *)request;
 
+- (OSSTask *)abortResumableMultipartUpload:(OSSResumableUploadRequest *)request;
+
+- (OSSTask *)triggerCallBack:(OSSCallBackRequest *)request;
+
+
 #pragma mark extention method
 
 /**
- 对一个Object签名出一个URL，可以把该URL转给第三方实现授权访问。
- @bucketName Object所在的Bucket名称
- @objectKey Object名称
- @interval 签名URL时，可以指定这个URL的有效时长是多久，单位是秒，比如说需要有效时长为1小时的URL，这里传入3600
+ Generates a signed URL for the object and anyone has this URL will get the GET permission on the object.
+ @bucketName object's bucket name
+ @objectKey Object name
+ @interval Expiration time in seconds. The URL could be specified with the expiration time to limit the access window on the object.
  */
 - (OSSTask *)presignConstrainURLWithBucketName:(NSString *)bucketName
                                 withObjectKey:(NSString *)objectKey
                        withExpirationInterval:(NSTimeInterval)interval;
 
 /**
- 对一个Object签名出一个URL，可以把该URL转给第三方实现授权访问。
- @bucketName Object所在的Bucket名称
- @objectKey Object名称
- @interval 签名URL时，可以指定这个URL的有效时长是多久，单位是秒，比如说需要有效时长为1小时的URL，这里传入3600
- @parameter 参数
+ Generates a signed URL for the object and anyone has this URL will get the specified permission on the object.
+ @bucketName object's bucket name
+ @objectKey Object name
+ @interval Expiration time in seconds. The URL could be specified with the expiration time to limit the access window on the object.
+ @parameter it could specify allowed HTTP methods 
  */
 - (OSSTask *)presignConstrainURLWithBucketName:(NSString *)bucketName
                                  withObjectKey:(NSString *)objectKey
                         withExpirationInterval:(NSTimeInterval)interval
                                 withParameters:(NSDictionary *)parameters;
 
-/**
- 如果Object的权限是公共读或者公共读写，调用这个接口对该Object签名出一个URL，可以把该URL转给第三方实现授权访问。
- @bucketName Object所在的Bucket名称
- @objectKey Object名称
+/** TODOTODO
+ If the object's ACL is public read or public read-write, use this API to generate a signed url for sharing.
+ @bucketName Object's bucket name
+ @objectKey Object name
  */
 - (OSSTask *)presignPublicURLWithBucketName:(NSString *)bucketName
                             withObjectKey:(NSString *)objectKey;
 
-/**
- 如果Object的权限是公共读或者公共读写，调用这个接口对该Object签名出一个URL，可以把该URL转给第三方实现授权访问。
- @bucketName Object所在的Bucket名称
- @objectKey Object名称
- @parameter 参数
+/** TODOTODO
+ If the object's ACL is public read or public read-write, use this API to generate a signed url for sharing.
+ @bucketName Object's bucket name
+ @objectKey Object name
+ @parameter the request parameters.
  */
 - (OSSTask *)presignPublicURLWithBucketName:(NSString *)bucketName
                              withObjectKey:(NSString *)objectKey
                              withParameters:(NSDictionary *)parameters;
 
 /**
- 断点上传接口
- 这个接口封装了分块上传的若干接口以实现断点上传，但是需要用户自行保存UploadId。
- 对一个新文件，用户需要首先调用multipartUploadInit接口获得一个UploadId，然后调用此接口上传这个文件。
- 如果上传失败，首先需要检查一下失败原因：
-     如果非不可恢复的失败，那么可以用同一个UploadId和同一文件继续调用这个接口续传
-     否则，需要重新获取UploadId，重新上传这个文件。
- 详细参考demo。
+ TODOTODO
+ Multipart upload API
+ */
+- (OSSTask *)multipartUpload:(OSSMultipartUploadRequest *)request;
+/**
+ TODOTODO
+ Resumable upload API
+ This API wraps the multipart upload and also enables resuming upload by reading/writing  the checkpoint data.
+ For a new file, multipartUploadInit() needs to be called first to get the upload Id. Then use this upload id to call this API to upload the data.
+ If the upload fails, checks the error messages:
+     If it's a recoverable error, then call this API again with the same upload Id to retry. The uploaded data will not be uploaded again.
+     Otherwise then you may need to recreates a new upload Id and call this method again.
+ Check out demo for the detail.
  */
 - (OSSTask *)resumableUpload:(OSSResumableUploadRequest *)request;
 
 /**
- 查看某个Object是否存在
- @bucketName Object所在的Bucket名称
- @objectKey Object名称
+ Checks if the object exists
+ @bucketName Object's bucket name
+ @objectKey Object name
  
- return YES                     Object存在
- return NO && *error = nil      Object不存在
- return NO && *error != nil     发生错误
+ return YES                     Object exists
+ return NO && *error = nil      Object does not exist
+ return NO && *error != nil     Error occured.
  */
 - (BOOL)doesObjectExistInBucket:(NSString *)bucketName
                       objectKey:(NSString *)objectKey
                           error:(const NSError **)error;
+
+/**
+ * multipart upload sequentially in order,support resume upload
+ */
+- (OSSTask *)sequentialMultipartUpload:(OSSResumableUploadRequest *)request;
+
+/*
+ * image persist action
+ * https://help.aliyun.com/document_detail/55811.html
+ */
+- (OSSTask *)imageActionPersist:(OSSImagePersistRequest *)request;
+
 @end
 
+
+
+
 NS_ASSUME_NONNULL_END

Example/ios/AliyunOSSiOS.framework/Headers/OSSCocoaLumberjack.h

@@ -0,0 +1,75 @@
+// Software License Agreement (BSD License)
+//
+// Copyright (c) 2010-2016, Deusty, LLC
+// All rights reserved.
+//
+// Redistribution and use of this software in source and binary forms,
+// with or without modification, are permitted provided that the following conditions are met:
+//
+// * Redistributions of source code must retain the above copyright notice,
+//   this list of conditions and the following disclaimer.
+//
+// * Neither the name of Deusty nor the names of its contributors may be used
+//   to endorse or promote products derived from this software without specific
+//   prior written permission of Deusty, LLC.
+
+/**
+ * Welcome to CocoaLumberjack!
+ *
+ * The project page has a wealth of documentation if you have any questions.
+ *
+ * If you're new to the project you may wish to read "Getting Started" at:
+ * Documentation/GettingStarted.md
+ *
+ * Otherwise, here is a quick refresher.
+ * There are three steps to using the macros:
+ *
+ * Step 1:
+ * Import the header in your implementation or prefix file:
+ *
+ * #import <CocoaLumberjack/CocoaLumberjack.h>
+ *
+ * Step 2:
+ * Define your logging level in your implementation file:
+ *
+ * // Log levels: off, error, warn, info, verbose
+ * static const DDLogLevel ddLogLevel = DDLogLevelVerbose;
+ *
+ * Step 2 [3rd party frameworks]:
+ *
+ * Define your LOG_LEVEL_DEF to a different variable/function than ddLogLevel:
+ *
+ * // #undef LOG_LEVEL_DEF // Undefine first only if needed
+ * #define LOG_LEVEL_DEF myLibLogLevel
+ *
+ * Define your logging level in your implementation file:
+ *
+ * // Log levels: off, error, warn, info, verbose
+ * static const DDLogLevel myLibLogLevel = DDLogLevelVerbose;
+ *
+ * Step 3:
+ * Replace your NSLog statements with DDLog statements according to the severity of the message.
+ *
+ * NSLog(@"Fatal error, no dohickey found!"); -> OSSLogError(@"Fatal error, no dohickey found!");
+ *
+ * DDLog works exactly the same as NSLog.
+ * This means you can pass it multiple variables just like NSLog.
+ **/
+
+#import <Foundation/Foundation.h>
+
+// Disable legacy macros
+#ifndef OSSDD_LEGACY_MACROS
+    #define OSSDD_LEGACY_MACROS 0
+#endif
+
+// Core
+#import "OSSDDLog.h"
+
+// Main macros
+#import "OSSLogMacros.h"
+
+// Loggers
+#import "OSSFileLogger.h"
+#import "OSSNSLogger.h"
+

Example/ios/AliyunOSSiOS.framework/Headers/OSSCompat.h

@@ -13,11 +13,13 @@
 
 typedef OSSCancellationTokenSource OSSTaskHandler;
 
+NS_ASSUME_NONNULL_BEGIN
+
 @interface OSSClient (Compat)
 
 /**
- 兼容老版本用法的上传数据接口
- 建议更换使用：putObject
+ The old version's upload API.
+ Please use putObject instead.
  */
 - (OSSTaskHandler *)uploadData:(NSData *)data
                withContentType:(NSString *)contentType
@@ -28,8 +30,8 @@ typedef OSSCancellationTokenSource OSSTaskHandler;
                     onProgress:(void(^)(float progress))onProgress;
 
 /**
- 兼容老版本用法的下载数据接口
- 建议更换使用：getObject
+ The old version's download API.
+ Please use getObject instead.
  */
 - (OSSTaskHandler *)downloadToDataFromBucket:(NSString *)bucketName
                    objectKey:(NSString *)objectKey
@@ -37,8 +39,8 @@ typedef OSSCancellationTokenSource OSSTaskHandler;
                   onProgress:(void(^)(float progress))onProgress;
 
 /**
- 兼容老版本用法的上传文件接口
- 建议更换使用：putObject
+ The old version's upload API.
+ Please use putObject instead.
  */
 - (OSSTaskHandler *)uploadFile:(NSString *)filePath
                 withContentType:(NSString *)contentType
@@ -49,8 +51,8 @@ typedef OSSCancellationTokenSource OSSTaskHandler;
                      onProgress:(void(^)(float progress))onProgress;
 
 /**
- 兼容老版本用法的下载文件接口
- 建议更换使用：getObject
+ The old version's download API.
+ Please use getObject instead.
  */
 - (OSSTaskHandler *)downloadToFileFromBucket:(NSString *)bucketName
                   objectKey:(NSString *)objectKey
@@ -60,8 +62,8 @@ typedef OSSCancellationTokenSource OSSTaskHandler;
 
 
 /**
- 兼容老版本用法的断点上传文件接口
- 建议更换使用：resumableUpload
+ The old version's upload API with resumable upload support.
+ Please use resumableUpload instead.
  */
 - (OSSTaskHandler *)resumableUploadFile:(NSString *)filePath
           withContentType:(NSString *)contentType
@@ -72,10 +74,12 @@ typedef OSSCancellationTokenSource OSSTaskHandler;
                onProgress:(void(^)(float progress))onProgress;
 
 /**
- 兼容老版本用法的删除Object接口
- 建议更换使用：deleteObject
+ The old version's delete API.
+ Please use deleteObject instead.
  */
 - (void)deleteObjectInBucket:(NSString *)bucketName
                    objectKey:(NSString *)objectKey
                  onCompleted:(void(^)(BOOL, NSError *))onCompleted;
-@end
+@end
+
+NS_ASSUME_NONNULL_END

Example/ios/AliyunOSSiOS.framework/Headers/OSSConstants.h

@@ -0,0 +1,111 @@
+//
+//  OSSConstants.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/22.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+typedef NSString* _Nullable (^OSSCustomSignContentBlock) (NSString * contentToSign, NSError **error);
+typedef NSData * _Nullable (^OSSResponseDecoderBlock) (NSData * data);
+
+typedef void (^OSSNetworkingUploadProgressBlock) (int64_t bytesSent, int64_t totalBytesSent, int64_t totalBytesExpectedToSend);
+typedef void (^OSSNetworkingDownloadProgressBlock) (int64_t bytesWritten, int64_t totalBytesWritten, int64_t totalBytesExpectedToWrite);
+typedef void (^OSSNetworkingRetryBlock) (void);
+typedef void (^OSSNetworkingCompletionHandlerBlock) (id _Nullable responseObject, NSError * _Nullable error);
+typedef void (^OSSNetworkingOnRecieveDataBlock) (NSData * data);
+
+/**
+ The flag of verification about crc64
+ */
+typedef NS_ENUM(NSUInteger, OSSRequestCRCFlag) {
+    OSSRequestCRCUninitialized,
+    OSSRequestCRCOpen,
+    OSSRequestCRCClosed
+};
+
+/**
+ Retry type definition
+ */
+typedef NS_ENUM(NSInteger, OSSNetworkingRetryType) {
+    OSSNetworkingRetryTypeUnknown,
+    OSSNetworkingRetryTypeShouldRetry,
+    OSSNetworkingRetryTypeShouldNotRetry,
+    OSSNetworkingRetryTypeShouldRefreshCredentialsAndRetry,
+    OSSNetworkingRetryTypeShouldCorrectClockSkewAndRetry
+};
+
+/**
+ * @brief: The following constants are provided by OSSNetworking as possible operation types.
+ */
+typedef NS_ENUM(NSInteger, OSSOperationType) {
+    OSSOperationTypeGetService,
+    OSSOperationTypeCreateBucket,
+    OSSOperationTypeDeleteBucket,
+    OSSOperationTypeGetBucket,
+    OSSOperationTypeGetBucketACL,
+    OSSOperationTypeHeadObject,
+    OSSOperationTypeGetObject,
+    OSSOperationTypeGetObjectACL,
+    OSSOperationTypePutObject,
+    OSSOperationTypePutObjectACL,
+    OSSOperationTypeAppendObject,
+    OSSOperationTypeDeleteObject,
+    OSSOperationTypeDeleteMultipleObjects,
+    OSSOperationTypeCopyObject,
+    OSSOperationTypeInitMultipartUpload,
+    OSSOperationTypeUploadPart,
+    OSSOperationTypeCompleteMultipartUpload,
+    OSSOperationTypeAbortMultipartUpload,
+    OSSOperationTypeListMultipart,
+    OSSOperationTypeListMultipartUploads,
+    OSSOperationTypeTriggerCallBack,
+    OSSOperationTypeImagePersist
+};
+
+/**
+ * @brief: The following constants are provided by OSSClient as possible error codes.
+ */
+typedef NS_ENUM(NSInteger, OSSClientErrorCODE) {
+    OSSClientErrorCodeNetworkingFailWithResponseCode0,
+    OSSClientErrorCodeSignFailed,
+    OSSClientErrorCodeFileCantWrite,
+    OSSClientErrorCodeInvalidArgument,
+    OSSClientErrorCodeNilUploadid,
+    OSSClientErrorCodeTaskCancelled,
+    OSSClientErrorCodeNetworkError,
+    OSSClientErrorCodeInvalidCRC,
+    OSSClientErrorCodeCannotResumeUpload,
+    OSSClientErrorCodeExcpetionCatched,
+    OSSClientErrorCodeNotKnown
+};
+
+typedef NS_ENUM(NSInteger, OSSXMLDictionaryAttributesMode)
+{
+    OSSXMLDictionaryAttributesModePrefixed = 0, //default
+    OSSXMLDictionaryAttributesModeDictionary,
+    OSSXMLDictionaryAttributesModeUnprefixed,
+    OSSXMLDictionaryAttributesModeDiscard
+};
+
+
+typedef NS_ENUM(NSInteger, OSSXMLDictionaryNodeNameMode)
+{
+    OSSXMLDictionaryNodeNameModeRootOnly = 0, //default
+    OSSXMLDictionaryNodeNameModeAlways,
+    OSSXMLDictionaryNodeNameModeNever
+};
+
+typedef NSString * OSSXMLDictionaryAttributeName NS_EXTENSIBLE_STRING_ENUM;
+
+OBJC_EXTERN OSSXMLDictionaryAttributeName const OSSXMLDictionaryAttributesKey;
+OBJC_EXTERN OSSXMLDictionaryAttributeName const OSSXMLDictionaryCommentsKey;
+OBJC_EXTERN OSSXMLDictionaryAttributeName const OSSXMLDictionaryTextKey;
+OBJC_EXTERN OSSXMLDictionaryAttributeName const OSSXMLDictionaryNodeNameKey;
+OBJC_EXTERN OSSXMLDictionaryAttributeName const OSSXMLDictionaryAttributePrefix;
+
+NS_ASSUME_NONNULL_END

Example/ios/AliyunOSSiOS.framework/Headers/OSSDDLog.h

@@ -0,0 +1,860 @@
+// Software License Agreement (BSD License)
+//
+// Copyright (c) 2010-2016, Deusty, LLC
+// All rights reserved.
+//
+// Redistribution and use of this software in source and binary forms,
+// with or without modification, are permitted provided that the following conditions are met:
+//
+// * Redistributions of source code must retain the above copyright notice,
+//   this list of conditions and the following disclaimer.
+//
+// * Neither the name of Deusty nor the names of its contributors may be used
+//   to endorse or promote products derived from this software without specific
+//   prior written permission of Deusty, LLC.
+
+#import <Foundation/Foundation.h>
+
+// Enable 1.9.x legacy macros if imported directly
+#ifndef OSSDD_LEGACY_MACROS
+    #define OSSDD_LEGACY_MACROS 1
+#endif
+
+#if OS_OBJECT_USE_OBJC
+    #define DISPATCH_QUEUE_REFERENCE_TYPE strong
+#else
+    #define DISPATCH_QUEUE_REFERENCE_TYPE assign
+#endif
+
+@class OSSDDLogMessage;
+@class OSSDDLoggerInformation;
+@protocol OSSDDLogger;
+@protocol OSSDDLogFormatter;
+
+/**
+ * Define the standard options.
+ *
+ * We default to only 4 levels because it makes it easier for beginners
+ * to make the transition to a logging framework.
+ *
+ * More advanced users may choose to completely customize the levels (and level names) to suite their needs.
+ * For more information on this see the "Custom Log Levels" page:
+ * Documentation/CustomLogLevels.md
+ *
+ * Advanced users may also notice that we're using a bitmask.
+ * This is to allow for custom fine grained logging:
+ * Documentation/FineGrainedLogging.md
+ *
+ * -- Flags --
+ *
+ * Typically you will use the LOG_LEVELS (see below), but the flags may be used directly in certain situations.
+ * For example, say you have a lot of warning log messages, and you wanted to disable them.
+ * However, you still needed to see your error and info log messages.
+ * You could accomplish that with the following:
+ *
+ * static const DDLogLevel ddLogLevel = DDLogFlagError | DDLogFlagInfo;
+ *
+ * When LOG_LEVEL_DEF is defined as ddLogLevel.
+ *
+ * Flags may also be consulted when writing custom log formatters,
+ * as the DDLogMessage class captures the individual flag that caused the log message to fire.
+ *
+ * -- Levels --
+ *
+ * Log levels are simply the proper bitmask of the flags.
+ *
+ * -- Booleans --
+ *
+ * The booleans may be used when your logging code involves more than one line.
+ * For example:
+ *
+ * if (LOG_VERBOSE) {
+ *     for (id sprocket in sprockets)
+ *         DDLogVerbose(@"sprocket: %@", [sprocket description])
+ * }
+ *
+ * -- Async --
+ *
+ * Defines the default asynchronous options.
+ * The default philosophy for asynchronous logging is very simple:
+ *
+ * Log messages with errors should be executed synchronously.
+ *     After all, an error just occurred. The application could be unstable.
+ *
+ * All other log messages, such as debug output, are executed asynchronously.
+ *     After all, if it wasn't an error, then it was just informational output,
+ *     or something the application was easily able to recover from.
+ *
+ * -- Changes --
+ *
+ * You are strongly discouraged from modifying this file.
+ * If you do, you make it more difficult on yourself to merge future bug fixes and improvements from the project.
+ * Instead, create your own MyLogging.h or ApplicationNameLogging.h or CompanyLogging.h
+ *
+ * For an example of customizing your logging experience, see the "Custom Log Levels" page:
+ * Documentation/CustomLogLevels.md
+ **/
+
+/**
+ *  Flags accompany each log. They are used together with levels to filter out logs.
+ */
+typedef NS_OPTIONS(NSUInteger, OSSDDLogFlag){
+    /**
+     *  0...00001 DDLogFlagError
+     */
+    OSSDDLogFlagError      = (1 << 0),
+    
+    /**
+     *  0...00010 DDLogFlagWarning
+     */
+    OSSDDLogFlagWarning    = (1 << 1),
+    
+    /**
+     *  0...00100 DDLogFlagInfo
+     */
+    OSSDDLogFlagInfo       = (1 << 2),
+    
+    /**
+     *  0...01000 DDLogFlagDebug
+     */
+    OSSDDLogFlagDebug      = (1 << 3),
+    
+    /**
+     *  0...10000 DDLogFlagVerbose
+     */
+    OSSDDLogFlagVerbose    = (1 << 4)
+};
+
+/**
+ *  Log levels are used to filter out logs. Used together with flags.
+ */
+typedef NS_ENUM(NSUInteger, OSSDDLogLevel){
+    /**
+     *  No logs
+     */
+    OSSDDLogLevelOff       = 0,
+    
+    /**
+     *  Error logs only
+     */
+    OSSDDLogLevelError     = (OSSDDLogFlagError),
+    
+    /**
+     *  Error and warning logs
+     */
+    OSSDDLogLevelWarning   = (OSSDDLogLevelError   | OSSDDLogFlagWarning),
+    
+    /**
+     *  Error, warning and info logs
+     */
+    OSSDDLogLevelInfo      = (OSSDDLogLevelWarning | OSSDDLogFlagInfo),
+    
+    /**
+     *  Error, warning, info and debug logs
+     */
+    OSSDDLogLevelDebug     = (OSSDDLogLevelInfo    | OSSDDLogFlagDebug),
+    
+    /**
+     *  Error, warning, info, debug and verbose logs
+     */
+    OSSDDLogLevelVerbose   = (OSSDDLogLevelDebug   | OSSDDLogFlagVerbose),
+    
+    /**
+     *  All logs (1...11111)
+     */
+    OSSDDLogLevelAll       = NSUIntegerMax
+};
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ *  Extracts just the file name, no path or extension
+ *
+ *  @param filePath input file path
+ *  @param copy     YES if we want the result to be copied
+ *
+ *  @return the file name
+ */
+NSString * __nullable OSSDDExtractFileNameWithoutExtension(const char *filePath, BOOL copy);
+
+/**
+ * The THIS_FILE macro gives you an NSString of the file name.
+ * For simplicity and clarity, the file name does not include the full path or file extension.
+ *
+ * For example: DDLogWarn(@"%@: Unable to find thingy", THIS_FILE) -> @"MyViewController: Unable to find thingy"
+ **/
+#define THIS_FILE         (DDExtractFileNameWithoutExtension(__FILE__, NO))
+
+/**
+ * The THIS_METHOD macro gives you the name of the current objective-c method.
+ *
+ * For example: DDLogWarn(@"%@ - Requires non-nil strings", THIS_METHOD) -> @"setMake:model: requires non-nil strings"
+ *
+ * Note: This does NOT work in straight C functions (non objective-c).
+ * Instead you should use the predefined __FUNCTION__ macro.
+ **/
+#define THIS_METHOD       NSStringFromSelector(_cmd)
+
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ *  The main class, exposes all logging mechanisms, loggers, ...
+ *  For most of the users, this class is hidden behind the logging functions like `DDLogInfo`
+ */
+@interface OSSDDLog : NSObject
+
+/**
+ *  Returns the singleton `DDLog`.
+ *  The instance is used by `DDLog` class methods.
+ */
+@property (class, nonatomic, strong, readonly) OSSDDLog *sharedInstance;
+
+/**
+ * Provides access to the underlying logging queue.
+ * This may be helpful to Logger classes for things like thread synchronization.
+ **/
+@property (class, nonatomic, DISPATCH_QUEUE_REFERENCE_TYPE, readonly) dispatch_queue_t loggingQueue;
+
+/**
+ * Logging Primitive.
+ *
+ * This method is used by the macros or logging functions.
+ * It is suggested you stick with the macros as they're easier to use.
+ *
+ *  @param asynchronous YES if the logging is done async, NO if you want to force sync
+ *  @param level        the log level
+ *  @param flag         the log flag
+ *  @param context      the context (if any is defined)
+ *  @param file         the current file
+ *  @param function     the current function
+ *  @param line         the current code line
+ *  @param tag          potential tag
+ *  @param format       the log format
+ */
++ (void)log:(BOOL)asynchronous
+      level:(OSSDDLogLevel)level
+       flag:(OSSDDLogFlag)flag
+    context:(NSInteger)context
+       file:(const char *)file
+   function:(const char *)function
+       line:(NSUInteger)line
+        tag:(id __nullable)tag
+     format:(NSString *)format, ... NS_FORMAT_FUNCTION(9,10);
+
+/**
+ * Logging Primitive.
+ *
+ * This method is used by the macros or logging functions.
+ * It is suggested you stick with the macros as they're easier to use.
+ *
+ *  @param asynchronous YES if the logging is done async, NO if you want to force sync
+ *  @param level        the log level
+ *  @param flag         the log flag
+ *  @param context      the context (if any is defined)
+ *  @param file         the current file
+ *  @param function     the current function
+ *  @param line         the current code line
+ *  @param tag          potential tag
+ *  @param format       the log format
+ */
+- (void)log:(BOOL)asynchronous
+      level:(OSSDDLogLevel)level
+       flag:(OSSDDLogFlag)flag
+    context:(NSInteger)context
+       file:(const char *)file
+   function:(const char *)function
+       line:(NSUInteger)line
+        tag:(id __nullable)tag
+     format:(NSString *)format, ... NS_FORMAT_FUNCTION(9,10);
+
+/**
+ * Logging Primitive.
+ *
+ * This method can be used if you have a prepared va_list.
+ * Similar to `log:level:flag:context:file:function:line:tag:format:...`
+ *
+ *  @param asynchronous YES if the logging is done async, NO if you want to force sync
+ *  @param level        the log level
+ *  @param flag         the log flag
+ *  @param context      the context (if any is defined)
+ *  @param file         the current file
+ *  @param function     the current function
+ *  @param line         the current code line
+ *  @param tag          potential tag
+ *  @param format       the log format
+ *  @param argList      the arguments list as a va_list
+ */
++ (void)log:(BOOL)asynchronous
+      level:(OSSDDLogLevel)level
+       flag:(OSSDDLogFlag)flag
+    context:(NSInteger)context
+       file:(const char *)file
+   function:(const char *)function
+       line:(NSUInteger)line
+        tag:(id __nullable)tag
+     format:(NSString *)format
+       args:(va_list)argList NS_SWIFT_NAME(log(asynchronous:level:flag:context:file:function:line:tag:format:arguments:));
+
+/**
+ * Logging Primitive.
+ *
+ * This method can be used if you have a prepared va_list.
+ * Similar to `log:level:flag:context:file:function:line:tag:format:...`
+ *
+ *  @param asynchronous YES if the logging is done async, NO if you want to force sync
+ *  @param level        the log level
+ *  @param flag         the log flag
+ *  @param context      the context (if any is defined)
+ *  @param file         the current file
+ *  @param function     the current function
+ *  @param line         the current code line
+ *  @param tag          potential tag
+ *  @param format       the log format
+ *  @param argList      the arguments list as a va_list
+ */
+- (void)log:(BOOL)asynchronous
+      level:(OSSDDLogLevel)level
+       flag:(OSSDDLogFlag)flag
+    context:(NSInteger)context
+       file:(const char *)file
+   function:(const char *)function
+       line:(NSUInteger)line
+        tag:(id __nullable)tag
+     format:(NSString *)format
+       args:(va_list)argList NS_SWIFT_NAME(log(asynchronous:level:flag:context:file:function:line:tag:format:arguments:));
+
+/**
+ * Logging Primitive.
+ *
+ * This method can be used if you manualy prepared DDLogMessage.
+ *
+ *  @param asynchronous YES if the logging is done async, NO if you want to force sync
+ *  @param logMessage   the log message stored in a `DDLogMessage` model object
+ */
++ (void)log:(BOOL)asynchronous
+    message:(OSSDDLogMessage *)logMessage NS_SWIFT_NAME(log(asynchronous:message:));
+
+/**
+ * Logging Primitive.
+ *
+ * This method can be used if you manualy prepared DDLogMessage.
+ *
+ *  @param asynchronous YES if the logging is done async, NO if you want to force sync
+ *  @param logMessage   the log message stored in a `DDLogMessage` model object
+ */
+- (void)log:(BOOL)asynchronous
+    message:(OSSDDLogMessage *)logMessage NS_SWIFT_NAME(log(asynchronous:message:));
+
+/**
+ * Since logging can be asynchronous, there may be times when you want to flush the logs.
+ * The framework invokes this automatically when the application quits.
+ **/
++ (void)flushLog;
+
+/**
+ * Since logging can be asynchronous, there may be times when you want to flush the logs.
+ * The framework invokes this automatically when the application quits.
+ **/
+- (void)flushLog;
+
+/**
+ * Loggers
+ *
+ * In order for your log statements to go somewhere, you should create and add a logger.
+ *
+ * You can add multiple loggers in order to direct your log statements to multiple places.
+ * And each logger can be configured separately.
+ * So you could have, for example, verbose logging to the console, but a concise log file with only warnings & errors.
+ **/
+
+/**
+ * Adds the logger to the system.
+ *
+ * This is equivalent to invoking `[DDLog addLogger:logger withLogLevel:DDLogLevelAll]`.
+ **/
++ (void)addLogger:(id <OSSDDLogger>)logger;
+
+/**
+ * Adds the logger to the system.
+ *
+ * This is equivalent to invoking `[DDLog addLogger:logger withLogLevel:DDLogLevelAll]`.
+ **/
+- (void)addLogger:(id <OSSDDLogger>)logger;
+
+/**
+ * Adds the logger to the system.
+ *
+ * The level that you provide here is a preemptive filter (for performance).
+ * That is, the level specified here will be used to filter out logMessages so that
+ * the logger is never even invoked for the messages.
+ *
+ * More information:
+ * When you issue a log statement, the logging framework iterates over each logger,
+ * and checks to see if it should forward the logMessage to the logger.
+ * This check is done using the level parameter passed to this method.
+ *
+ * For example:
+ *
+ * `[DDLog addLogger:consoleLogger withLogLevel:DDLogLevelVerbose];`
+ * `[DDLog addLogger:fileLogger    withLogLevel:DDLogLevelWarning];`
+ *
+ * `DDLogError(@"oh no");` => gets forwarded to consoleLogger & fileLogger
+ * `DDLogInfo(@"hi");`     => gets forwarded to consoleLogger only
+ *
+ * It is important to remember that Lumberjack uses a BITMASK.
+ * Many developers & third party frameworks may define extra log levels & flags.
+ * For example:
+ *
+ * `#define SOME_FRAMEWORK_LOG_FLAG_TRACE (1 << 6) // 0...1000000`
+ *
+ * So if you specify `DDLogLevelVerbose` to this method, you won't see the framework's trace messages.
+ *
+ * `(SOME_FRAMEWORK_LOG_FLAG_TRACE & DDLogLevelVerbose) => (01000000 & 00011111) => NO`
+ *
+ * Consider passing `DDLogLevelAll` to this method, which has all bits set.
+ * You can also use the exclusive-or bitwise operator to get a bitmask that has all flags set,
+ * except the ones you explicitly don't want. For example, if you wanted everything except verbose & debug:
+ *
+ * `((DDLogLevelAll ^ DDLogLevelVerbose) | DDLogLevelInfo)`
+ **/
++ (void)addLogger:(id <OSSDDLogger>)logger withLevel:(OSSDDLogLevel)level;
+
+/**
+ * Adds the logger to the system.
+ *
+ * The level that you provide here is a preemptive filter (for performance).
+ * That is, the level specified here will be used to filter out logMessages so that
+ * the logger is never even invoked for the messages.
+ *
+ * More information:
+ * When you issue a log statement, the logging framework iterates over each logger,
+ * and checks to see if it should forward the logMessage to the logger.
+ * This check is done using the level parameter passed to this method.
+ *
+ * For example:
+ *
+ * `[DDLog addLogger:consoleLogger withLogLevel:DDLogLevelVerbose];`
+ * `[DDLog addLogger:fileLogger    withLogLevel:DDLogLevelWarning];`
+ *
+ * `DDLogError(@"oh no");` => gets forwarded to consoleLogger & fileLogger
+ * `DDLogInfo(@"hi");`     => gets forwarded to consoleLogger only
+ *
+ * It is important to remember that Lumberjack uses a BITMASK.
+ * Many developers & third party frameworks may define extra log levels & flags.
+ * For example:
+ *
+ * `#define SOME_FRAMEWORK_LOG_FLAG_TRACE (1 << 6) // 0...1000000`
+ *
+ * So if you specify `DDLogLevelVerbose` to this method, you won't see the framework's trace messages.
+ *
+ * `(SOME_FRAMEWORK_LOG_FLAG_TRACE & DDLogLevelVerbose) => (01000000 & 00011111) => NO`
+ *
+ * Consider passing `DDLogLevelAll` to this method, which has all bits set.
+ * You can also use the exclusive-or bitwise operator to get a bitmask that has all flags set,
+ * except the ones you explicitly don't want. For example, if you wanted everything except verbose & debug:
+ *
+ * `((DDLogLevelAll ^ DDLogLevelVerbose) | DDLogLevelInfo)`
+ **/
+- (void)addLogger:(id <OSSDDLogger>)logger withLevel:(OSSDDLogLevel)level;
+
+/**
+ *  Remove the logger from the system
+ */
++ (void)removeLogger:(id <OSSDDLogger>)logger;
+
+/**
+ *  Remove the logger from the system
+ */
+- (void)removeLogger:(id <OSSDDLogger>)logger;
+
+/**
+ *  Remove all the current loggers
+ */
++ (void)removeAllLoggers;
+
+/**
+ *  Remove all the current loggers
+ */
+- (void)removeAllLoggers;
+
+/**
+ *  Return all the current loggers
+ */
+@property (class, nonatomic, copy, readonly) NSArray<id<OSSDDLogger>> *allLoggers;
+
+/**
+ *  Return all the current loggers
+ */
+@property (nonatomic, copy, readonly) NSArray<id<OSSDDLogger>> *allLoggers;
+
+/**
+ *  Return all the current loggers with their level (aka DDLoggerInformation).
+ */
+@property (class, nonatomic, copy, readonly) NSArray<OSSDDLoggerInformation *> *allLoggersWithLevel;
+
+/**
+ *  Return all the current loggers with their level (aka DDLoggerInformation).
+ */
+@property (nonatomic, copy, readonly) NSArray<OSSDDLoggerInformation *> *allLoggersWithLevel;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ *  This protocol describes a basic logger behavior. 
+ *  Basically, it can log messages, store a logFormatter plus a bunch of optional behaviors.
+ *  (i.e. flush, get its loggerQueue, get its name, ...
+ */
+@protocol OSSDDLogger <NSObject>
+
+/**
+ *  The log message method
+ *
+ *  @param logMessage the message (model)
+ */
+- (void)logMessage:(OSSDDLogMessage *)logMessage NS_SWIFT_NAME(log(message:));
+
+/**
+ * Formatters may optionally be added to any logger.
+ *
+ * If no formatter is set, the logger simply logs the message as it is given in logMessage,
+ * or it may use its own built in formatting style.
+ **/
+@property (nonatomic, strong) id <OSSDDLogFormatter> logFormatter;
+
+@optional
+
+/**
+ * Since logging is asynchronous, adding and removing loggers is also asynchronous.
+ * In other words, the loggers are added and removed at appropriate times with regards to log messages.
+ *
+ * - Loggers will not receive log messages that were executed prior to when they were added.
+ * - Loggers will not receive log messages that were executed after they were removed.
+ *
+ * These methods are executed in the logging thread/queue.
+ * This is the same thread/queue that will execute every logMessage: invocation.
+ * Loggers may use these methods for thread synchronization or other setup/teardown tasks.
+ **/
+- (void)didAddLogger;
+
+/**
+ * Since logging is asynchronous, adding and removing loggers is also asynchronous.
+ * In other words, the loggers are added and removed at appropriate times with regards to log messages.
+ *
+ * - Loggers will not receive log messages that were executed prior to when they were added.
+ * - Loggers will not receive log messages that were executed after they were removed.
+ *
+ * These methods are executed in the logging thread/queue given in parameter.
+ * This is the same thread/queue that will execute every logMessage: invocation.
+ * Loggers may use the queue parameter to set specific values on the queue with dispatch_set_specific() function.
+ **/
+- (void)didAddLoggerInQueue:(dispatch_queue_t)queue;
+
+/**
+ *  See the above description for `didAddLoger`
+ */
+- (void)willRemoveLogger;
+
+/**
+ * Some loggers may buffer IO for optimization purposes.
+ * For example, a database logger may only save occasionaly as the disk IO is slow.
+ * In such loggers, this method should be implemented to flush any pending IO.
+ *
+ * This allows invocations of DDLog's flushLog method to be propogated to loggers that need it.
+ *
+ * Note that DDLog's flushLog method is invoked automatically when the application quits,
+ * and it may be also invoked manually by the developer prior to application crashes, or other such reasons.
+ **/
+- (void)flush;
+
+/**
+ * Each logger is executed concurrently with respect to the other loggers.
+ * Thus, a dedicated dispatch queue is used for each logger.
+ * Logger implementations may optionally choose to provide their own dispatch queue.
+ **/
+@property (nonatomic, DISPATCH_QUEUE_REFERENCE_TYPE, readonly) dispatch_queue_t loggerQueue;
+
+/**
+ * If the logger implementation does not choose to provide its own queue,
+ * one will automatically be created for it.
+ * The created queue will receive its name from this method.
+ * This may be helpful for debugging or profiling reasons.
+ **/
+@property (nonatomic, readonly) NSString *loggerName;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ *  This protocol describes the behavior of a log formatter
+ */
+@protocol OSSDDLogFormatter <NSObject>
+@required
+
+/**
+ * Formatters may optionally be added to any logger.
+ * This allows for increased flexibility in the logging environment.
+ * For example, log messages for log files may be formatted differently than log messages for the console.
+ *
+ * For more information about formatters, see the "Custom Formatters" page:
+ * Documentation/CustomFormatters.md
+ *
+ * The formatter may also optionally filter the log message by returning nil,
+ * in which case the logger will not log the message.
+ **/
+- (NSString * __nullable)formatLogMessage:(OSSDDLogMessage *)logMessage NS_SWIFT_NAME(format(message:));
+
+@optional
+
+/**
+ * A single formatter instance can be added to multiple loggers.
+ * These methods provides hooks to notify the formatter of when it's added/removed.
+ *
+ * This is primarily for thread-safety.
+ * If a formatter is explicitly not thread-safe, it may wish to throw an exception if added to multiple loggers.
+ * Or if a formatter has potentially thread-unsafe code (e.g. NSDateFormatter),
+ * it could possibly use these hooks to switch to thread-safe versions of the code.
+ **/
+- (void)didAddToLogger:(id <OSSDDLogger>)logger;
+
+/**
+ * A single formatter instance can be added to multiple loggers.
+ * These methods provides hooks to notify the formatter of when it's added/removed.
+ *
+ * This is primarily for thread-safety.
+ * If a formatter is explicitly not thread-safe, it may wish to throw an exception if added to multiple loggers.
+ * Or if a formatter has potentially thread-unsafe code (e.g. NSDateFormatter),
+ * it could possibly use these hooks to switch to thread-safe versions of the code or use dispatch_set_specific()
+.* to add its own specific values.
+ **/
+- (void)didAddToLogger:(id <OSSDDLogger>)logger inQueue:(dispatch_queue_t)queue;
+
+/**
+ *  See the above description for `didAddToLogger:`
+ */
+- (void)willRemoveFromLogger:(id <OSSDDLogger>)logger;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ *  This protocol describes a dynamic logging component
+ */
+@protocol OSSDDRegisteredDynamicLogging
+
+/**
+ * Implement these methods to allow a file's log level to be managed from a central location.
+ *
+ * This is useful if you'd like to be able to change log levels for various parts
+ * of your code from within the running application.
+ *
+ * Imagine pulling up the settings for your application,
+ * and being able to configure the logging level on a per file basis.
+ *
+ * The implementation can be very straight-forward:
+ *
+ * ```
+ * + (int)ddLogLevel
+ * {
+ *     return ddLogLevel;
+ * }
+ *
+ * + (void)ddSetLogLevel:(DDLogLevel)level
+ * {
+ *     ddLogLevel = level;
+ * }
+ * ```
+ **/
+@property (class, nonatomic, readwrite, setter=ddSetLogLevel:) OSSDDLogLevel ossLogLevel;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+#ifndef NS_DESIGNATED_INITIALIZER
+    #define NS_DESIGNATED_INITIALIZER
+#endif
+
+/**
+ *  Log message options, allow copying certain log elements
+ */
+typedef NS_OPTIONS(NSInteger, OSSDDLogMessageOptions){
+    /**
+     *  Use this to use a copy of the file path
+     */
+    OSSDDLogMessageCopyFile        = 1 << 0,
+    /**
+     *  Use this to use a copy of the function name
+     */
+    OSSDDLogMessageCopyFunction    = 1 << 1,
+    /**
+     *  Use this to use avoid a copy of the message
+     */
+    OSSDDLogMessageDontCopyMessage = 1 << 2
+};
+
+/**
+ * The `DDLogMessage` class encapsulates information about the log message.
+ * If you write custom loggers or formatters, you will be dealing with objects of this class.
+ **/
+@interface OSSDDLogMessage : NSObject <NSCopying>
+{
+    // Direct accessors to be used only for performance
+    @public
+    NSString *_message;
+    OSSDDLogLevel _level;
+    OSSDDLogFlag _flag;
+    NSInteger _context;
+    NSString *_file;
+    NSString *_fileName;
+    NSString *_function;
+    NSUInteger _line;
+    id _tag;
+    OSSDDLogMessageOptions _options;
+    NSDate *_timestamp;
+    NSString *_threadID;
+    NSString *_threadName;
+    NSString *_queueLabel;
+}
+
+/**
+ *  Default `init` for empty messages.
+ */
+- (instancetype)init NS_DESIGNATED_INITIALIZER;
+
+/**
+ * Standard init method for a log message object.
+ * Used by the logging primitives. (And the macros use the logging primitives.)
+ *
+ * If you find need to manually create logMessage objects, there is one thing you should be aware of:
+ *
+ * If no flags are passed, the method expects the file and function parameters to be string literals.
+ * That is, it expects the given strings to exist for the duration of the object's lifetime,
+ * and it expects the given strings to be immutable.
+ * In other words, it does not copy these strings, it simply points to them.
+ * This is due to the fact that __FILE__ and __FUNCTION__ are usually used to specify these parameters,
+ * so it makes sense to optimize and skip the unnecessary allocations.
+ * However, if you need them to be copied you may use the options parameter to specify this.
+ *
+ *  @param message   the message
+ *  @param level     the log level
+ *  @param flag      the log flag
+ *  @param context   the context (if any is defined)
+ *  @param file      the current file
+ *  @param function  the current function
+ *  @param line      the current code line
+ *  @param tag       potential tag
+ *  @param options   a bitmask which supports DDLogMessageCopyFile and DDLogMessageCopyFunction.
+ *  @param timestamp the log timestamp
+ *
+ *  @return a new instance of a log message model object
+ */
+- (instancetype)initWithMessage:(NSString *)message
+                          level:(OSSDDLogLevel)level
+                           flag:(OSSDDLogFlag)flag
+                        context:(NSInteger)context
+                           file:(NSString *)file
+                       function:(NSString * __nullable)function
+                           line:(NSUInteger)line
+                            tag:(id __nullable)tag
+                        options:(OSSDDLogMessageOptions)options
+                      timestamp:(NSDate * __nullable)timestamp NS_DESIGNATED_INITIALIZER;
+
+/**
+ * Read-only properties
+ **/
+
+/**
+ *  The log message
+ */
+@property (readonly, nonatomic) NSString *message;
+@property (readonly, nonatomic) OSSDDLogLevel level;
+@property (readonly, nonatomic) OSSDDLogFlag flag;
+@property (readonly, nonatomic) NSInteger context;
+@property (readonly, nonatomic) NSString *file;
+@property (readonly, nonatomic) NSString *fileName;
+@property (readonly, nonatomic) NSString * __nullable function;
+@property (readonly, nonatomic) NSUInteger line;
+@property (readonly, nonatomic) id __nullable tag;
+@property (readonly, nonatomic) OSSDDLogMessageOptions options;
+@property (readonly, nonatomic) NSDate *timestamp;
+@property (readonly, nonatomic) NSString *threadID; // ID as it appears in NSLog calculated from the machThreadID
+@property (readonly, nonatomic) NSString *threadName;
+@property (readonly, nonatomic) NSString *queueLabel;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * The `DDLogger` protocol specifies that an optional formatter can be added to a logger.
+ * Most (but not all) loggers will want to support formatters.
+ *
+ * However, writting getters and setters in a thread safe manner,
+ * while still maintaining maximum speed for the logging process, is a difficult task.
+ *
+ * To do it right, the implementation of the getter/setter has strict requiremenets:
+ * - Must NOT require the `logMessage:` method to acquire a lock.
+ * - Must NOT require the `logMessage:` method to access an atomic property (also a lock of sorts).
+ *
+ * To simplify things, an abstract logger is provided that implements the getter and setter.
+ *
+ * Logger implementations may simply extend this class,
+ * and they can ACCESS THE FORMATTER VARIABLE DIRECTLY from within their `logMessage:` method!
+ **/
+@interface OSSDDAbstractLogger : NSObject <OSSDDLogger>
+{
+    // Direct accessors to be used only for performance
+    @public
+    id <OSSDDLogFormatter> _logFormatter;
+    dispatch_queue_t _loggerQueue;
+}
+
+@property (nonatomic, strong, nullable) id <OSSDDLogFormatter> logFormatter;
+@property (nonatomic, DISPATCH_QUEUE_REFERENCE_TYPE) dispatch_queue_t loggerQueue;
+
+// For thread-safety assertions
+
+/**
+ *  Return YES if the current logger uses a global queue for logging
+ */
+@property (nonatomic, readonly, getter=isOnGlobalLoggingQueue)  BOOL onGlobalLoggingQueue;
+
+/**
+ *  Return YES if the current logger uses the internal designated queue for logging
+ */
+@property (nonatomic, readonly, getter=isOnInternalLoggerQueue) BOOL onInternalLoggerQueue;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+@interface OSSDDLoggerInformation : NSObject
+
+@property (nonatomic, readonly) id <OSSDDLogger> logger;
+@property (nonatomic, readonly) OSSDDLogLevel level;
+
++ (OSSDDLoggerInformation *)informationWithLogger:(id <OSSDDLogger>)logger
+                           andLevel:(OSSDDLogLevel)level;
+
+@end
+
+NS_ASSUME_NONNULL_END

Example/ios/AliyunOSSiOS.framework/Headers/OSSDefine.h

@@ -11,17 +11,27 @@
 #ifndef OSSDefine_h
 #define OSSDefine_h
 
+#if TARGET_OS_IOS
 #define OSSUAPrefix                             @"aliyun-sdk-ios"
-#define OSSSDKVersion                           @"2.6.1"
+#elif TARGET_OS_OSX
+#define OSSUAPrefix                             @"aliyun-sdk-mac"
+#endif
+#define OSSSDKVersion                           @"2.10.4"
 
 #define OSSListBucketResultXMLTOKEN             @"ListBucketResult"
 #define OSSNameXMLTOKEN                         @"Name"
 #define OSSDelimiterXMLTOKEN                    @"Delimiter"
 #define OSSMarkerXMLTOKEN                       @"Marker"
+#define OSSKeyMarkerXMLTOKEN                    @"KeyMarker"
 #define OSSNextMarkerXMLTOKEN                   @"NextMarker"
+#define OSSNextKeyMarkerXMLTOKEN                @"NextKeyMarker"
+#define OSSUploadIdMarkerXMLTOKEN               @"UploadIdMarker"
+#define OSSNextUploadIdMarkerXMLTOKEN           @"NextUploadIdMarker"
 #define OSSMaxKeysXMLTOKEN                      @"MaxKeys"
+#define OSSMaxUploadsXMLTOKEN                   @"MaxUploads"
 #define OSSIsTruncatedXMLTOKEN                  @"IsTruncated"
 #define OSSContentsXMLTOKEN                     @"Contents"
+#define OSSUploadXMLTOKEN                       @"Upload"
 #define OSSKeyXMLTOKEN                          @"Key"
 #define OSSLastModifiedXMLTOKEN                 @"LastModified"
 #define OSSETagXMLTOKEN                         @"ETag"
@@ -58,6 +68,7 @@
 #define OSSHttpHeaderContentMD5                 @"Content-MD5"
 #define OSSHttpHeaderCacheControl               @"Cache-Control"
 #define OSSHttpHeaderExpires                    @"Expires"
+#define OSSHttpHeaderHashSHA1                   @"x-oss-hash-sha1"
 
 #define OSSDefaultRetryCount                    3
 #define OSSDefaultMaxConcurrentNum              5

Example/ios/AliyunOSSiOS.framework/Headers/OSSDeleteMultipleObjectsRequest.h

@@ -0,0 +1,31 @@
+//
+//  OSSDeleteMultipleObjectsRequest.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/26.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+#import <Foundation/Foundation.h>
+#import "OSSRequest.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface OSSDeleteMultipleObjectsRequest : OSSRequest
+
+@property (nonatomic, copy) NSString *bucketName;
+
+@property (nonatomic, copy) NSArray<NSString *> *keys;
+
+/**
+ invalid value is @"url"
+ */
+@property (nonatomic, copy, nullable) NSString *encodingType;
+
+/**
+ whether to show verbose result,the default value is YES.
+ */
+@property (nonatomic, assign) BOOL quiet;
+
+@end
+
+NS_ASSUME_NONNULL_END

Example/ios/AliyunOSSiOS.framework/Headers/OSSDeleteMultipleObjectsResult.h

@@ -0,0 +1,17 @@
+//
+//  OSSDeleteMultipleObjectsResult.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/26.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import "OSSResult.h"
+
+@interface OSSDeleteMultipleObjectsResult : OSSResult
+
+@property (nonatomic, copy) NSArray<NSString *> *deletedObjects;
+
+@property (nonatomic, copy) NSString *encodingType;
+
+@end

Example/ios/AliyunOSSiOS.framework/Headers/OSSExecutor.h

@@ -37,7 +37,7 @@ NS_ASSUME_NONNULL_BEGIN
  Returns a new executor that uses the given block to execute continuations.
  @param block The block to use.
  */
-+ (instancetype)executorWithBlock:(void(^)(void(^block)()))block;
++ (instancetype)executorWithBlock:(void(^)(void(^block)(void)))block;
 
 /*!
  Returns a new executor that runs continuations on the given queue.
@@ -55,7 +55,7 @@ NS_ASSUME_NONNULL_BEGIN
  Runs the given block using this executor's particular strategy.
  @param block The block to execute.
  */
-- (void)execute:(void(^)())block;
+- (void)execute:(void(^)(void))block;
 
 @end
 

Example/ios/AliyunOSSiOS.framework/Headers/OSSFileLogger.h

@@ -0,0 +1,509 @@
+// Software License Agreement (BSD License)
+//
+// Copyright (c) 2010-2016, Deusty, LLC
+// All rights reserved.
+//
+// Redistribution and use of this software in source and binary forms,
+// with or without modification, are permitted provided that the following conditions are met:
+//
+// * Redistributions of source code must retain the above copyright notice,
+//   this list of conditions and the following disclaimer.
+//
+// * Neither the name of Deusty nor the names of its contributors may be used
+//   to endorse or promote products derived from this software without specific
+//   prior written permission of Deusty, LLC.
+
+// Disable legacy macros
+#ifndef DD_LEGACY_MACROS
+    #define DD_LEGACY_MACROS 0
+#endif
+
+#import "OSSDDLog.h"
+
+@class OSSDDLogFileInfo;
+
+/**
+ * This class provides a logger to write log statements to a file.
+ **/
+
+
+// Default configuration and safety/sanity values.
+//
+// maximumFileSize         -> kDDDefaultLogMaxFileSize
+// rollingFrequency        -> kDDDefaultLogRollingFrequency
+// maximumNumberOfLogFiles -> kDDDefaultLogMaxNumLogFiles
+// logFilesDiskQuota       -> kDDDefaultLogFilesDiskQuota
+//
+// You should carefully consider the proper configuration values for your application.
+
+extern unsigned long long const osskDDDefaultLogMaxFileSize;
+extern NSTimeInterval     const osskDDDefaultLogRollingFrequency;
+extern NSUInteger         const osskDDDefaultLogMaxNumLogFiles;
+extern unsigned long long const osskDDDefaultLogFilesDiskQuota;
+
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ *  The LogFileManager protocol is designed to allow you to control all aspects of your log files.
+ *
+ *  The primary purpose of this is to allow you to do something with the log files after they have been rolled.
+ *  Perhaps you want to compress them to save disk space.
+ *  Perhaps you want to upload them to an FTP server.
+ *  Perhaps you want to run some analytics on the file.
+ *
+ *  A default LogFileManager is, of course, provided.
+ *  The default LogFileManager simply deletes old log files according to the maximumNumberOfLogFiles property.
+ *
+ *  This protocol provides various methods to fetch the list of log files.
+ *
+ *  There are two variants: sorted and unsorted.
+ *  If sorting is not necessary, the unsorted variant is obviously faster.
+ *  The sorted variant will return an array sorted by when the log files were created,
+ *  with the most recently created log file at index 0, and the oldest log file at the end of the array.
+ *
+ *  You can fetch only the log file paths (full path including name), log file names (name only),
+ *  or an array of `DDLogFileInfo` objects.
+ *  The `DDLogFileInfo` class is documented below, and provides a handy wrapper that
+ *  gives you easy access to various file attributes such as the creation date or the file size.
+ */
+@protocol OSSDDLogFileManager <NSObject>
+@required
+
+// Public properties
+
+/**
+ * The maximum number of archived log files to keep on disk.
+ * For example, if this property is set to 3,
+ * then the LogFileManager will only keep 3 archived log files (plus the current active log file) on disk.
+ * Once the active log file is rolled/archived, then the oldest of the existing 3 rolled/archived log files is deleted.
+ *
+ * You may optionally disable this option by setting it to zero.
+ **/
+@property (readwrite, assign, atomic) NSUInteger maximumNumberOfLogFiles;
+
+/**
+ * The maximum space that logs can take. On rolling logfile all old logfiles that exceed logFilesDiskQuota will
+ * be deleted.
+ *
+ * You may optionally disable this option by setting it to zero.
+ **/
+@property (readwrite, assign, atomic) unsigned long long logFilesDiskQuota;
+
+// Public methods
+
+/**
+ *  Returns the logs directory (path)
+ */
+@property (nonatomic, readonly, copy) NSString *logsDirectory;
+
+/**
+ * Returns an array of `NSString` objects,
+ * each of which is the filePath to an existing log file on disk.
+ **/
+@property (nonatomic, readonly, strong) NSArray<NSString *> *unsortedLogFilePaths;
+
+/**
+ * Returns an array of `NSString` objects,
+ * each of which is the fileName of an existing log file on disk.
+ **/
+@property (nonatomic, readonly, strong) NSArray<NSString *> *unsortedLogFileNames;
+
+/**
+ * Returns an array of `DDLogFileInfo` objects,
+ * each representing an existing log file on disk,
+ * and containing important information about the log file such as it's modification date and size.
+ **/
+@property (nonatomic, readonly, strong) NSArray<OSSDDLogFileInfo *> *unsortedLogFileInfos;
+
+/**
+ * Just like the `unsortedLogFilePaths` method, but sorts the array.
+ * The items in the array are sorted by creation date.
+ * The first item in the array will be the most recently created log file.
+ **/
+@property (nonatomic, readonly, strong) NSArray<NSString *> *sortedLogFilePaths;
+
+/**
+ * Just like the `unsortedLogFileNames` method, but sorts the array.
+ * The items in the array are sorted by creation date.
+ * The first item in the array will be the most recently created log file.
+ **/
+@property (nonatomic, readonly, strong) NSArray<NSString *> *sortedLogFileNames;
+
+/**
+ * Just like the `unsortedLogFileInfos` method, but sorts the array.
+ * The items in the array are sorted by creation date.
+ * The first item in the array will be the most recently created log file.
+ **/
+@property (nonatomic, readonly, strong) NSArray<OSSDDLogFileInfo *> *sortedLogFileInfos;
+
+// Private methods (only to be used by DDFileLogger)
+
+/**
+ * Generates a new unique log file path, and creates the corresponding log file.
+ **/
+- (NSString *)createNewLogFile;
+
+@optional
+
+// Notifications from DDFileLogger
+
+/**
+ *  Called when a log file was archieved
+ */
+- (void)didArchiveLogFile:(NSString *)logFilePath NS_SWIFT_NAME(didArchiveLogFile(atPath:));
+
+/**
+ *  Called when the roll action was executed and the log was archieved
+ */
+- (void)didRollAndArchiveLogFile:(NSString *)logFilePath NS_SWIFT_NAME(didRollAndArchiveLogFile(atPath:));
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * Default log file manager.
+ *
+ * All log files are placed inside the logsDirectory.
+ * If a specific logsDirectory isn't specified, the default directory is used.
+ * On Mac, this is in `~/Library/Logs/<Application Name>`.
+ * On iPhone, this is in `~/Library/Caches/Logs`.
+ *
+ * Log files are named `"<bundle identifier> <date> <time>.log"`
+ * Example: `com.organization.myapp 2013-12-03 17-14.log`
+ *
+ * Archived log files are automatically deleted according to the `maximumNumberOfLogFiles` property.
+ **/
+@interface OSSDDLogFileManagerDefault : NSObject <OSSDDLogFileManager>
+
+/**
+ *  Default initializer
+ */
+- (instancetype)init;
+
+/**
+ *  Designated initialized, requires the logs directory
+ */
+- (instancetype)initWithLogsDirectory:(NSString *)logsDirectory NS_DESIGNATED_INITIALIZER;
+
+#if TARGET_OS_IPHONE
+/*
+ * Calling this constructor you can override the default "automagically" chosen NSFileProtection level.
+ * Useful if you are writing a command line utility / CydiaSubstrate addon for iOS that has no NSBundle
+ * or like SpringBoard no BackgroundModes key in the NSBundle:
+ *    iPhone:~ root# cycript -p SpringBoard
+ *    cy# [NSBundle mainBundle]
+ *    #"NSBundle </System/Library/CoreServices/SpringBoard.app> (loaded)"
+ *    cy# [[NSBundle mainBundle] objectForInfoDictionaryKey:@"UIBackgroundModes"];
+ *    null
+ *    cy#
+ **/
+- (instancetype)initWithLogsDirectory:(NSString *)logsDirectory defaultFileProtectionLevel:(NSFileProtectionType)fileProtectionLevel;
+#endif
+
+/*
+ * Methods to override.
+ *
+ * Log files are named `"<bundle identifier> <date> <time>.log"`
+ * Example: `com.organization.myapp 2013-12-03 17-14.log`
+ *
+ * If you wish to change default filename, you can override following two methods.
+ * - `newLogFileName` method would be called on new logfile creation.
+ * - `isLogFile:` method would be called to filter logfiles from all other files in logsDirectory.
+ *   You have to parse given filename and return YES if it is logFile.
+ *
+ * **NOTE**
+ * `newLogFileName` returns filename. If appropriate file already exists, number would be added
+ * to filename before extension. You have to handle this case in isLogFile: method.
+ *
+ * Example:
+ * - newLogFileName returns `"com.organization.myapp 2013-12-03.log"`,
+ *   file `"com.organization.myapp 2013-12-03.log"` would be created.
+ * - after some time `"com.organization.myapp 2013-12-03.log"` is archived
+ * - newLogFileName again returns `"com.organization.myapp 2013-12-03.log"`,
+ *   file `"com.organization.myapp 2013-12-03 2.log"` would be created.
+ * - after some time `"com.organization.myapp 2013-12-03 1.log"` is archived
+ * - newLogFileName again returns `"com.organization.myapp 2013-12-03.log"`,
+ *   file `"com.organization.myapp 2013-12-03 3.log"` would be created.
+ **/
+
+/**
+ * Generates log file name with default format `"<bundle identifier> <date> <time>.log"`
+ * Example: `MobileSafari 2013-12-03 17-14.log`
+ *
+ * You can change it by overriding `newLogFileName` and `isLogFile:` methods.
+ **/
+@property (readonly, copy) NSString *newLogFileName;
+
+/**
+ * Default log file name is `"<bundle identifier> <date> <time>.log"`.
+ * Example: `MobileSafari 2013-12-03 17-14.log`
+ *
+ * You can change it by overriding `newLogFileName` and `isLogFile:` methods.
+ **/
+- (BOOL)isLogFile:(NSString *)fileName NS_SWIFT_NAME(isLogFile(withName:));
+
+/* Inherited from DDLogFileManager protocol:
+
+   @property (readwrite, assign, atomic) NSUInteger maximumNumberOfLogFiles;
+   @property (readwrite, assign, atomic) NSUInteger logFilesDiskQuota;
+
+   - (NSString *)logsDirectory;
+
+   - (NSArray *)unsortedLogFilePaths;
+   - (NSArray *)unsortedLogFileNames;
+   - (NSArray *)unsortedLogFileInfos;
+
+   - (NSArray *)sortedLogFilePaths;
+   - (NSArray *)sortedLogFileNames;
+   - (NSArray *)sortedLogFileInfos;
+
+ */
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * Most users will want file log messages to be prepended with the date and time.
+ * Rather than forcing the majority of users to write their own formatter,
+ * we will supply a logical default formatter.
+ * Users can easily replace this formatter with their own by invoking the `setLogFormatter:` method.
+ * It can also be removed by calling `setLogFormatter:`, and passing a nil parameter.
+ *
+ * In addition to the convenience of having a logical default formatter,
+ * it will also provide a template that makes it easy for developers to copy and change.
+ **/
+@interface OSSDDLogFileFormatterDefault : NSObject <OSSDDLogFormatter>
+
+/**
+ *  Default initializer
+ */
+- (instancetype)init;
+
+/**
+ *  Designated initializer, requires a date formatter
+ */
+- (instancetype)initWithDateFormatter:(NSDateFormatter *)dateFormatter NS_DESIGNATED_INITIALIZER;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ *  The standard implementation for a file logger
+ */
+@interface OSSDDFileLogger : OSSDDAbstractLogger <OSSDDLogger> {
+	OSSDDLogFileInfo *_currentLogFileInfo;
+}
+
+/**
+ *  Default initializer
+ */
+- (instancetype)init;
+
+/**
+ *  Designated initializer, requires a `DDLogFileManager` instance
+ */
+- (instancetype)initWithLogFileManager:(id <OSSDDLogFileManager>)logFileManager NS_DESIGNATED_INITIALIZER;
+
+/**
+ *  Called when the logger is about to write message. Call super before your implementation.
+ */
+- (void)willLogMessage NS_REQUIRES_SUPER;
+
+/**
+ *  Called when the logger wrote message. Call super after your implementation.
+ */
+- (void)didLogMessage NS_REQUIRES_SUPER;
+
+/**
+ *  Called when the logger checks archive or not current log file. 
+ *  Override this method to exdend standart behavior. By default returns NO.
+ */
+- (BOOL)shouldArchiveRecentLogFileInfo:(OSSDDLogFileInfo *)recentLogFileInfo;
+
+/**
+ * Log File Rolling:
+ *
+ * `maximumFileSize`:
+ *   The approximate maximum size (in bytes) to allow log files to grow.
+ *   If a log file is larger than this value after a log statement is appended,
+ *   then the log file is rolled.
+ *
+ * `rollingFrequency`
+ *   How often to roll the log file.
+ *   The frequency is given as an `NSTimeInterval`, which is a double that specifies the interval in seconds.
+ *   Once the log file gets to be this old, it is rolled.
+ *
+ * `doNotReuseLogFiles`
+ *   When set, will always create a new log file at application launch.
+ *
+ * Both the `maximumFileSize` and the `rollingFrequency` are used to manage rolling.
+ * Whichever occurs first will cause the log file to be rolled.
+ *
+ * For example:
+ * The `rollingFrequency` is 24 hours,
+ * but the log file surpasses the `maximumFileSize` after only 20 hours.
+ * The log file will be rolled at that 20 hour mark.
+ * A new log file will be created, and the 24 hour timer will be restarted.
+ *
+ * You may optionally disable rolling due to filesize by setting `maximumFileSize` to zero.
+ * If you do so, rolling is based solely on `rollingFrequency`.
+ *
+ * You may optionally disable rolling due to time by setting `rollingFrequency` to zero (or any non-positive number).
+ * If you do so, rolling is based solely on `maximumFileSize`.
+ *
+ * If you disable both `maximumFileSize` and `rollingFrequency`, then the log file won't ever be rolled.
+ * This is strongly discouraged.
+ **/
+@property (readwrite, assign) unsigned long long maximumFileSize;
+
+/**
+ *  See description for `maximumFileSize`
+ */
+@property (readwrite, assign) NSTimeInterval rollingFrequency;
+
+/**
+ *  See description for `maximumFileSize`
+ */
+@property (readwrite, assign, atomic) BOOL doNotReuseLogFiles;
+
+/**
+ * The DDLogFileManager instance can be used to retrieve the list of log files,
+ * and configure the maximum number of archived log files to keep.
+ *
+ * @see DDLogFileManager.maximumNumberOfLogFiles
+ **/
+@property (strong, nonatomic, readonly) id <OSSDDLogFileManager> logFileManager;
+
+/**
+ * When using a custom formatter you can set the `logMessage` method not to append
+ * `\n` character after each output. This allows for some greater flexibility with
+ * custom formatters. Default value is YES.
+ **/
+@property (nonatomic, readwrite, assign) BOOL automaticallyAppendNewlineForCustomFormatters;
+
+/**
+ *  You can optionally force the current log file to be rolled with this method.
+ *  CompletionBlock will be called on main queue.
+ */
+- (void)rollLogFileWithCompletionBlock:(void (^)(void))completionBlock NS_SWIFT_NAME(rollLogFile(withCompletion:));
+
+/**
+ *  Method is deprecated.
+ *  @deprecated Use `rollLogFileWithCompletionBlock:` method instead.
+ */
+- (void)rollLogFile __attribute((deprecated));
+
+// Inherited from DDAbstractLogger
+
+// - (id <DDLogFormatter>)logFormatter;
+// - (void)setLogFormatter:(id <DDLogFormatter>)formatter;
+
+/**
+ * Returns the log file that should be used.
+ * If there is an existing log file that is suitable,
+ * within the constraints of `maximumFileSize` and `rollingFrequency`, then it is returned.
+ *
+ * Otherwise a new file is created and returned.
+ **/
+@property (nonatomic, readonly, strong) OSSDDLogFileInfo *currentLogFileInfo;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * `DDLogFileInfo` is a simple class that provides access to various file attributes.
+ * It provides good performance as it only fetches the information if requested,
+ * and it caches the information to prevent duplicate fetches.
+ *
+ * It was designed to provide quick snapshots of the current state of log files,
+ * and to help sort log files in an array.
+ *
+ * This class does not monitor the files, or update it's cached attribute values if the file changes on disk.
+ * This is not what the class was designed for.
+ *
+ * If you absolutely must get updated values,
+ * you can invoke the reset method which will clear the cache.
+ **/
+@interface OSSDDLogFileInfo : NSObject
+
+@property (strong, nonatomic, readonly) NSString *filePath;
+@property (strong, nonatomic, readonly) NSString *fileName;
+
+#if FOUNDATION_SWIFT_SDK_EPOCH_AT_LEAST(8)
+@property (strong, nonatomic, readonly) NSDictionary<NSFileAttributeKey, id> *fileAttributes;
+#else
+@property (strong, nonatomic, readonly) NSDictionary<NSString *, id> *fileAttributes;
+#endif
+
+@property (strong, nonatomic, readonly) NSDate *creationDate;
+@property (strong, nonatomic, readonly) NSDate *modificationDate;
+
+@property (nonatomic, readonly) unsigned long long fileSize;
+
+@property (nonatomic, readonly) NSTimeInterval age;
+
+@property (nonatomic, readwrite) BOOL isArchived;
+
++ (instancetype)logFileWithPath:(NSString *)filePath NS_SWIFT_UNAVAILABLE("Use init(filePath:)");
+
+- (instancetype)init NS_UNAVAILABLE;
+- (instancetype)initWithFilePath:(NSString *)filePath NS_DESIGNATED_INITIALIZER;
+
+- (void)reset;
+- (void)renameFile:(NSString *)newFileName NS_SWIFT_NAME(renameFile(to:));
+
+#if TARGET_IPHONE_SIMULATOR
+
+// So here's the situation.
+// Extended attributes are perfect for what we're trying to do here (marking files as archived).
+// This is exactly what extended attributes were designed for.
+//
+// But Apple screws us over on the simulator.
+// Everytime you build-and-go, they copy the application into a new folder on the hard drive,
+// and as part of the process they strip extended attributes from our log files.
+// Normally, a copy of a file preserves extended attributes.
+// So obviously Apple has gone to great lengths to piss us off.
+//
+// Thus we use a slightly different tactic for marking log files as archived in the simulator.
+// That way it "just works" and there's no confusion when testing.
+//
+// The difference in method names is indicative of the difference in functionality.
+// On the simulator we add an attribute by appending a filename extension.
+//
+// For example:
+// "mylog.txt" -> "mylog.archived.txt"
+// "mylog"     -> "mylog.archived"
+
+- (BOOL)hasExtensionAttributeWithName:(NSString *)attrName;
+
+- (void)addExtensionAttributeWithName:(NSString *)attrName;
+- (void)removeExtensionAttributeWithName:(NSString *)attrName;
+
+#else /* if TARGET_IPHONE_SIMULATOR */
+
+// Normal use of extended attributes used everywhere else,
+// such as on Macs and on iPhone devices.
+
+- (BOOL)hasExtendedAttributeWithName:(NSString *)attrName;
+
+- (void)addExtendedAttributeWithName:(NSString *)attrName;
+- (void)removeExtendedAttributeWithName:(NSString *)attrName;
+
+#endif /* if TARGET_IPHONE_SIMULATOR */
+
+@end

Example/ios/AliyunOSSiOS.framework/Headers/OSSGetObjectACLRequest.h

@@ -0,0 +1,26 @@
+//
+//  OSSGetObjectACLRequest.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/26.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import "OSSRequest.h"
+
+NS_ASSUME_NONNULL_BEGIN
+@interface OSSGetObjectACLRequest : OSSRequest
+
+/**
+ the bucket's name which object stored
+ */
+@property (nonatomic, copy) NSString *bucketName;
+
+/**
+ the name of object
+ */
+@property (nonatomic, copy) NSString *objectName;
+
+
+@end
+NS_ASSUME_NONNULL_END

Example/ios/AliyunOSSiOS.framework/Headers/OSSGetObjectACLResult.h

@@ -0,0 +1,19 @@
+//
+//  OSSGetObjectACLResult.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/26.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import "OSSResult.h"
+
+@interface OSSGetObjectACLResult : OSSResult
+
+/**
+ the ACL of object,valid values: @"private",@"public-read",@"public-read-write".
+ if object's ACL inherit from bucket,it will return @"default".
+ */
+@property (nonatomic, copy) NSString *grant;
+
+@end

Example/ios/AliyunOSSiOS.framework/Headers/OSSHttpResponseParser.h

@@ -0,0 +1,39 @@
+//
+//  OSSHttpResponseParser.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/22.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "OSSConstants.h"
+#import "OSSTask.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ HTTP response parser
+ */
+@interface OSSHttpResponseParser : NSObject
+
+@property (nonatomic, copy) OSSNetworkingOnRecieveDataBlock onRecieveBlock;
+
+@property (nonatomic, strong) NSURL *downloadingFileURL;
+
+/**
+ *  A Boolean value that determines whether verfifying crc64.
+ When set to YES, it will verify crc64 when transmission is completed normally.
+ The default value of this property is NO.
+ */
+@property (nonatomic, assign) BOOL crc64Verifiable;
+
+- (instancetype)initForOperationType:(OSSOperationType)operationType;
+- (void)consumeHttpResponse:(NSHTTPURLResponse *)response;
+- (OSSTask *)consumeHttpResponseBody:(NSData *)data;
+- (nullable id)constructResultObject;
+- (void)reset;
+
+@end
+
+NS_ASSUME_NONNULL_END

Example/ios/AliyunOSSiOS.framework/Headers/OSSHttpdns.h

@@ -0,0 +1,16 @@
+//
+//  OSSHttpdns.h
+//  AliyunOSSiOS
+//
+//  Created by zhouzhuo on 5/1/16.
+//  Copyright © 2016 zhouzhuo. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+@interface OSSHttpdns : NSObject
+
++ (instancetype)sharedInstance;
+
+- (NSString *)asynGetIpByHost:(NSString *)host;
+@end

Example/ios/AliyunOSSiOS.framework/Headers/OSSIPv6Adapter.h

@@ -0,0 +1,113 @@
+/*
+ * Copyright (c) 2000-2015 Apple Inc. All rights reserved.
+ *
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
+ *
+ * This file contains Original Code and/or Modifications of Original Code
+ * as defined in and that are subject to the Apple Public Source License
+ * Version 2.0 (the 'License'). You may not use this file except in
+ * compliance with the License. The rights granted to you under the License
+ * may not be used to create, or enable the creation or redistribution of,
+ * unlawful or unlicensed copies of an Apple operating system, or to
+ * circumvent, violate, or enable the circumvention or violation of, any
+ * terms of an Apple operating system software license agreement.
+ *
+ * Please obtain a copy of the License at
+ * https://www.opensource.apple.com/apsl/ and read it before using this file.
+ *
+ * The Original Code and all software distributed under the License are
+ * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
+ * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
+ * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
+ * Please see the License for the specific language governing rights and
+ * limitations under the License.
+ *
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
+ */
+/*
+ * Copyright (c) 1980, 1986, 1993
+ *	The Regents of the University of California.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ * 3. All advertising materials mentioning features or use of this software
+ *    must display the following acknowledgement:
+ *	This product includes software developed by the University of
+ *	California, Berkeley and its contributors.
+ * 4. Neither the name of the University nor the names of its contributors
+ *    may be used to endorse or promote products derived from this software
+ *    without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ *
+ *	@(#)route.h	8.3 (Berkeley) 4/19/94
+ * $FreeBSD: src/sys/net/route.h,v 1.36.2.1 2000/08/16 06:14:23 jayanth Exp $
+ */
+
+
+#ifndef AlicloudIPv6Adapter_h
+#define AlicloudIPv6Adapter_h
+#import <Foundation/Foundation.h>
+
+@interface OSSIPv6Adapter : NSObject
+
++ (instancetype)getInstance;
+
+/**
+ *	@brief	Checks if it's a IPv6-only network. If it's true, it's IPv6-only.
+ *
+ *	@return return YES for IPv6-only network,otherWise return NO
+ */
+- (BOOL)isIPv6OnlyNetwork;
+
+/**
+ *	@brief	Refresh the IPV6-only check
+ *
+ *	@return return YES for IPv6-only network,otherWise return NO
+ */
+- (BOOL)reResolveIPv6OnlyStatus;
+
+/**
+ *	@brief	Adapts the IPv4 address into IPv6 format under IPv6-only network.
+ *          For example:
+                42.156.220.114 -> 64:ff9b::2a9c:dc72
+ *	@param 	addr
+ *
+ *	@return return an IPv6 address
+ */
+- (NSString *)handleIpv4Address:(NSString *)addr;
+
+/**
+ *	@brief	Checks if it's an IPv4 address.
+ *
+ *	@return return YES while addr is an IPv4 address,otherwise return NO
+ */
+- (BOOL)isIPv4Address:(NSString *)addr;
+
+/**
+ *	@brief	Checks if it's an IPv6 address
+ *
+ *	@return return YES while addr is an IPv6 address,otherwise return NO
+ */
+- (BOOL)isIPv6Address:(NSString *)addr;
+
+@end
+
+#endif /* OSSIPv6Adapter_h */

Example/ios/AliyunOSSiOS.framework/Headers/OSSIPv6PrefixResolver.h

@@ -0,0 +1,23 @@
+//
+//  OSSIPv6PrefixResolver.h
+//
+//  Created by lingkun on 16/5/16.
+//  Edit by zhouzhuo on 16/5/22
+//  Copyright © 2016 Ali. All rights reserved.
+//
+
+#ifndef AlicloudIPv6PrefixResolver_h
+#define AlicloudIPv6PrefixResolver_h
+#import <Foundation/Foundation.h>
+
+@interface OSSIPv6PrefixResolver : NSObject
+
++ (instancetype)getInstance;
+
+- (void)updateIPv6Prefix;
+
+- (NSString *)convertIPv4toIPv6:(NSString *)ipv4;
+
+@end
+
+#endif /* OSSIPv6PrefixResolver_h */

Example/ios/AliyunOSSiOS.framework/Headers/OSSLog.h

@@ -7,6 +7,8 @@
 //
 
 #import <Foundation/Foundation.h>
+#import "OSSCocoaLumberjack.h"
+static const OSSDDLogLevel ossLogLevel = OSSDDLogLevelAll;
 
 // colorful log configuration
 // see https://github.com/robbiehanson/XcodeColors
@@ -19,21 +21,33 @@
 
 #define OSSLogVerbose(frmt, ...)\
 if ([OSSLog isLogEnable]) {\
-NSLog(@"[Verbose]: %@", [NSString stringWithFormat:(frmt), ##__VA_ARGS__]);\
+OSSDDLogVerbose(@"[Verbose]: %@", [NSString stringWithFormat:(frmt), ##__VA_ARGS__]);\
 }
 
 #define OSSLogDebug(frmt, ...)\
 if ([OSSLog isLogEnable]) {\
+OSSDDLogDebug(@"[Debug]: %@", [NSString stringWithFormat:(frmt), ##__VA_ARGS__]);\
+}
+
+#define OSSLogDebugNoFile(frmt, ...)\
+if ([OSSLog isLogEnable]) {\
 NSLog(@"[Debug]: %@", [NSString stringWithFormat:(frmt), ##__VA_ARGS__]);\
 }
 
 #define OSSLogError(frmt, ...)\
 if ([OSSLog isLogEnable]) {\
-NSLog(@"[Error]: %@", [NSString stringWithFormat:(frmt), ##__VA_ARGS__]);\
+OSSDDLogError(@"[Error]: %@", [NSString stringWithFormat:(frmt), ##__VA_ARGS__]);\
+}
+
+#define OSSLogWarn(frmt, ...)\
+if ([OSSLog isLogEnable]) {\
+OSSDDLogWarn(@"[Warning]: %@", [NSString stringWithFormat:(frmt), ##__VA_ARGS__]);\
 }
+
 static BOOL isEnable;
 
 @interface OSSLog : NSObject
+
 + (void)enableLog;
 + (void)disableLog;
 + (BOOL)isLogEnable;

Example/ios/AliyunOSSiOS.framework/Headers/OSSLogMacros.h

@@ -0,0 +1,82 @@
+// Software License Agreement (BSD License)
+//
+// Copyright (c) 2010-2016, Deusty, LLC
+// All rights reserved.
+//
+// Redistribution and use of this software in source and binary forms,
+// with or without modification, are permitted provided that the following conditions are met:
+//
+// * Redistributions of source code must retain the above copyright notice,
+//   this list of conditions and the following disclaimer.
+//
+// * Neither the name of Deusty nor the names of its contributors may be used
+//   to endorse or promote products derived from this software without specific
+//   prior written permission of Deusty, LLC.
+
+// Disable legacy macros
+#ifndef OSSDD_LEGACY_MACROS
+    #define OSSDD_LEGACY_MACROS 0
+#endif
+
+#import "OSSDDLog.h"
+
+/**
+ * The constant/variable/method responsible for controlling the current log level.
+ **/
+#ifndef OSSLOG_LEVEL_DEF
+    #define OSSLOG_LEVEL_DEF ossLogLevel
+#endif
+
+/**
+ * Whether async should be used by log messages, excluding error messages that are always sent sync.
+ **/
+#ifndef OSSLOG_ASYNC_ENABLED
+    #define OSSLOG_ASYNC_ENABLED YES
+#endif
+
+/**
+ * These are the two macros that all other macros below compile into.
+ * These big multiline macros makes all the other macros easier to read.
+ **/
+#define OSSLOG_MACRO(isAsynchronous, lvl, flg, ctx, atag, fnct, frmt, ...) \
+        [OSSDDLog log : isAsynchronous                                     \
+             level : lvl                                                \
+              flag : flg                                                \
+           context : ctx                                                \
+              file : __FILE__                                           \
+          function : fnct                                               \
+              line : __LINE__                                           \
+               tag : atag                                               \
+            format : (frmt), ## __VA_ARGS__]
+
+/**
+ * Define version of the macro that only execute if the log level is above the threshold.
+ * The compiled versions essentially look like this:
+ *
+ * if (logFlagForThisLogMsg & ddLogLevel) { execute log message }
+ *
+ * When LOG_LEVEL_DEF is defined as ddLogLevel.
+ *
+ * As shown further below, Lumberjack actually uses a bitmask as opposed to primitive log levels.
+ * This allows for a great amount of flexibility and some pretty advanced fine grained logging techniques.
+ *
+ * Note that when compiler optimizations are enabled (as they are for your release builds),
+ * the log messages above your logging threshold will automatically be compiled out.
+ *
+ * (If the compiler sees LOG_LEVEL_DEF/ddLogLevel declared as a constant, the compiler simply checks to see
+ *  if the 'if' statement would execute, and if not it strips it from the binary.)
+ *
+ * We also define shorthand versions for asynchronous and synchronous logging.
+ **/
+#define OSSLOG_MAYBE(async, lvl, flg, ctx, tag, fnct, frmt, ...) \
+        do { if(lvl & flg) OSSLOG_MACRO(async, lvl, flg, ctx, tag, fnct, frmt, ##__VA_ARGS__); } while(0)
+
+/**
+ * Ready to use log macros with no context or tag.
+ **/
+#define OSSDDLogError(frmt, ...)   OSSLOG_MAYBE(NO,                OSSLOG_LEVEL_DEF, OSSDDLogFlagError,   0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
+#define OSSDDLogWarn(frmt, ...)    OSSLOG_MAYBE(OSSLOG_ASYNC_ENABLED, OSSLOG_LEVEL_DEF, OSSDDLogFlagWarning, 0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
+#define OSSDDLogInfo(frmt, ...)    OSSLOG_MAYBE(OSSLOG_ASYNC_ENABLED, OSSLOG_LEVEL_DEF, OSSDDLogFlagInfo,    0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
+#define OSSDDLogDebug(frmt, ...)   OSSLOG_MAYBE(OSSLOG_ASYNC_ENABLED, OSSLOG_LEVEL_DEF, OSSDDLogFlagDebug,   0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
+#define OSSDDLogVerbose(frmt, ...) OSSLOG_MAYBE(OSSLOG_ASYNC_ENABLED, OSSLOG_LEVEL_DEF, OSSDDLogFlagVerbose, 0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
+

Example/ios/AliyunOSSiOS.framework/Headers/OSSNSLogger.h

@@ -0,0 +1,14 @@
+//
+//  OSSNSLogger.h
+//  AliyunOSSiOS
+//
+//  Created by jingdan on 2017/10/24.
+//  Copyright © 2017年 zhouzhuo. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "OSSDDLog.h"
+
+@interface OSSNSLogger : OSSDDAbstractLogger <OSSDDLogger>
+@property (class, readonly, strong) OSSNSLogger *sharedInstance;
+@end

Example/ios/AliyunOSSiOS.framework/Headers/OSSNetworking.h

@@ -13,36 +13,10 @@
 @class OSSNetworkingRequestDelegate;
 @class OSSExecutor;
 
-/**
- 定义重试类型
- */
-typedef NS_ENUM(NSInteger, OSSNetworkingRetryType) {
-    OSSNetworkingRetryTypeUnknown,
-    OSSNetworkingRetryTypeShouldRetry,
-    OSSNetworkingRetryTypeShouldNotRetry,
-    OSSNetworkingRetryTypeShouldRefreshCredentialsAndRetry,
-    OSSNetworkingRetryTypeShouldCorrectClockSkewAndRetry
-};
-
-/**
- 重试处理器
- */
-@interface OSSURLRequestRetryHandler : NSObject
-@property (nonatomic, assign) uint32_t maxRetryCount;
 
-- (OSSNetworkingRetryType)shouldRetry:(uint32_t)currentRetryCount
-                      requestDelegate:(OSSNetworkingRequestDelegate *)delegate
-                             response:(NSHTTPURLResponse *)response
-                                error:(NSError *)error;
-
-- (NSTimeInterval)timeIntervalForRetry:(uint32_t)currentRetryCount
-                             retryType:(OSSNetworkingRetryType)retryType;
-
-+ (instancetype)defaultRetryHandler;
-@end
 
 /**
- 网络参数设置
+ Network parameters
  */
 @interface OSSNetworkingConfiguration : NSObject
 @property (nonatomic, assign) uint32_t maxRetryCount;
@@ -55,82 +29,11 @@ typedef NS_ENUM(NSInteger, OSSNetworkingRetryType) {
 @property (nonatomic, strong) NSNumber * proxyPort;
 @end
 
-/**
- 对操作发起的每一次请求构造一个信息代理
- */
-@interface OSSNetworkingRequestDelegate : NSObject
-
-@property (nonatomic, strong) NSMutableArray * interceptors;
-@property (nonatomic, strong) OSSAllRequestNeededMessage * allNeededMessage;
-@property (nonatomic, strong) NSMutableURLRequest * internalRequest;
-@property (nonatomic, assign) OSSOperationType operType;
-@property (nonatomic, assign) BOOL isAccessViaProxy;
-
-@property (nonatomic, assign) BOOL isRequestCancelled;
-
-@property (nonatomic, strong) OSSHttpResponseParser * responseParser;
-
-@property (nonatomic, strong) NSData * uploadingData;
-@property (nonatomic, strong) NSURL * uploadingFileURL;
-
-@property (nonatomic, assign) int64_t payloadTotalBytesWritten;
-
-@property (nonatomic, assign) BOOL isBackgroundUploadFileTask;
-@property (nonatomic, assign) BOOL isHttpdnsEnable;
-
-@property (nonatomic, strong) OSSURLRequestRetryHandler * retryHandler;
-@property (nonatomic, assign) uint32_t currentRetryCount;
-@property (nonatomic, strong) NSError * error;
-@property (nonatomic, assign) BOOL isHttpRequestNotSuccessResponse;
-@property (nonatomic, strong) NSMutableData * httpRequestNotSuccessResponseBody;
-
-@property (atomic, strong) NSURLSessionDataTask * currentSessionTask;
-
-@property (nonatomic, copy) OSSNetworkingUploadProgressBlock uploadProgress;
-@property (nonatomic, copy) OSSNetworkingDownloadProgressBlock downloadProgress;
-@property (nonatomic, copy) OSSNetworkingCompletionHandlerBlock completionHandler;
-@property (nonatomic, copy) OSSNetworkingOnRecieveDataBlock onRecieveData;
-
-- (OSSTask *)buildInternalHttpRequest;
-- (void)reset;
-- (void)cancel;
-@end
-
-/**
- 包含一次网络请求所需的所有信息
- */
-@interface OSSAllRequestNeededMessage : NSObject
-@property (nonatomic, strong) NSString * endpoint;
-@property (nonatomic, strong) NSString * httpMethod;
-@property (nonatomic, strong) NSString * bucketName;
-@property (nonatomic, strong) NSString * objectKey;
-@property (nonatomic, strong) NSString * contentType;
-@property (nonatomic, strong) NSString * contentMd5;
-@property (nonatomic, strong) NSString * range;
-@property (nonatomic, strong) NSString * date;
-@property (nonatomic, strong) NSMutableDictionary * headerParams;
-@property (nonatomic, strong) NSMutableDictionary * querys;
-
-@property (nonatomic, assign) BOOL isHostInCnameExcludeList;
-
-- (instancetype)initWithEndpoint:(NSString *)endpoint
-                      httpMethod:(NSString *)httpMethod
-                      bucketName:(NSString *)bucketName
-                       objectKey:(NSString *)objectKey
-                            type:(NSString *)contentType
-                             md5:(NSString *)contentMd5
-                           range:(NSString *)range
-                            date:(NSString *)date
-                    headerParams:(NSMutableDictionary *)headerParams
-                          querys:(NSMutableDictionary *)querys;
-
-- (OSSTask *)validateRequestParamsInOperationType:(OSSOperationType)operType;
-@end
 
 /**
- 每个OSSClient持有一个OSSNetworking用以收发网络请求
+ The network interface which OSSClient uses for network read and write operations.
  */
-@interface OSSNetworking : NSObject <NSURLSessionDelegate>
+@interface OSSNetworking : NSObject <NSURLSessionDelegate, NSURLSessionDataDelegate>
 @property (nonatomic, strong) NSURLSession * dataSession;
 @property (nonatomic, strong) NSURLSession * uploadFileSession;
 @property (nonatomic, assign) BOOL isUsingBackgroundSession;

Example/ios/AliyunOSSiOS.framework/Headers/OSSNetworkingRequestDelegate.h

@@ -0,0 +1,76 @@
+//
+//  OSSNetworkingRequestDelegate.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/22.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "OSSConstants.h"
+#import "OSSTask.h"
+
+@class OSSAllRequestNeededMessage;
+@class OSSURLRequestRetryHandler;
+@class OSSHttpResponseParser;
+
+/**
+ The proxy object class for each OSS request.
+ */
+@interface OSSNetworkingRequestDelegate : NSObject
+
+@property (nonatomic, strong) NSMutableArray * interceptors;
+
+@property (nonatomic, strong) NSMutableURLRequest *internalRequest;
+@property (nonatomic, assign) OSSOperationType operType;
+@property (nonatomic, assign) BOOL isAccessViaProxy;
+
+@property (nonatomic, assign) BOOL isRequestCancelled;
+
+@property (nonatomic, strong) OSSAllRequestNeededMessage *allNeededMessage;
+@property (nonatomic, strong) OSSURLRequestRetryHandler *retryHandler;
+@property (nonatomic, strong) OSSHttpResponseParser *responseParser;
+
+@property (nonatomic, strong) NSData * uploadingData;
+@property (nonatomic, strong) NSURL * uploadingFileURL;
+
+@property (nonatomic, assign) int64_t payloadTotalBytesWritten;
+
+@property (nonatomic, assign) BOOL isBackgroundUploadFileTask;
+@property (nonatomic, assign) BOOL isHttpdnsEnable;
+
+
+@property (nonatomic, assign) uint32_t currentRetryCount;
+@property (nonatomic, strong) NSError * error;
+@property (nonatomic, assign) BOOL isHttpRequestNotSuccessResponse;
+@property (nonatomic, strong) NSMutableData *httpRequestNotSuccessResponseBody;
+
+@property (atomic, strong) NSURLSessionDataTask *currentSessionTask;
+
+@property (nonatomic, copy) OSSNetworkingUploadProgressBlock uploadProgress;
+@property (nonatomic, copy) OSSNetworkingDownloadProgressBlock downloadProgress;
+@property (nonatomic, copy) OSSNetworkingRetryBlock retryCallback;
+@property (nonatomic, copy) OSSNetworkingCompletionHandlerBlock completionHandler;
+@property (nonatomic, copy) OSSNetworkingOnRecieveDataBlock onRecieveData;
+
+/**
+ * when put object to server,client caculate crc64 code and assigns it to
+ * this property.
+ */
+@property (nonatomic, copy) NSString *contentCRC;
+
+/** last crc64 code */
+@property (nonatomic, copy) NSString *lastCRC;
+
+/**
+ * determine whether to verify crc64 code
+ */
+@property (nonatomic, assign) BOOL crc64Verifiable;
+
+
+
+- (OSSTask *)buildInternalHttpRequest;
+- (void)reset;
+- (void)cancel;
+
+@end

Example/ios/AliyunOSSiOS.framework/Headers/OSSReachability.h

@@ -0,0 +1,64 @@
+/*
+ Copyright (C) 2016 Apple Inc. All Rights Reserved.
+ See LICENSE.txt for this sample’s licensing information
+ 
+ Abstract:
+ Basic demonstration of how to use the SystemConfiguration Reachablity APIs.
+ */
+
+#import <Foundation/Foundation.h>
+#import <SystemConfiguration/SystemConfiguration.h>
+#import <netinet/in.h>
+
+
+typedef enum : NSInteger {
+	OSSNotReachable = 0,
+	OSSReachableViaWiFi,
+	OSSReachableViaWWAN
+} OSSNetworkStatus;
+
+#pragma mark IPv6 Support
+//Reachability fully support IPv6.  For full details, see ReadMe.md.
+
+
+extern NSString *ossReachabilityChangedNotification;
+
+
+@interface OSSReachability : NSObject
+
+/*!
+ * Use to check the reachability of a given host name.
+ */
++ (instancetype)reachabilityWithHostName:(NSString *)hostName;
+
+/*!
+ * Use to check the reachability of a given IP address.
+ */
++ (instancetype)reachabilityWithAddress:(const struct sockaddr *)hostAddress;
+
+/*!
+ * Checks whether the default route is available. Should be used by applications that do not connect to a particular host.
+ */
++ (instancetype)reachabilityForInternetConnection;
+
+
+#pragma mark reachabilityForLocalWiFi
+//reachabilityForLocalWiFi has been removed from the sample.  See ReadMe.md for more information.
+//+ (instancetype)reachabilityForLocalWiFi;
+
+/*!
+ * Start listening for reachability notifications on the current run loop.
+ */
+- (BOOL)startNotifier;
+- (void)stopNotifier;
+
+- (OSSNetworkStatus)currentReachabilityStatus;
+
+/*!
+ * WWAN may be available, but not active until a connection has been established. WiFi may require a connection for VPN on Demand.
+ */
+- (BOOL)connectionRequired;
+
+@end
+
+

Example/ios/AliyunOSSiOS.framework/Headers/OSSReachabilityManager.h

@@ -0,0 +1,15 @@
+//
+//  OSSReachabilityManager.h
+//
+//  Created by 亿刀 on 14-1-9.
+//  Edited by junmo on 15-5-16
+//  Copyright (c) 2014 Twitter. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+@interface OSSReachabilityManager : NSObject
+
++ (OSSReachabilityManager *)shareInstance;
+
+@end

Example/ios/AliyunOSSiOS.framework/Headers/OSSRequest.h

@@ -0,0 +1,36 @@
+//
+//  OSSRequest.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/22.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "OSSConstants.h"
+
+/**
+ The base class of request to OSS.
+ */
+@interface OSSRequest : NSObject
+/**
+ Flag of requiring authentication. It's per each request.
+ */
+@property (nonatomic, assign) BOOL isAuthenticationRequired;
+
+/**
+ the flag of request canceled.
+ */
+@property (nonatomic, assign) BOOL isCancelled;
+
+/**
+ the flag of verification about crc64
+ */
+@property (nonatomic, assign) OSSRequestCRCFlag crcFlag;
+
+/**
+ Cancels the request
+ */
+- (void)cancel;
+
+@end

Example/ios/AliyunOSSiOS.framework/Headers/OSSResult.h

@@ -0,0 +1,42 @@
+//
+//  OSSResult.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/26.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+/**
+ The base class of result from OSS.
+ */
+@interface OSSResult : NSObject
+
+/**
+ The http response code.
+ */
+@property (nonatomic, assign) NSInteger httpResponseCode;
+
+/**
+ The http headers, in the form of key value dictionary.
+ */
+@property (nonatomic, strong) NSDictionary * httpResponseHeaderFields;
+
+/**
+ The request Id. It's the value of header x-oss-request-id, which is created from OSS server.
+ It's a unique Id represents this request. This is used for troubleshooting when you contact OSS support.
+ */
+@property (nonatomic, strong) NSString * requestId;
+
+/**
+ It's the value of header x-oss-hash-crc64ecma, which is created from OSS server.
+ */
+@property (nonatomic, copy) NSString *remoteCRC64ecma;
+
+/**
+ It's the value of local Data.
+ */
+@property (nonatomic, copy) NSString *localCRC64ecma;
+
+@end

Example/ios/AliyunOSSiOS.framework/Headers/OSSService.h

@@ -11,7 +11,19 @@
 #define OSS_IOS_SDK_VERSION OSSSDKVersion
 
 #import "OSSDefine.h"
+#import "OSSConstants.h"
+
 #import "OSSNetworking.h"
+#import "OSSNetworkingRequestDelegate.h"
+#import "OSSAllRequestNeededMessage.h"
+#import "OSSURLRequestRetryHandler.h"
+#import "OSSHttpResponseParser.h"
+#import "OSSRequest.h"
+#import "OSSGetObjectACLRequest.h"
+#import "OSSGetObjectACLResult.h"
+#import "OSSDeleteMultipleObjectsRequest.h"
+#import "OSSDeleteMultipleObjectsResult.h"
+
 #import "OSSClient.h"
 #import "OSSModel.h"
 #import "OSSUtil.h"

Example/ios/AliyunOSSiOS.framework/Headers/OSSTask.h

@@ -60,7 +60,7 @@ typedef __nullable id(^OSSContinuationBlock)(OSSTask<ResultType> *task);
  Creates a task that is already completed with the given result.
  @param result The result for the task.
  */
-+ (instancetype)taskWithResult:(nullable ResultType)result;
++ (instancetype)taskWithResult:(_Nullable ResultType)result;
 
 /*!
  Creates a task that is already completed with the given error.
@@ -127,7 +127,7 @@ typedef __nullable id(^OSSContinuationBlock)(OSSTask<ResultType> *task);
  If block returns a OSSTask, then the task returned from
  this method will not be completed until that task is completed.
  */
-+ (instancetype)taskFromExecutor:(OSSExecutor *)executor withBlock:(nullable id (^)())block;
++ (instancetype)taskFromExecutor:(OSSExecutor *)executor withBlock:(nullable id (^)(void))block;
 
 // Properties that will be set on the task once it is completed.
 

Example/ios/AliyunOSSiOS.framework/Headers/OSSURLRequestRetryHandler.h

@@ -0,0 +1,36 @@
+//
+//  OSSURLRequestRetryHandler.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/22.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "OSSConstants.h"
+
+@class OSSNetworkingRequestDelegate;
+
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ The retry handler interface
+ */
+@interface OSSURLRequestRetryHandler : NSObject
+
+@property (nonatomic, assign) uint32_t maxRetryCount;
+
+
++ (instancetype)defaultRetryHandler;
+
+- (OSSNetworkingRetryType)shouldRetry:(uint32_t)currentRetryCount
+                      requestDelegate:(OSSNetworkingRequestDelegate *)delegate
+                             response:(NSHTTPURLResponse *)response
+                                error:(NSError *)error;
+
+- (NSTimeInterval)timeIntervalForRetry:(uint32_t)currentRetryCount
+                             retryType:(OSSNetworkingRetryType)retryType;
+@end
+
+NS_ASSUME_NONNULL_END

Example/ios/AliyunOSSiOS.framework/Headers/OSSUtil.h

@@ -7,6 +7,7 @@
 //
 
 #import <Foundation/Foundation.h>
+#import "OSSFileLogger.h"
 
 @class OSSFederationToken;
 
@@ -16,22 +17,55 @@
 + (NSString *)calBase64WithData:(uint8_t *)data;
 + (NSString *)encodeURL:(NSString *)url;
 + (NSData *)constructHttpBodyFromPartInfos:(NSArray *)partInfos;
-+ (NSData *)constructHttpBodyForCreateBucketWithLocation:(NSString *)location;
++ (NSData *)constructHttpBodyForDeleteMultipleObjects:(NSArray<NSString *> *)keys quiet:(BOOL)quiet;
++ (NSData *)constructHttpBodyForCreateBucketWithLocation:(NSString *)location __attribute__((deprecated("deprecated!")));
 + (BOOL)validateBucketName:(NSString *)bucketName;
 + (BOOL)validateObjectKey:(NSString *)objectKey;
 + (BOOL)isOssOriginBucketHost:(NSString *)host;
 + (NSString *)getIpByHost:(NSString *)host;
 + (BOOL)isNetworkDelegateState;
+
++ (NSData *)fileMD5:(NSString *)path;
 + (NSString *)dataMD5String:(NSData *)data;
 + (NSString *)fileMD5String:(NSString *)path;
-+ (NSString*)base64ForData:(uint8_t *)input length:(int32_t)length;
 + (NSString *)base64Md5ForData:(NSData *)data;
 + (NSString *)base64Md5ForFilePath:(NSString *)filePath;
 + (NSString *)base64Md5ForFileURL:(NSURL *)fileURL;
++ (NSString *)base64ForData:(uint8_t *)input length:(int32_t)length;
+
 + (NSString *)populateSubresourceStringFromParameter:(NSDictionary *)parameters;
 + (NSString *)populateQueryStringFromParameter:(NSDictionary *)parameters;
 + (BOOL)isSubresource:(NSString *)param;
 + (NSString *)sign:(NSString *)content withToken:(OSSFederationToken *)token;
 + (NSString *)getRelativePath:(NSString *)fullPath;
 + (NSString *)detemineMimeTypeForFilePath:(NSString *)filePath uploadName:(NSString *)uploadName;
++ (BOOL)hasPhoneFreeSpace;
++ (NSString*)buildNetWorkConnectedMsg;
++ (NSString*)buildOperatorMsg;
+
++ (uint64_t)crc64ecma:(uint64_t)crc1 buffer:(void *)buffer length:(size_t)len;
+
+/**
+ * @brief: combine crc1 and crc2
+ */
+
++ (uint64_t)crc64ForCombineCRC1:(uint64_t)crc1 CRC2:(uint64_t)crc2 length:(size_t)len2;
+
++ (NSString *)sha1WithString:(NSString *)string;
++ (NSString *)sha1WithData:(NSData *)data;
++ (NSString *)sha1WithFilePath:(NSString *)filePath;
+
++ (NSData *)constructHttpBodyForTriggerCallback:(NSString *)callbackParams callbackVaribles:(NSString *)callbackVaribles;
+
++ (NSData *)constructHttpBodyForImagePersist:(NSString *)action toBucket:(NSString *)toBucket toObjectKey:(NSString *)toObjectKey;
+
+@end
+
+@interface NSString (OSS)
+
+- (NSString *)oss_trim;
+- (BOOL)oss_isNotEmpty;
+- (NSString *)oss_stringByAppendingPathComponentForURL:(NSString *)path;
++ (NSString *)oss_documentDirectory;
+
 @end

Example/ios/AliyunOSSiOS.framework/Headers/OSSXMLDictionary.h

@@ -0,0 +1,88 @@
+//
+//  XMLDictionary.h
+//
+//  Version 1.4
+//
+//  Created by Nick Lockwood on 15/11/2010.
+//  Copyright 2010 Charcoal Design. All rights reserved.
+//
+//  Get the latest version of XMLDictionary from here:
+//
+//  https://github.com/nicklockwood/XMLDictionary
+//
+//  This software is provided 'as-is', without any express or implied
+//  warranty.  In no event will the authors be held liable for any damages
+//  arising from the use of this software.
+//
+//  Permission is granted to anyone to use this software for any purpose,
+//  including commercial applications, and to alter it and redistribute it
+//  freely, subject to the following restrictions:
+//
+//  1. The origin of this software must not be misrepresented; you must not
+//  claim that you wrote the original software. If you use this software
+//  in a product, an acknowledgment in the product documentation would be
+//  appreciated but is not required.
+//
+//  2. Altered source versions must be plainly marked as such, and must not be
+//  misrepresented as being the original software.
+//
+//  3. This notice may not be removed or altered from any source distribution.
+//
+
+#import <Foundation/Foundation.h>
+#import "OSSConstants.h"
+
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wobjc-missing-property-synthesis"
+@interface OSSXMLDictionaryParser : NSObject <NSCopying>
+
++ (OSSXMLDictionaryParser *)sharedInstance;
+
+@property (nonatomic, assign) BOOL collapseTextNodes; // defaults to YES
+@property (nonatomic, assign) BOOL stripEmptyNodes;   // defaults to YES
+@property (nonatomic, assign) BOOL trimWhiteSpace;    // defaults to YES
+@property (nonatomic, assign) BOOL alwaysUseArrays;   // defaults to NO
+@property (nonatomic, assign) BOOL preserveComments;  // defaults to NO
+@property (nonatomic, assign) BOOL wrapRootNode;      // defaults to NO
+
+@property (nonatomic, assign) OSSXMLDictionaryAttributesMode attributesMode;
+@property (nonatomic, assign) OSSXMLDictionaryNodeNameMode nodeNameMode;
+
+- (NSDictionary *)dictionaryWithParser:(NSXMLParser *)parser;
+- (NSDictionary *)dictionaryWithData:(NSData *)data;
+- (NSDictionary *)dictionaryWithString:(NSString *)string;
+- (NSDictionary *)dictionaryWithFile:(NSString *)path;
+
+@end
+
+
+@interface NSDictionary (OSSXMLDictionary)
+
++ (NSDictionary *)oss_dictionaryWithXMLParser:(NSXMLParser *)parser;
++ (NSDictionary *)oss_dictionaryWithXMLData:(NSData *)data;
++ (NSDictionary *)oss_dictionaryWithXMLString:(NSString *)string;
++ (NSDictionary *)oss_dictionaryWithXMLFile:(NSString *)path;
+
+- (NSDictionary *)oss_attributes;
+- (NSDictionary *)oss_childNodes;
+- (NSArray *)oss_comments;
+- (NSString *)oss_nodeName;
+- (NSString *)oss_innerText;
+- (NSString *)oss_innerXML;
+- (NSString *)oss_XMLString;
+
+- (NSArray *)oss_arrayValueForKeyPath:(NSString *)keyPath;
+- (NSString *)oss_stringValueForKeyPath:(NSString *)keyPath;
+- (NSDictionary *)oss_dictionaryValueForKeyPath:(NSString *)keyPath;
+
+@end
+
+
+@interface NSString (OSSXMLDictionary)
+
+- (NSString *)oss_XMLEncodedString;
+
+@end
+
+
+#pragma GCC diagnostic pop

Example/ios/AliyunOSSiOS.framework/PrivateHeaders/aos_crc64.h

@@ -0,0 +1,11 @@
+#ifndef LIBAOS_CRC_H
+#define LIBAOS_CRC_H
+
+#include <_types/_uintmax_t.h>
+#include <_types/_uint64_t.h>
+#include <stddef.h>
+
+uint64_t aos_crc64(uint64_t crc, void *buf, size_t len);
+uint64_t aos_crc64_combine(uint64_t crc1, uint64_t crc2, uintmax_t len2);
+
+#endif

Example/package.json

@@ -9,7 +9,7 @@
   "dependencies": {
     "react": "16.3.1",
     "react-native": "0.55.4",
-    "aliyun-oss-react-native": "^1.0.0-alpha.3",
+    "aliyun-oss-react-native": "^1.0.0-alpha.4",
     "react-native-image-picker": "^0.26.10"
   },
   "devDependencies": {

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/AliyunOSSiOS.h

@@ -6,7 +6,7 @@
 //  Copyright © 2016 xuyecan. All rights reserved.
 //
 
-#import <UIKit/UIKit.h>
+#import <Foundation/Foundation.h>
 
 //! Project version number for AliyunOSSiOS.
 FOUNDATION_EXPORT double AliyunOSSiOSVersionNumber;
@@ -18,3 +18,4 @@ FOUNDATION_EXPORT const unsigned char AliyunOSSiOSVersionString[];
 
 #import "OSSService.h"
 #import "OSSCompat.h"
+#import "OSSXMLDictionary.h"

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/NSMutableData+OSS_CRC.h

@@ -0,0 +1,15 @@
+//
+//  NSMutableData+OSS_CRC.h
+//  AliyunOSSSDK
+//
+//  Created by 怀叙 on 2017/11/29.
+//  Copyright © 2017年 阿里云. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+@interface NSMutableData (OSS_CRC)
+
+- (uint64_t)oss_crc64;
+
+@end

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSAllRequestNeededMessage.h

@@ -0,0 +1,56 @@
+//
+//  OSSAllRequestNeededMessage.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/22.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "OSSConstants.h"
+#import "OSSTask.h"
+
+/**
+ All necessary information in one OSS request.
+ */
+@interface OSSAllRequestNeededMessage : NSObject
+@property (nonatomic, strong) NSString * endpoint;
+@property (nonatomic, strong) NSString * httpMethod;
+@property (nonatomic, strong) NSString * bucketName;
+@property (nonatomic, strong) NSString * objectKey;
+@property (nonatomic, strong) NSString * contentType;
+@property (nonatomic, strong) NSString * contentMd5;
+@property (nonatomic, strong) NSString * range;
+@property (nonatomic, strong) NSString * date;
+@property (nonatomic, strong) NSMutableDictionary * headerParams;
+@property (nonatomic, copy) NSDictionary * querys;
+@property (nonatomic, copy) NSString *contentSHA1;
+
+@property (nonatomic, assign) BOOL isHostInCnameExcludeList;
+
+- (instancetype)initWithEndpoint:(NSString *)endpoint
+                      httpMethod:(NSString *)httpMethod
+                      bucketName:(NSString *)bucketName
+                       objectKey:(NSString *)objectKey
+                            type:(NSString *)contentType
+                             md5:(NSString *)contentMd5
+                           range:(NSString *)range
+                            date:(NSString *)date
+                    headerParams:(NSMutableDictionary *)headerParams
+                          querys:(NSMutableDictionary *)querys __attribute__((deprecated("Use -initWithEndpoint:httpMethod:bucketName:objectKey:type:md5:range:date:headerParams:querys:sha1: instead")));
+
+- (instancetype)initWithEndpoint:(NSString *)endpoint
+                      httpMethod:(NSString *)httpMethod
+                      bucketName:(NSString *)bucketName
+                       objectKey:(NSString *)objectKey
+                            type:(NSString *)contentType
+                             md5:(NSString *)contentMd5
+                           range:(NSString *)range
+                            date:(NSString *)date
+                    headerParams:(NSMutableDictionary *)headerParams
+                          querys:(NSMutableDictionary *)querys
+                            sha1:(NSString *)contentSHA1;
+
+- (OSSTask *)validateRequestParamsInOperationType:(OSSOperationType)operType;
+
+@end

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSCancellationToken.h

@@ -17,7 +17,7 @@ NS_ASSUME_NONNULL_BEGIN
 /*!
  A block that will be called when a token is cancelled.
  */
-typedef void(^OSSCancellationBlock)();
+typedef void(^OSSCancellationBlock)(void);
 
 /*!
  The consumer view of a CancellationToken.

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSClient.h

@@ -14,19 +14,25 @@
 @class OSSGetBucketRequest;
 @class OSSGetBucketACLRequest;
 @class OSSGetObjectRequest;
+@class OSSGetObjectACLRequest;
 @class OSSPutObjectRequest;
 @class OSSPutObjectACLRequest;
 @class OSSDeleteObjectRequest;
+@class OSSDeleteMultipleObjectsRequest;
 @class OSSCopyObjectRequest;
 @class OSSInitMultipartUploadRequest;
 @class OSSUploadPartRequest;
 @class OSSCompleteMultipartUploadRequest;
 @class OSSListPartsRequest;
+@class OSSListMultipartUploadsRequest;
 @class OSSAbortMultipartUploadRequest;
 @class OSSAppendObjectRequest;
 @class OSSResumableUploadRequest;
+@class OSSMultipartUploadRequest;
 @class OSSTask;
 @class OSSExecutor;
+@class OSSCallBackRequest;
+@class OSSImagePersistRequest;
 
 @class OSSNetworking;
 @class OSSClientConfiguration;
@@ -35,49 +41,51 @@
 NS_ASSUME_NONNULL_BEGIN
 
 /**
- OSSClient是OSS服务的iOS客户端，它为调用者提供了一系列的方法，用于和OSS服务进行交互。
- 一般来说，全局内只需要保持一个OSSClient，用来调用各种操作。
+ OSSClient is the entry class to access OSS in an iOS client. It provides all the methods to communicate with OSS.
+ Generally speaking, only one instance of OSSClient is needed in the whole app.
  */
 @interface OSSClient : NSObject
 
 /**
- OSS访问域名
+ OSS endpoint. It varies in different regions. Please check out OSS official website for the exact endpoints for your data.
  */
 @property (nonatomic, strong) NSString * endpoint;
 
 /**
- 用以收发网络请求
+ The networking instance for sending and receiving data
  */
 @property (nonatomic, strong) OSSNetworking * networking;
 
 /**
- 提供访问所需凭证
+ The credential provider instance
  */
 @property (nonatomic, strong) id<OSSCredentialProvider> credentialProvider;
 
 /**
- 客户端设置
+ Client configuration instance
  */
 @property (nonatomic, strong) OSSClientConfiguration * clientConfiguration;
 
 /**
- 任务队列
+ oss operation task queue
  */
 @property (nonatomic, strong, readonly) OSSExecutor * ossOperationExecutor;
 
 /**
- 初始化OSSClient，使用默认的本地设置
- @endpoint 指明Bucket所在的Region域名，2017年以后苹果要求APP符合ATS政策，这里要写https的endpoint，如 "https://oss-cn-hangzhou.aliyuncs.com"
- @credentialProvider 需要实现的签名器
+ Initializes an OSSClient instance with the default client configuration.
+ @endpoint it specifies domain of the bucket's region. Starting 2017, the domain must be prefixed with "https://" to follow Apple's ATS policy.
+             For example: "https://oss-cn-hangzhou.aliyuncs.com"
+ @credentialProvider The credential provider
  */
 - (instancetype)initWithEndpoint:(NSString *)endpoint
               credentialProvider:(id<OSSCredentialProvider>) credentialProvider;
 
 /**
- 初始化OSSClient，使用自定义设置
- @endpoint 指明Bucket所在的Region域名，2017年以后苹果要求APP符合ATS政策，这里要写https的endpoint，如 "https://oss-cn-hangzhou.aliyuncs.com"
- @credentialProvider 需要实现的签名器
- @conf 可以设置一些本地参数如重试次数、超时时间等
+ Initializes an OSSClient with the custom client configuration.
+ @endpoint it specifies domain of the bucket's region. Starting 2017, the domain must be prefixed with "https://" to follow Apple's ATS policy.
+             For example: "https://oss-cn-hangzhou.aliyuncs.com"
+ @credentialProvider The credential provider
+ @conf The custom client configuration such as retry time, timeout values, etc.
  */
 - (instancetype)initWithEndpoint:(NSString *)endpoint
               credentialProvider:(id<OSSCredentialProvider>)credentialProvider
@@ -86,188 +94,257 @@ NS_ASSUME_NONNULL_BEGIN
 #pragma mark restful-api
 
 /**
- 对应RESTFul API：GetService
- 获取请求者当前拥有的全部Bucket。
- 注意：
- 1. 尚不支持STS;
- 2. 当所有的bucket都返回时，返回的xml中不包含Prefix、Marker、MaxKeys、IsTruncated、NextMarker节点，如果还有部分结果未返回，则增加上述节点，其中NextMarker用于继续查询时给marker赋值。
+ The corresponding RESTFul API: GetService
+ Gets all the buckets of the current user
+ Notes：
+ 1. STS is not supported yet in this call.
+ 2. When all buckets are returned, the xml in response body does not have nodes of Prefix, Marker, MaxKeys, IsTruncated and NextMarker.
+    If there're remaining buckets to return, the xml will have these nodes. The nextMarker is the value of marker in the next call.
  */
 - (OSSTask *)getService:(OSSGetServiceRequest *)request;
 
 /**
- 对应RESTFul API：PutBucket
- 用于创建Bucket（不支持匿名访问）。默认情况下，创建的Bucket位于默认的数据中心：oss-cn-hangzhou。
- 用户可以显式指定Bucket位于的数据中心，从而最优化延迟，最小化费用或者满足监管要求等。
- 注意：
- 1. 尚不支持STS。
+ The corresponding RESTFul API: PutBucket
+ Creates a bucket--it does not support anonymous access. By default, the datacenter used is oss-cn-hangzhou.
+ Callers could explicitly specify the datacenter for the bucket to optimize the performance and cost or meet the regulation requirement.
+ Notes:
+ 1. STS is not supported yet.
  */
 - (OSSTask *)createBucket:(OSSCreateBucketRequest *)request;
 
 /**
- 对应RESTFul API：DeleteBucket
- 用于删除某个Bucket。
+ The corresponding RESTFul API: DeleteBucket
+ Deletes a bucket.
  */
 - (OSSTask *)deleteBucket:(OSSDeleteBucketRequest *)request;
 
 /**
- 对应RESTFul API：GetBucket
- 用来list Bucket中所有Object的信息，可以通过prefix，marker，delimiter和max-keys对list做限定，返回部分结果。
+The corresponding RESTFul API: GetBucket
+ Lists all objects in a bucket. It could be specified with filters such as prefix, marker, delimeter and max-keys.
  */
 - (OSSTask *)getBucket:(OSSGetBucketRequest *)request;
 
 /**
- 对应RESTFul API：GetBucketACL
- 用来获取某个Bucket的访问权限。
+The corresponding RESTFul API: GetBucketACL
+ Gets the bucket ACL.
  */
 - (OSSTask *)getBucketACL:(OSSGetBucketACLRequest *)request;
 
 /**
- 对应RESTFul API：HeadObject
- 只返回某个Object的meta信息，不返回文件内容。
+The corresponding RESTFul API: HeadObject
+ Gets the object's metadata information. The object's content is not returned.
  */
 - (OSSTask *)headObject:(OSSHeadObjectRequest *)request;
 
 /**
- 对应RESTFul API：GetObject
- 用于获取某个Object，此操作要求用户对该Object有读权限。
+The corresponding RESTFul API: GetObject
+ Gets the whole object (includes content). It requires caller have read permission on the object.
  */
 - (OSSTask *)getObject:(OSSGetObjectRequest *)request;
 
 /**
- 对应RESTFul API：PutObject
- 用于上传文件。
+ * Gets the Access Control List (ACL) of the OSS object.
+ *
+ * @param bucketName
+ *            Bucket name.
+ * @param key
+ *            Object Key.
+ * @return The OSSTask with result of objectAcls instance of the object.
+ */
+- (OSSTask *)getObjectACL:(OSSGetObjectACLRequest *)request;
+
+/**
+The corresponding RESTFul API: PutObject
+ Uploads a file.
  */
 - (OSSTask *)putObject:(OSSPutObjectRequest *)request;
 
 /**
- Put Object ACL接口用于修改Object的访问权限。目前Object有三种访问权限：private, public-read, public-read-write。
- Put Object ACL操作通过Put请求中的“x-oss-object-acl”头来设置，这个操作只有Bucket Owner有权限执行。如果操作成功，则返回200；否则返回相应的错误码和提示信息。
+ Sets the object's ACL. Right now an object has three access permissions: private, public-ready, public-read-write.
+ The operation specifies the x-oss-object-acl header in the put request. The caller must be the owner of the object.
+ If succeeds, it returns HTTP status 200; otherwise it returns related error code and error messages.
  */
 - (OSSTask *)putObjectACL:(OSSPutObjectACLRequest *)request;
 
 /**
- 对应RESTFul API：AppendObject
- 以追加写的方式上传文件。通过Append Object操作创建的Object类型为Appendable Object，而通过Put Object上传的Object是Normal Object。
+The corresponding RESTFul API: AppendObject
+ Appends data to an existing or non-existing object. The object created by this operation is appendable. 
+ As a comparison, the object created by Put Object is normal (non-appendable).
  */
 - (OSSTask *)appendObject:(OSSAppendObjectRequest *)request;
 
 /**
- 对应RESTFul API：copyObject
- 拷贝一个在OSS上已经存在的object成另外一个object，可以发送一个PUT请求给OSS，并在PUT请求头中添加元素“x-oss-copy-source”来指定拷贝源。
- OSS会自动判断出这是一个Copy操作，并直接在服务器端执行该操作。如果拷贝成功，则返回新的object信息给用户。
- 该操作适用于拷贝小于1GB的文件。
+ @brief : Appends data to an existing or non-existing object on the OSS server. The object created by this operation is appendable.
+ request    : request
+ crc64ecma  : 如果服务器上面已经存在对象,需要客户端先调用headObject获取到对象的crc64ecma,然后再调用
+              该接口上传数据
+ */
+- (OSSTask *)appendObject:(OSSAppendObjectRequest *)request withCrc64ecma:(nullable NSString *)crc64ecma;
+
+/**
+The corresponding RESTFul API: copyObject
+ Copies an existing object to another one.The operation sends a PUT request with x-oss-copy-source header to specify the source object.
+ OSS server side will detect and copy the object. If it succeeds, the new object's metadata information will be returned.
+ The operation applies for files less than 1GB. For big files, use UploadPartCopy RESTFul API.
  */
 - (OSSTask *)copyObject:(OSSCopyObjectRequest *)request;
 
 /**
- 对应RESTFul API：DeleteObject
- 用于删除某个Object。
+ * Batch deletes the specified files under a specific bucket. If the files
+ * are non-exist, the operation will still return successful.
+ *
+ * @param deleteObjectsRequest
+ *            A OSSDeleteMultipleObjectsRequest instance which specifies the
+ *            bucket and file keys to delete.
+ * @return A OSSTask with result of OSSDeleteMultipleObjectsResult instance which specifies each
+ *         file's result in normal mode or only failed deletions in quite
+ *         mode. By default it's quite mode.
+ */
+- (OSSTask *)deleteMultipleObjects:(OSSDeleteMultipleObjectsRequest *)request;
+
+/**
+ The corresponding RESTFul API: DeleteObject
+ Deletes an object
  */
 - (OSSTask *)deleteObject:(OSSDeleteObjectRequest *)request;
 
 /**
- 对应RESTFul API：InitiateMultipartUpload
- 使用Multipart Upload模式传输数据前，必须先调用该接口来通知OSS初始化一个Multipart Upload事件。该接口会返回一个OSS服务器创建的全局唯一的Upload ID，用于标识本次Multipart Upload事件。
- 用户可以根据这个ID来发起相关的操作，如中止Multipart Upload、查询Multipart Upload等。
+The corresponding RESTFul API: InitiateMultipartUpload
+ Initiates a multipart upload to get a upload Id. It's needed before starting uploading parts data. 
+ The upload Id is used for subsequential operations such as aborting the upload, querying the uploaded parts, etc.
  */
 - (OSSTask *)multipartUploadInit:(OSSInitMultipartUploadRequest *)request;
 
 /**
- 对应RESTFul API：UploadPart
- 初始化一个Multipart Upload之后，可以根据指定的Object名和Upload ID来分块（Part）上传数据。
- 每一个上传的Part都有一个标识它的号码（part number，范围是1~10,000）。
- 对于同一个Upload ID，该号码不但唯一标识这一块数据，也标识了这块数据在整个文件内的相对位置。
- 如果你用同一个part号码，上传了新的数据，那么OSS上已有的这个号码的Part数据将被覆盖。除了最后一块Part以外，其他的part最小为100KB；
- 最后一块Part没有大小限制。
+The corresponding RESTFul API: UploadPart
+ After the multipart upload is initiated, this API could be called to upload the data to the target file with the upload Id.
+ Every uploaded part has a unique id called part number, which ranges from 1 to 10,000. 
+ For a given upload Id, the part number identifies the specific range of the data in the whole file. 
+ If the same part number is used for another upload, the existing data will be overwritten by the new upload. 
+ Except the last part, all other part's minimal size is 100KB.
+ But no minimal size requirement on the last part.
  */
 - (OSSTask *)uploadPart:(OSSUploadPartRequest *)request;
 
 /**
- 对应RESTFul API：CompleteMultipartUpload
- 在将所有数据Part都上传完成后，必须调用Complete Multipart Upload API来完成整个文件的Multipart Upload。
- 在执行该操作时，用户必须提供所有有效的数据Part的列表（包括part号码和ETAG）；OSS收到用户提交的Part列表后，会逐一验证每个数据Part的有效性。
- 当所有的数据Part验证通过后，OSS将把这些数据part组合成一个完整的Object。
+The corresponding RESTFul API: CompleteMultipartUpload
+ This API is to complete the multipart upload after all parts data have been uploaded.
+ It must be provided with a valid part list (each part has the part number and ETag). 
+ OSS will validate every part and then complete the multipart upload.
+ If any part is invalid (e.g. the part is updated by another part upload), this API will fail.
  */
 - (OSSTask *)completeMultipartUpload:(OSSCompleteMultipartUploadRequest *)request;
 
 /**
- 对应RESTFul API：ListParts
- 可以罗列出指定Upload ID所属的所有已经上传成功Part。
+The corresponding RESTFul API: ListParts
+ Lists all uploaded parts of the specified upload id.
  */
 - (OSSTask *)listParts:(OSSListPartsRequest *)request;
 
 /**
- 对应RESTFul API：AbortMultipartUpload
- 该接口可以根据用户提供的Upload ID中止其对应的Multipart Upload事件。
- 当一个Multipart Upload事件被中止后，就不能再使用这个Upload ID做任何操作，已经上传的Part数据也会被删除。
+ The corresponding RESTFul API: ListMultipartUploads
+ Lists all multipart uploads with the specified bucket.
+ */
+- (OSSTask *)listMultipartUploads:(OSSListMultipartUploadsRequest *)request;
+
+/**
+The corresponding RESTFul API: AbortMultipartUpload
+Aborts the multipart upload by the specified upload Id.
+ Once the multipart upload is aborted by this API, all parts data will be deleted and the upload Id is invalid anymore.
  */
 - (OSSTask *)abortMultipartUpload:(OSSAbortMultipartUploadRequest *)request;
 
+- (OSSTask *)abortResumableMultipartUpload:(OSSResumableUploadRequest *)request;
+
+- (OSSTask *)triggerCallBack:(OSSCallBackRequest *)request;
+
+
 #pragma mark extention method
 
 /**
- 对一个Object签名出一个URL，可以把该URL转给第三方实现授权访问。
- @bucketName Object所在的Bucket名称
- @objectKey Object名称
- @interval 签名URL时，可以指定这个URL的有效时长是多久，单位是秒，比如说需要有效时长为1小时的URL，这里传入3600
+ Generates a signed URL for the object and anyone has this URL will get the GET permission on the object.
+ @bucketName object's bucket name
+ @objectKey Object name
+ @interval Expiration time in seconds. The URL could be specified with the expiration time to limit the access window on the object.
  */
 - (OSSTask *)presignConstrainURLWithBucketName:(NSString *)bucketName
                                 withObjectKey:(NSString *)objectKey
                        withExpirationInterval:(NSTimeInterval)interval;
 
 /**
- 对一个Object签名出一个URL，可以把该URL转给第三方实现授权访问。
- @bucketName Object所在的Bucket名称
- @objectKey Object名称
- @interval 签名URL时，可以指定这个URL的有效时长是多久，单位是秒，比如说需要有效时长为1小时的URL，这里传入3600
- @parameter 参数
+ Generates a signed URL for the object and anyone has this URL will get the specified permission on the object.
+ @bucketName object's bucket name
+ @objectKey Object name
+ @interval Expiration time in seconds. The URL could be specified with the expiration time to limit the access window on the object.
+ @parameter it could specify allowed HTTP methods 
  */
 - (OSSTask *)presignConstrainURLWithBucketName:(NSString *)bucketName
                                  withObjectKey:(NSString *)objectKey
                         withExpirationInterval:(NSTimeInterval)interval
                                 withParameters:(NSDictionary *)parameters;
 
-/**
- 如果Object的权限是公共读或者公共读写，调用这个接口对该Object签名出一个URL，可以把该URL转给第三方实现授权访问。
- @bucketName Object所在的Bucket名称
- @objectKey Object名称
+/** TODOTODO
+ If the object's ACL is public read or public read-write, use this API to generate a signed url for sharing.
+ @bucketName Object's bucket name
+ @objectKey Object name
  */
 - (OSSTask *)presignPublicURLWithBucketName:(NSString *)bucketName
                             withObjectKey:(NSString *)objectKey;
 
-/**
- 如果Object的权限是公共读或者公共读写，调用这个接口对该Object签名出一个URL，可以把该URL转给第三方实现授权访问。
- @bucketName Object所在的Bucket名称
- @objectKey Object名称
- @parameter 参数
+/** TODOTODO
+ If the object's ACL is public read or public read-write, use this API to generate a signed url for sharing.
+ @bucketName Object's bucket name
+ @objectKey Object name
+ @parameter the request parameters.
  */
 - (OSSTask *)presignPublicURLWithBucketName:(NSString *)bucketName
                              withObjectKey:(NSString *)objectKey
                              withParameters:(NSDictionary *)parameters;
 
 /**
- 断点上传接口
- 这个接口封装了分块上传的若干接口以实现断点上传，但是需要用户自行保存UploadId。
- 对一个新文件，用户需要首先调用multipartUploadInit接口获得一个UploadId，然后调用此接口上传这个文件。
- 如果上传失败，首先需要检查一下失败原因：
-     如果非不可恢复的失败，那么可以用同一个UploadId和同一文件继续调用这个接口续传
-     否则，需要重新获取UploadId，重新上传这个文件。
- 详细参考demo。
+ TODOTODO
+ Multipart upload API
+ */
+- (OSSTask *)multipartUpload:(OSSMultipartUploadRequest *)request;
+/**
+ TODOTODO
+ Resumable upload API
+ This API wraps the multipart upload and also enables resuming upload by reading/writing  the checkpoint data.
+ For a new file, multipartUploadInit() needs to be called first to get the upload Id. Then use this upload id to call this API to upload the data.
+ If the upload fails, checks the error messages:
+     If it's a recoverable error, then call this API again with the same upload Id to retry. The uploaded data will not be uploaded again.
+     Otherwise then you may need to recreates a new upload Id and call this method again.
+ Check out demo for the detail.
  */
 - (OSSTask *)resumableUpload:(OSSResumableUploadRequest *)request;
 
 /**
- 查看某个Object是否存在
- @bucketName Object所在的Bucket名称
- @objectKey Object名称
+ Checks if the object exists
+ @bucketName Object's bucket name
+ @objectKey Object name
  
- return YES                     Object存在
- return NO && *error = nil      Object不存在
- return NO && *error != nil     发生错误
+ return YES                     Object exists
+ return NO && *error = nil      Object does not exist
+ return NO && *error != nil     Error occured.
  */
 - (BOOL)doesObjectExistInBucket:(NSString *)bucketName
                       objectKey:(NSString *)objectKey
                           error:(const NSError **)error;
+
+/**
+ * multipart upload sequentially in order,support resume upload
+ */
+- (OSSTask *)sequentialMultipartUpload:(OSSResumableUploadRequest *)request;
+
+/*
+ * image persist action
+ * https://help.aliyun.com/document_detail/55811.html
+ */
+- (OSSTask *)imageActionPersist:(OSSImagePersistRequest *)request;
+
 @end
 
+
+
+
 NS_ASSUME_NONNULL_END

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSCocoaLumberjack.h

@@ -0,0 +1,75 @@
+// Software License Agreement (BSD License)
+//
+// Copyright (c) 2010-2016, Deusty, LLC
+// All rights reserved.
+//
+// Redistribution and use of this software in source and binary forms,
+// with or without modification, are permitted provided that the following conditions are met:
+//
+// * Redistributions of source code must retain the above copyright notice,
+//   this list of conditions and the following disclaimer.
+//
+// * Neither the name of Deusty nor the names of its contributors may be used
+//   to endorse or promote products derived from this software without specific
+//   prior written permission of Deusty, LLC.
+
+/**
+ * Welcome to CocoaLumberjack!
+ *
+ * The project page has a wealth of documentation if you have any questions.
+ *
+ * If you're new to the project you may wish to read "Getting Started" at:
+ * Documentation/GettingStarted.md
+ *
+ * Otherwise, here is a quick refresher.
+ * There are three steps to using the macros:
+ *
+ * Step 1:
+ * Import the header in your implementation or prefix file:
+ *
+ * #import <CocoaLumberjack/CocoaLumberjack.h>
+ *
+ * Step 2:
+ * Define your logging level in your implementation file:
+ *
+ * // Log levels: off, error, warn, info, verbose
+ * static const DDLogLevel ddLogLevel = DDLogLevelVerbose;
+ *
+ * Step 2 [3rd party frameworks]:
+ *
+ * Define your LOG_LEVEL_DEF to a different variable/function than ddLogLevel:
+ *
+ * // #undef LOG_LEVEL_DEF // Undefine first only if needed
+ * #define LOG_LEVEL_DEF myLibLogLevel
+ *
+ * Define your logging level in your implementation file:
+ *
+ * // Log levels: off, error, warn, info, verbose
+ * static const DDLogLevel myLibLogLevel = DDLogLevelVerbose;
+ *
+ * Step 3:
+ * Replace your NSLog statements with DDLog statements according to the severity of the message.
+ *
+ * NSLog(@"Fatal error, no dohickey found!"); -> OSSLogError(@"Fatal error, no dohickey found!");
+ *
+ * DDLog works exactly the same as NSLog.
+ * This means you can pass it multiple variables just like NSLog.
+ **/
+
+#import <Foundation/Foundation.h>
+
+// Disable legacy macros
+#ifndef OSSDD_LEGACY_MACROS
+    #define OSSDD_LEGACY_MACROS 0
+#endif
+
+// Core
+#import "OSSDDLog.h"
+
+// Main macros
+#import "OSSLogMacros.h"
+
+// Loggers
+#import "OSSFileLogger.h"
+#import "OSSNSLogger.h"
+

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSCompat.h

@@ -13,11 +13,13 @@
 
 typedef OSSCancellationTokenSource OSSTaskHandler;
 
+NS_ASSUME_NONNULL_BEGIN
+
 @interface OSSClient (Compat)
 
 /**
- 兼容老版本用法的上传数据接口
- 建议更换使用：putObject
+ The old version's upload API.
+ Please use putObject instead.
  */
 - (OSSTaskHandler *)uploadData:(NSData *)data
                withContentType:(NSString *)contentType
@@ -28,8 +30,8 @@ typedef OSSCancellationTokenSource OSSTaskHandler;
                     onProgress:(void(^)(float progress))onProgress;
 
 /**
- 兼容老版本用法的下载数据接口
- 建议更换使用：getObject
+ The old version's download API.
+ Please use getObject instead.
  */
 - (OSSTaskHandler *)downloadToDataFromBucket:(NSString *)bucketName
                    objectKey:(NSString *)objectKey
@@ -37,8 +39,8 @@ typedef OSSCancellationTokenSource OSSTaskHandler;
                   onProgress:(void(^)(float progress))onProgress;
 
 /**
- 兼容老版本用法的上传文件接口
- 建议更换使用：putObject
+ The old version's upload API.
+ Please use putObject instead.
  */
 - (OSSTaskHandler *)uploadFile:(NSString *)filePath
                 withContentType:(NSString *)contentType
@@ -49,8 +51,8 @@ typedef OSSCancellationTokenSource OSSTaskHandler;
                      onProgress:(void(^)(float progress))onProgress;
 
 /**
- 兼容老版本用法的下载文件接口
- 建议更换使用：getObject
+ The old version's download API.
+ Please use getObject instead.
  */
 - (OSSTaskHandler *)downloadToFileFromBucket:(NSString *)bucketName
                   objectKey:(NSString *)objectKey
@@ -60,8 +62,8 @@ typedef OSSCancellationTokenSource OSSTaskHandler;
 
 
 /**
- 兼容老版本用法的断点上传文件接口
- 建议更换使用：resumableUpload
+ The old version's upload API with resumable upload support.
+ Please use resumableUpload instead.
  */
 - (OSSTaskHandler *)resumableUploadFile:(NSString *)filePath
           withContentType:(NSString *)contentType
@@ -72,10 +74,12 @@ typedef OSSCancellationTokenSource OSSTaskHandler;
                onProgress:(void(^)(float progress))onProgress;
 
 /**
- 兼容老版本用法的删除Object接口
- 建议更换使用：deleteObject
+ The old version's delete API.
+ Please use deleteObject instead.
  */
 - (void)deleteObjectInBucket:(NSString *)bucketName
                    objectKey:(NSString *)objectKey
                  onCompleted:(void(^)(BOOL, NSError *))onCompleted;
-@end
+@end
+
+NS_ASSUME_NONNULL_END

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSConstants.h

@@ -0,0 +1,111 @@
+//
+//  OSSConstants.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/22.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+typedef NSString* _Nullable (^OSSCustomSignContentBlock) (NSString * contentToSign, NSError **error);
+typedef NSData * _Nullable (^OSSResponseDecoderBlock) (NSData * data);
+
+typedef void (^OSSNetworkingUploadProgressBlock) (int64_t bytesSent, int64_t totalBytesSent, int64_t totalBytesExpectedToSend);
+typedef void (^OSSNetworkingDownloadProgressBlock) (int64_t bytesWritten, int64_t totalBytesWritten, int64_t totalBytesExpectedToWrite);
+typedef void (^OSSNetworkingRetryBlock) (void);
+typedef void (^OSSNetworkingCompletionHandlerBlock) (id _Nullable responseObject, NSError * _Nullable error);
+typedef void (^OSSNetworkingOnRecieveDataBlock) (NSData * data);
+
+/**
+ The flag of verification about crc64
+ */
+typedef NS_ENUM(NSUInteger, OSSRequestCRCFlag) {
+    OSSRequestCRCUninitialized,
+    OSSRequestCRCOpen,
+    OSSRequestCRCClosed
+};
+
+/**
+ Retry type definition
+ */
+typedef NS_ENUM(NSInteger, OSSNetworkingRetryType) {
+    OSSNetworkingRetryTypeUnknown,
+    OSSNetworkingRetryTypeShouldRetry,
+    OSSNetworkingRetryTypeShouldNotRetry,
+    OSSNetworkingRetryTypeShouldRefreshCredentialsAndRetry,
+    OSSNetworkingRetryTypeShouldCorrectClockSkewAndRetry
+};
+
+/**
+ * @brief: The following constants are provided by OSSNetworking as possible operation types.
+ */
+typedef NS_ENUM(NSInteger, OSSOperationType) {
+    OSSOperationTypeGetService,
+    OSSOperationTypeCreateBucket,
+    OSSOperationTypeDeleteBucket,
+    OSSOperationTypeGetBucket,
+    OSSOperationTypeGetBucketACL,
+    OSSOperationTypeHeadObject,
+    OSSOperationTypeGetObject,
+    OSSOperationTypeGetObjectACL,
+    OSSOperationTypePutObject,
+    OSSOperationTypePutObjectACL,
+    OSSOperationTypeAppendObject,
+    OSSOperationTypeDeleteObject,
+    OSSOperationTypeDeleteMultipleObjects,
+    OSSOperationTypeCopyObject,
+    OSSOperationTypeInitMultipartUpload,
+    OSSOperationTypeUploadPart,
+    OSSOperationTypeCompleteMultipartUpload,
+    OSSOperationTypeAbortMultipartUpload,
+    OSSOperationTypeListMultipart,
+    OSSOperationTypeListMultipartUploads,
+    OSSOperationTypeTriggerCallBack,
+    OSSOperationTypeImagePersist
+};
+
+/**
+ * @brief: The following constants are provided by OSSClient as possible error codes.
+ */
+typedef NS_ENUM(NSInteger, OSSClientErrorCODE) {
+    OSSClientErrorCodeNetworkingFailWithResponseCode0,
+    OSSClientErrorCodeSignFailed,
+    OSSClientErrorCodeFileCantWrite,
+    OSSClientErrorCodeInvalidArgument,
+    OSSClientErrorCodeNilUploadid,
+    OSSClientErrorCodeTaskCancelled,
+    OSSClientErrorCodeNetworkError,
+    OSSClientErrorCodeInvalidCRC,
+    OSSClientErrorCodeCannotResumeUpload,
+    OSSClientErrorCodeExcpetionCatched,
+    OSSClientErrorCodeNotKnown
+};
+
+typedef NS_ENUM(NSInteger, OSSXMLDictionaryAttributesMode)
+{
+    OSSXMLDictionaryAttributesModePrefixed = 0, //default
+    OSSXMLDictionaryAttributesModeDictionary,
+    OSSXMLDictionaryAttributesModeUnprefixed,
+    OSSXMLDictionaryAttributesModeDiscard
+};
+
+
+typedef NS_ENUM(NSInteger, OSSXMLDictionaryNodeNameMode)
+{
+    OSSXMLDictionaryNodeNameModeRootOnly = 0, //default
+    OSSXMLDictionaryNodeNameModeAlways,
+    OSSXMLDictionaryNodeNameModeNever
+};
+
+typedef NSString * OSSXMLDictionaryAttributeName NS_EXTENSIBLE_STRING_ENUM;
+
+OBJC_EXTERN OSSXMLDictionaryAttributeName const OSSXMLDictionaryAttributesKey;
+OBJC_EXTERN OSSXMLDictionaryAttributeName const OSSXMLDictionaryCommentsKey;
+OBJC_EXTERN OSSXMLDictionaryAttributeName const OSSXMLDictionaryTextKey;
+OBJC_EXTERN OSSXMLDictionaryAttributeName const OSSXMLDictionaryNodeNameKey;
+OBJC_EXTERN OSSXMLDictionaryAttributeName const OSSXMLDictionaryAttributePrefix;
+
+NS_ASSUME_NONNULL_END

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSDDLog.h

@@ -0,0 +1,860 @@
+// Software License Agreement (BSD License)
+//
+// Copyright (c) 2010-2016, Deusty, LLC
+// All rights reserved.
+//
+// Redistribution and use of this software in source and binary forms,
+// with or without modification, are permitted provided that the following conditions are met:
+//
+// * Redistributions of source code must retain the above copyright notice,
+//   this list of conditions and the following disclaimer.
+//
+// * Neither the name of Deusty nor the names of its contributors may be used
+//   to endorse or promote products derived from this software without specific
+//   prior written permission of Deusty, LLC.
+
+#import <Foundation/Foundation.h>
+
+// Enable 1.9.x legacy macros if imported directly
+#ifndef OSSDD_LEGACY_MACROS
+    #define OSSDD_LEGACY_MACROS 1
+#endif
+
+#if OS_OBJECT_USE_OBJC
+    #define DISPATCH_QUEUE_REFERENCE_TYPE strong
+#else
+    #define DISPATCH_QUEUE_REFERENCE_TYPE assign
+#endif
+
+@class OSSDDLogMessage;
+@class OSSDDLoggerInformation;
+@protocol OSSDDLogger;
+@protocol OSSDDLogFormatter;
+
+/**
+ * Define the standard options.
+ *
+ * We default to only 4 levels because it makes it easier for beginners
+ * to make the transition to a logging framework.
+ *
+ * More advanced users may choose to completely customize the levels (and level names) to suite their needs.
+ * For more information on this see the "Custom Log Levels" page:
+ * Documentation/CustomLogLevels.md
+ *
+ * Advanced users may also notice that we're using a bitmask.
+ * This is to allow for custom fine grained logging:
+ * Documentation/FineGrainedLogging.md
+ *
+ * -- Flags --
+ *
+ * Typically you will use the LOG_LEVELS (see below), but the flags may be used directly in certain situations.
+ * For example, say you have a lot of warning log messages, and you wanted to disable them.
+ * However, you still needed to see your error and info log messages.
+ * You could accomplish that with the following:
+ *
+ * static const DDLogLevel ddLogLevel = DDLogFlagError | DDLogFlagInfo;
+ *
+ * When LOG_LEVEL_DEF is defined as ddLogLevel.
+ *
+ * Flags may also be consulted when writing custom log formatters,
+ * as the DDLogMessage class captures the individual flag that caused the log message to fire.
+ *
+ * -- Levels --
+ *
+ * Log levels are simply the proper bitmask of the flags.
+ *
+ * -- Booleans --
+ *
+ * The booleans may be used when your logging code involves more than one line.
+ * For example:
+ *
+ * if (LOG_VERBOSE) {
+ *     for (id sprocket in sprockets)
+ *         DDLogVerbose(@"sprocket: %@", [sprocket description])
+ * }
+ *
+ * -- Async --
+ *
+ * Defines the default asynchronous options.
+ * The default philosophy for asynchronous logging is very simple:
+ *
+ * Log messages with errors should be executed synchronously.
+ *     After all, an error just occurred. The application could be unstable.
+ *
+ * All other log messages, such as debug output, are executed asynchronously.
+ *     After all, if it wasn't an error, then it was just informational output,
+ *     or something the application was easily able to recover from.
+ *
+ * -- Changes --
+ *
+ * You are strongly discouraged from modifying this file.
+ * If you do, you make it more difficult on yourself to merge future bug fixes and improvements from the project.
+ * Instead, create your own MyLogging.h or ApplicationNameLogging.h or CompanyLogging.h
+ *
+ * For an example of customizing your logging experience, see the "Custom Log Levels" page:
+ * Documentation/CustomLogLevels.md
+ **/
+
+/**
+ *  Flags accompany each log. They are used together with levels to filter out logs.
+ */
+typedef NS_OPTIONS(NSUInteger, OSSDDLogFlag){
+    /**
+     *  0...00001 DDLogFlagError
+     */
+    OSSDDLogFlagError      = (1 << 0),
+    
+    /**
+     *  0...00010 DDLogFlagWarning
+     */
+    OSSDDLogFlagWarning    = (1 << 1),
+    
+    /**
+     *  0...00100 DDLogFlagInfo
+     */
+    OSSDDLogFlagInfo       = (1 << 2),
+    
+    /**
+     *  0...01000 DDLogFlagDebug
+     */
+    OSSDDLogFlagDebug      = (1 << 3),
+    
+    /**
+     *  0...10000 DDLogFlagVerbose
+     */
+    OSSDDLogFlagVerbose    = (1 << 4)
+};
+
+/**
+ *  Log levels are used to filter out logs. Used together with flags.
+ */
+typedef NS_ENUM(NSUInteger, OSSDDLogLevel){
+    /**
+     *  No logs
+     */
+    OSSDDLogLevelOff       = 0,
+    
+    /**
+     *  Error logs only
+     */
+    OSSDDLogLevelError     = (OSSDDLogFlagError),
+    
+    /**
+     *  Error and warning logs
+     */
+    OSSDDLogLevelWarning   = (OSSDDLogLevelError   | OSSDDLogFlagWarning),
+    
+    /**
+     *  Error, warning and info logs
+     */
+    OSSDDLogLevelInfo      = (OSSDDLogLevelWarning | OSSDDLogFlagInfo),
+    
+    /**
+     *  Error, warning, info and debug logs
+     */
+    OSSDDLogLevelDebug     = (OSSDDLogLevelInfo    | OSSDDLogFlagDebug),
+    
+    /**
+     *  Error, warning, info, debug and verbose logs
+     */
+    OSSDDLogLevelVerbose   = (OSSDDLogLevelDebug   | OSSDDLogFlagVerbose),
+    
+    /**
+     *  All logs (1...11111)
+     */
+    OSSDDLogLevelAll       = NSUIntegerMax
+};
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ *  Extracts just the file name, no path or extension
+ *
+ *  @param filePath input file path
+ *  @param copy     YES if we want the result to be copied
+ *
+ *  @return the file name
+ */
+NSString * __nullable OSSDDExtractFileNameWithoutExtension(const char *filePath, BOOL copy);
+
+/**
+ * The THIS_FILE macro gives you an NSString of the file name.
+ * For simplicity and clarity, the file name does not include the full path or file extension.
+ *
+ * For example: DDLogWarn(@"%@: Unable to find thingy", THIS_FILE) -> @"MyViewController: Unable to find thingy"
+ **/
+#define THIS_FILE         (DDExtractFileNameWithoutExtension(__FILE__, NO))
+
+/**
+ * The THIS_METHOD macro gives you the name of the current objective-c method.
+ *
+ * For example: DDLogWarn(@"%@ - Requires non-nil strings", THIS_METHOD) -> @"setMake:model: requires non-nil strings"
+ *
+ * Note: This does NOT work in straight C functions (non objective-c).
+ * Instead you should use the predefined __FUNCTION__ macro.
+ **/
+#define THIS_METHOD       NSStringFromSelector(_cmd)
+
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ *  The main class, exposes all logging mechanisms, loggers, ...
+ *  For most of the users, this class is hidden behind the logging functions like `DDLogInfo`
+ */
+@interface OSSDDLog : NSObject
+
+/**
+ *  Returns the singleton `DDLog`.
+ *  The instance is used by `DDLog` class methods.
+ */
+@property (class, nonatomic, strong, readonly) OSSDDLog *sharedInstance;
+
+/**
+ * Provides access to the underlying logging queue.
+ * This may be helpful to Logger classes for things like thread synchronization.
+ **/
+@property (class, nonatomic, DISPATCH_QUEUE_REFERENCE_TYPE, readonly) dispatch_queue_t loggingQueue;
+
+/**
+ * Logging Primitive.
+ *
+ * This method is used by the macros or logging functions.
+ * It is suggested you stick with the macros as they're easier to use.
+ *
+ *  @param asynchronous YES if the logging is done async, NO if you want to force sync
+ *  @param level        the log level
+ *  @param flag         the log flag
+ *  @param context      the context (if any is defined)
+ *  @param file         the current file
+ *  @param function     the current function
+ *  @param line         the current code line
+ *  @param tag          potential tag
+ *  @param format       the log format
+ */
++ (void)log:(BOOL)asynchronous
+      level:(OSSDDLogLevel)level
+       flag:(OSSDDLogFlag)flag
+    context:(NSInteger)context
+       file:(const char *)file
+   function:(const char *)function
+       line:(NSUInteger)line
+        tag:(id __nullable)tag
+     format:(NSString *)format, ... NS_FORMAT_FUNCTION(9,10);
+
+/**
+ * Logging Primitive.
+ *
+ * This method is used by the macros or logging functions.
+ * It is suggested you stick with the macros as they're easier to use.
+ *
+ *  @param asynchronous YES if the logging is done async, NO if you want to force sync
+ *  @param level        the log level
+ *  @param flag         the log flag
+ *  @param context      the context (if any is defined)
+ *  @param file         the current file
+ *  @param function     the current function
+ *  @param line         the current code line
+ *  @param tag          potential tag
+ *  @param format       the log format
+ */
+- (void)log:(BOOL)asynchronous
+      level:(OSSDDLogLevel)level
+       flag:(OSSDDLogFlag)flag
+    context:(NSInteger)context
+       file:(const char *)file
+   function:(const char *)function
+       line:(NSUInteger)line
+        tag:(id __nullable)tag
+     format:(NSString *)format, ... NS_FORMAT_FUNCTION(9,10);
+
+/**
+ * Logging Primitive.
+ *
+ * This method can be used if you have a prepared va_list.
+ * Similar to `log:level:flag:context:file:function:line:tag:format:...`
+ *
+ *  @param asynchronous YES if the logging is done async, NO if you want to force sync
+ *  @param level        the log level
+ *  @param flag         the log flag
+ *  @param context      the context (if any is defined)
+ *  @param file         the current file
+ *  @param function     the current function
+ *  @param line         the current code line
+ *  @param tag          potential tag
+ *  @param format       the log format
+ *  @param argList      the arguments list as a va_list
+ */
++ (void)log:(BOOL)asynchronous
+      level:(OSSDDLogLevel)level
+       flag:(OSSDDLogFlag)flag
+    context:(NSInteger)context
+       file:(const char *)file
+   function:(const char *)function
+       line:(NSUInteger)line
+        tag:(id __nullable)tag
+     format:(NSString *)format
+       args:(va_list)argList NS_SWIFT_NAME(log(asynchronous:level:flag:context:file:function:line:tag:format:arguments:));
+
+/**
+ * Logging Primitive.
+ *
+ * This method can be used if you have a prepared va_list.
+ * Similar to `log:level:flag:context:file:function:line:tag:format:...`
+ *
+ *  @param asynchronous YES if the logging is done async, NO if you want to force sync
+ *  @param level        the log level
+ *  @param flag         the log flag
+ *  @param context      the context (if any is defined)
+ *  @param file         the current file
+ *  @param function     the current function
+ *  @param line         the current code line
+ *  @param tag          potential tag
+ *  @param format       the log format
+ *  @param argList      the arguments list as a va_list
+ */
+- (void)log:(BOOL)asynchronous
+      level:(OSSDDLogLevel)level
+       flag:(OSSDDLogFlag)flag
+    context:(NSInteger)context
+       file:(const char *)file
+   function:(const char *)function
+       line:(NSUInteger)line
+        tag:(id __nullable)tag
+     format:(NSString *)format
+       args:(va_list)argList NS_SWIFT_NAME(log(asynchronous:level:flag:context:file:function:line:tag:format:arguments:));
+
+/**
+ * Logging Primitive.
+ *
+ * This method can be used if you manualy prepared DDLogMessage.
+ *
+ *  @param asynchronous YES if the logging is done async, NO if you want to force sync
+ *  @param logMessage   the log message stored in a `DDLogMessage` model object
+ */
++ (void)log:(BOOL)asynchronous
+    message:(OSSDDLogMessage *)logMessage NS_SWIFT_NAME(log(asynchronous:message:));
+
+/**
+ * Logging Primitive.
+ *
+ * This method can be used if you manualy prepared DDLogMessage.
+ *
+ *  @param asynchronous YES if the logging is done async, NO if you want to force sync
+ *  @param logMessage   the log message stored in a `DDLogMessage` model object
+ */
+- (void)log:(BOOL)asynchronous
+    message:(OSSDDLogMessage *)logMessage NS_SWIFT_NAME(log(asynchronous:message:));
+
+/**
+ * Since logging can be asynchronous, there may be times when you want to flush the logs.
+ * The framework invokes this automatically when the application quits.
+ **/
++ (void)flushLog;
+
+/**
+ * Since logging can be asynchronous, there may be times when you want to flush the logs.
+ * The framework invokes this automatically when the application quits.
+ **/
+- (void)flushLog;
+
+/**
+ * Loggers
+ *
+ * In order for your log statements to go somewhere, you should create and add a logger.
+ *
+ * You can add multiple loggers in order to direct your log statements to multiple places.
+ * And each logger can be configured separately.
+ * So you could have, for example, verbose logging to the console, but a concise log file with only warnings & errors.
+ **/
+
+/**
+ * Adds the logger to the system.
+ *
+ * This is equivalent to invoking `[DDLog addLogger:logger withLogLevel:DDLogLevelAll]`.
+ **/
++ (void)addLogger:(id <OSSDDLogger>)logger;
+
+/**
+ * Adds the logger to the system.
+ *
+ * This is equivalent to invoking `[DDLog addLogger:logger withLogLevel:DDLogLevelAll]`.
+ **/
+- (void)addLogger:(id <OSSDDLogger>)logger;
+
+/**
+ * Adds the logger to the system.
+ *
+ * The level that you provide here is a preemptive filter (for performance).
+ * That is, the level specified here will be used to filter out logMessages so that
+ * the logger is never even invoked for the messages.
+ *
+ * More information:
+ * When you issue a log statement, the logging framework iterates over each logger,
+ * and checks to see if it should forward the logMessage to the logger.
+ * This check is done using the level parameter passed to this method.
+ *
+ * For example:
+ *
+ * `[DDLog addLogger:consoleLogger withLogLevel:DDLogLevelVerbose];`
+ * `[DDLog addLogger:fileLogger    withLogLevel:DDLogLevelWarning];`
+ *
+ * `DDLogError(@"oh no");` => gets forwarded to consoleLogger & fileLogger
+ * `DDLogInfo(@"hi");`     => gets forwarded to consoleLogger only
+ *
+ * It is important to remember that Lumberjack uses a BITMASK.
+ * Many developers & third party frameworks may define extra log levels & flags.
+ * For example:
+ *
+ * `#define SOME_FRAMEWORK_LOG_FLAG_TRACE (1 << 6) // 0...1000000`
+ *
+ * So if you specify `DDLogLevelVerbose` to this method, you won't see the framework's trace messages.
+ *
+ * `(SOME_FRAMEWORK_LOG_FLAG_TRACE & DDLogLevelVerbose) => (01000000 & 00011111) => NO`
+ *
+ * Consider passing `DDLogLevelAll` to this method, which has all bits set.
+ * You can also use the exclusive-or bitwise operator to get a bitmask that has all flags set,
+ * except the ones you explicitly don't want. For example, if you wanted everything except verbose & debug:
+ *
+ * `((DDLogLevelAll ^ DDLogLevelVerbose) | DDLogLevelInfo)`
+ **/
++ (void)addLogger:(id <OSSDDLogger>)logger withLevel:(OSSDDLogLevel)level;
+
+/**
+ * Adds the logger to the system.
+ *
+ * The level that you provide here is a preemptive filter (for performance).
+ * That is, the level specified here will be used to filter out logMessages so that
+ * the logger is never even invoked for the messages.
+ *
+ * More information:
+ * When you issue a log statement, the logging framework iterates over each logger,
+ * and checks to see if it should forward the logMessage to the logger.
+ * This check is done using the level parameter passed to this method.
+ *
+ * For example:
+ *
+ * `[DDLog addLogger:consoleLogger withLogLevel:DDLogLevelVerbose];`
+ * `[DDLog addLogger:fileLogger    withLogLevel:DDLogLevelWarning];`
+ *
+ * `DDLogError(@"oh no");` => gets forwarded to consoleLogger & fileLogger
+ * `DDLogInfo(@"hi");`     => gets forwarded to consoleLogger only
+ *
+ * It is important to remember that Lumberjack uses a BITMASK.
+ * Many developers & third party frameworks may define extra log levels & flags.
+ * For example:
+ *
+ * `#define SOME_FRAMEWORK_LOG_FLAG_TRACE (1 << 6) // 0...1000000`
+ *
+ * So if you specify `DDLogLevelVerbose` to this method, you won't see the framework's trace messages.
+ *
+ * `(SOME_FRAMEWORK_LOG_FLAG_TRACE & DDLogLevelVerbose) => (01000000 & 00011111) => NO`
+ *
+ * Consider passing `DDLogLevelAll` to this method, which has all bits set.
+ * You can also use the exclusive-or bitwise operator to get a bitmask that has all flags set,
+ * except the ones you explicitly don't want. For example, if you wanted everything except verbose & debug:
+ *
+ * `((DDLogLevelAll ^ DDLogLevelVerbose) | DDLogLevelInfo)`
+ **/
+- (void)addLogger:(id <OSSDDLogger>)logger withLevel:(OSSDDLogLevel)level;
+
+/**
+ *  Remove the logger from the system
+ */
++ (void)removeLogger:(id <OSSDDLogger>)logger;
+
+/**
+ *  Remove the logger from the system
+ */
+- (void)removeLogger:(id <OSSDDLogger>)logger;
+
+/**
+ *  Remove all the current loggers
+ */
++ (void)removeAllLoggers;
+
+/**
+ *  Remove all the current loggers
+ */
+- (void)removeAllLoggers;
+
+/**
+ *  Return all the current loggers
+ */
+@property (class, nonatomic, copy, readonly) NSArray<id<OSSDDLogger>> *allLoggers;
+
+/**
+ *  Return all the current loggers
+ */
+@property (nonatomic, copy, readonly) NSArray<id<OSSDDLogger>> *allLoggers;
+
+/**
+ *  Return all the current loggers with their level (aka DDLoggerInformation).
+ */
+@property (class, nonatomic, copy, readonly) NSArray<OSSDDLoggerInformation *> *allLoggersWithLevel;
+
+/**
+ *  Return all the current loggers with their level (aka DDLoggerInformation).
+ */
+@property (nonatomic, copy, readonly) NSArray<OSSDDLoggerInformation *> *allLoggersWithLevel;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ *  This protocol describes a basic logger behavior. 
+ *  Basically, it can log messages, store a logFormatter plus a bunch of optional behaviors.
+ *  (i.e. flush, get its loggerQueue, get its name, ...
+ */
+@protocol OSSDDLogger <NSObject>
+
+/**
+ *  The log message method
+ *
+ *  @param logMessage the message (model)
+ */
+- (void)logMessage:(OSSDDLogMessage *)logMessage NS_SWIFT_NAME(log(message:));
+
+/**
+ * Formatters may optionally be added to any logger.
+ *
+ * If no formatter is set, the logger simply logs the message as it is given in logMessage,
+ * or it may use its own built in formatting style.
+ **/
+@property (nonatomic, strong) id <OSSDDLogFormatter> logFormatter;
+
+@optional
+
+/**
+ * Since logging is asynchronous, adding and removing loggers is also asynchronous.
+ * In other words, the loggers are added and removed at appropriate times with regards to log messages.
+ *
+ * - Loggers will not receive log messages that were executed prior to when they were added.
+ * - Loggers will not receive log messages that were executed after they were removed.
+ *
+ * These methods are executed in the logging thread/queue.
+ * This is the same thread/queue that will execute every logMessage: invocation.
+ * Loggers may use these methods for thread synchronization or other setup/teardown tasks.
+ **/
+- (void)didAddLogger;
+
+/**
+ * Since logging is asynchronous, adding and removing loggers is also asynchronous.
+ * In other words, the loggers are added and removed at appropriate times with regards to log messages.
+ *
+ * - Loggers will not receive log messages that were executed prior to when they were added.
+ * - Loggers will not receive log messages that were executed after they were removed.
+ *
+ * These methods are executed in the logging thread/queue given in parameter.
+ * This is the same thread/queue that will execute every logMessage: invocation.
+ * Loggers may use the queue parameter to set specific values on the queue with dispatch_set_specific() function.
+ **/
+- (void)didAddLoggerInQueue:(dispatch_queue_t)queue;
+
+/**
+ *  See the above description for `didAddLoger`
+ */
+- (void)willRemoveLogger;
+
+/**
+ * Some loggers may buffer IO for optimization purposes.
+ * For example, a database logger may only save occasionaly as the disk IO is slow.
+ * In such loggers, this method should be implemented to flush any pending IO.
+ *
+ * This allows invocations of DDLog's flushLog method to be propogated to loggers that need it.
+ *
+ * Note that DDLog's flushLog method is invoked automatically when the application quits,
+ * and it may be also invoked manually by the developer prior to application crashes, or other such reasons.
+ **/
+- (void)flush;
+
+/**
+ * Each logger is executed concurrently with respect to the other loggers.
+ * Thus, a dedicated dispatch queue is used for each logger.
+ * Logger implementations may optionally choose to provide their own dispatch queue.
+ **/
+@property (nonatomic, DISPATCH_QUEUE_REFERENCE_TYPE, readonly) dispatch_queue_t loggerQueue;
+
+/**
+ * If the logger implementation does not choose to provide its own queue,
+ * one will automatically be created for it.
+ * The created queue will receive its name from this method.
+ * This may be helpful for debugging or profiling reasons.
+ **/
+@property (nonatomic, readonly) NSString *loggerName;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ *  This protocol describes the behavior of a log formatter
+ */
+@protocol OSSDDLogFormatter <NSObject>
+@required
+
+/**
+ * Formatters may optionally be added to any logger.
+ * This allows for increased flexibility in the logging environment.
+ * For example, log messages for log files may be formatted differently than log messages for the console.
+ *
+ * For more information about formatters, see the "Custom Formatters" page:
+ * Documentation/CustomFormatters.md
+ *
+ * The formatter may also optionally filter the log message by returning nil,
+ * in which case the logger will not log the message.
+ **/
+- (NSString * __nullable)formatLogMessage:(OSSDDLogMessage *)logMessage NS_SWIFT_NAME(format(message:));
+
+@optional
+
+/**
+ * A single formatter instance can be added to multiple loggers.
+ * These methods provides hooks to notify the formatter of when it's added/removed.
+ *
+ * This is primarily for thread-safety.
+ * If a formatter is explicitly not thread-safe, it may wish to throw an exception if added to multiple loggers.
+ * Or if a formatter has potentially thread-unsafe code (e.g. NSDateFormatter),
+ * it could possibly use these hooks to switch to thread-safe versions of the code.
+ **/
+- (void)didAddToLogger:(id <OSSDDLogger>)logger;
+
+/**
+ * A single formatter instance can be added to multiple loggers.
+ * These methods provides hooks to notify the formatter of when it's added/removed.
+ *
+ * This is primarily for thread-safety.
+ * If a formatter is explicitly not thread-safe, it may wish to throw an exception if added to multiple loggers.
+ * Or if a formatter has potentially thread-unsafe code (e.g. NSDateFormatter),
+ * it could possibly use these hooks to switch to thread-safe versions of the code or use dispatch_set_specific()
+.* to add its own specific values.
+ **/
+- (void)didAddToLogger:(id <OSSDDLogger>)logger inQueue:(dispatch_queue_t)queue;
+
+/**
+ *  See the above description for `didAddToLogger:`
+ */
+- (void)willRemoveFromLogger:(id <OSSDDLogger>)logger;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ *  This protocol describes a dynamic logging component
+ */
+@protocol OSSDDRegisteredDynamicLogging
+
+/**
+ * Implement these methods to allow a file's log level to be managed from a central location.
+ *
+ * This is useful if you'd like to be able to change log levels for various parts
+ * of your code from within the running application.
+ *
+ * Imagine pulling up the settings for your application,
+ * and being able to configure the logging level on a per file basis.
+ *
+ * The implementation can be very straight-forward:
+ *
+ * ```
+ * + (int)ddLogLevel
+ * {
+ *     return ddLogLevel;
+ * }
+ *
+ * + (void)ddSetLogLevel:(DDLogLevel)level
+ * {
+ *     ddLogLevel = level;
+ * }
+ * ```
+ **/
+@property (class, nonatomic, readwrite, setter=ddSetLogLevel:) OSSDDLogLevel ossLogLevel;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+#ifndef NS_DESIGNATED_INITIALIZER
+    #define NS_DESIGNATED_INITIALIZER
+#endif
+
+/**
+ *  Log message options, allow copying certain log elements
+ */
+typedef NS_OPTIONS(NSInteger, OSSDDLogMessageOptions){
+    /**
+     *  Use this to use a copy of the file path
+     */
+    OSSDDLogMessageCopyFile        = 1 << 0,
+    /**
+     *  Use this to use a copy of the function name
+     */
+    OSSDDLogMessageCopyFunction    = 1 << 1,
+    /**
+     *  Use this to use avoid a copy of the message
+     */
+    OSSDDLogMessageDontCopyMessage = 1 << 2
+};
+
+/**
+ * The `DDLogMessage` class encapsulates information about the log message.
+ * If you write custom loggers or formatters, you will be dealing with objects of this class.
+ **/
+@interface OSSDDLogMessage : NSObject <NSCopying>
+{
+    // Direct accessors to be used only for performance
+    @public
+    NSString *_message;
+    OSSDDLogLevel _level;
+    OSSDDLogFlag _flag;
+    NSInteger _context;
+    NSString *_file;
+    NSString *_fileName;
+    NSString *_function;
+    NSUInteger _line;
+    id _tag;
+    OSSDDLogMessageOptions _options;
+    NSDate *_timestamp;
+    NSString *_threadID;
+    NSString *_threadName;
+    NSString *_queueLabel;
+}
+
+/**
+ *  Default `init` for empty messages.
+ */
+- (instancetype)init NS_DESIGNATED_INITIALIZER;
+
+/**
+ * Standard init method for a log message object.
+ * Used by the logging primitives. (And the macros use the logging primitives.)
+ *
+ * If you find need to manually create logMessage objects, there is one thing you should be aware of:
+ *
+ * If no flags are passed, the method expects the file and function parameters to be string literals.
+ * That is, it expects the given strings to exist for the duration of the object's lifetime,
+ * and it expects the given strings to be immutable.
+ * In other words, it does not copy these strings, it simply points to them.
+ * This is due to the fact that __FILE__ and __FUNCTION__ are usually used to specify these parameters,
+ * so it makes sense to optimize and skip the unnecessary allocations.
+ * However, if you need them to be copied you may use the options parameter to specify this.
+ *
+ *  @param message   the message
+ *  @param level     the log level
+ *  @param flag      the log flag
+ *  @param context   the context (if any is defined)
+ *  @param file      the current file
+ *  @param function  the current function
+ *  @param line      the current code line
+ *  @param tag       potential tag
+ *  @param options   a bitmask which supports DDLogMessageCopyFile and DDLogMessageCopyFunction.
+ *  @param timestamp the log timestamp
+ *
+ *  @return a new instance of a log message model object
+ */
+- (instancetype)initWithMessage:(NSString *)message
+                          level:(OSSDDLogLevel)level
+                           flag:(OSSDDLogFlag)flag
+                        context:(NSInteger)context
+                           file:(NSString *)file
+                       function:(NSString * __nullable)function
+                           line:(NSUInteger)line
+                            tag:(id __nullable)tag
+                        options:(OSSDDLogMessageOptions)options
+                      timestamp:(NSDate * __nullable)timestamp NS_DESIGNATED_INITIALIZER;
+
+/**
+ * Read-only properties
+ **/
+
+/**
+ *  The log message
+ */
+@property (readonly, nonatomic) NSString *message;
+@property (readonly, nonatomic) OSSDDLogLevel level;
+@property (readonly, nonatomic) OSSDDLogFlag flag;
+@property (readonly, nonatomic) NSInteger context;
+@property (readonly, nonatomic) NSString *file;
+@property (readonly, nonatomic) NSString *fileName;
+@property (readonly, nonatomic) NSString * __nullable function;
+@property (readonly, nonatomic) NSUInteger line;
+@property (readonly, nonatomic) id __nullable tag;
+@property (readonly, nonatomic) OSSDDLogMessageOptions options;
+@property (readonly, nonatomic) NSDate *timestamp;
+@property (readonly, nonatomic) NSString *threadID; // ID as it appears in NSLog calculated from the machThreadID
+@property (readonly, nonatomic) NSString *threadName;
+@property (readonly, nonatomic) NSString *queueLabel;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * The `DDLogger` protocol specifies that an optional formatter can be added to a logger.
+ * Most (but not all) loggers will want to support formatters.
+ *
+ * However, writting getters and setters in a thread safe manner,
+ * while still maintaining maximum speed for the logging process, is a difficult task.
+ *
+ * To do it right, the implementation of the getter/setter has strict requiremenets:
+ * - Must NOT require the `logMessage:` method to acquire a lock.
+ * - Must NOT require the `logMessage:` method to access an atomic property (also a lock of sorts).
+ *
+ * To simplify things, an abstract logger is provided that implements the getter and setter.
+ *
+ * Logger implementations may simply extend this class,
+ * and they can ACCESS THE FORMATTER VARIABLE DIRECTLY from within their `logMessage:` method!
+ **/
+@interface OSSDDAbstractLogger : NSObject <OSSDDLogger>
+{
+    // Direct accessors to be used only for performance
+    @public
+    id <OSSDDLogFormatter> _logFormatter;
+    dispatch_queue_t _loggerQueue;
+}
+
+@property (nonatomic, strong, nullable) id <OSSDDLogFormatter> logFormatter;
+@property (nonatomic, DISPATCH_QUEUE_REFERENCE_TYPE) dispatch_queue_t loggerQueue;
+
+// For thread-safety assertions
+
+/**
+ *  Return YES if the current logger uses a global queue for logging
+ */
+@property (nonatomic, readonly, getter=isOnGlobalLoggingQueue)  BOOL onGlobalLoggingQueue;
+
+/**
+ *  Return YES if the current logger uses the internal designated queue for logging
+ */
+@property (nonatomic, readonly, getter=isOnInternalLoggerQueue) BOOL onInternalLoggerQueue;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+@interface OSSDDLoggerInformation : NSObject
+
+@property (nonatomic, readonly) id <OSSDDLogger> logger;
+@property (nonatomic, readonly) OSSDDLogLevel level;
+
++ (OSSDDLoggerInformation *)informationWithLogger:(id <OSSDDLogger>)logger
+                           andLevel:(OSSDDLogLevel)level;
+
+@end
+
+NS_ASSUME_NONNULL_END

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSDefine.h

@@ -11,17 +11,27 @@
 #ifndef OSSDefine_h
 #define OSSDefine_h
 
+#if TARGET_OS_IOS
 #define OSSUAPrefix                             @"aliyun-sdk-ios"
-#define OSSSDKVersion                           @"2.6.1"
+#elif TARGET_OS_OSX
+#define OSSUAPrefix                             @"aliyun-sdk-mac"
+#endif
+#define OSSSDKVersion                           @"2.10.4"
 
 #define OSSListBucketResultXMLTOKEN             @"ListBucketResult"
 #define OSSNameXMLTOKEN                         @"Name"
 #define OSSDelimiterXMLTOKEN                    @"Delimiter"
 #define OSSMarkerXMLTOKEN                       @"Marker"
+#define OSSKeyMarkerXMLTOKEN                    @"KeyMarker"
 #define OSSNextMarkerXMLTOKEN                   @"NextMarker"
+#define OSSNextKeyMarkerXMLTOKEN                @"NextKeyMarker"
+#define OSSUploadIdMarkerXMLTOKEN               @"UploadIdMarker"
+#define OSSNextUploadIdMarkerXMLTOKEN           @"NextUploadIdMarker"
 #define OSSMaxKeysXMLTOKEN                      @"MaxKeys"
+#define OSSMaxUploadsXMLTOKEN                   @"MaxUploads"
 #define OSSIsTruncatedXMLTOKEN                  @"IsTruncated"
 #define OSSContentsXMLTOKEN                     @"Contents"
+#define OSSUploadXMLTOKEN                       @"Upload"
 #define OSSKeyXMLTOKEN                          @"Key"
 #define OSSLastModifiedXMLTOKEN                 @"LastModified"
 #define OSSETagXMLTOKEN                         @"ETag"
@@ -58,6 +68,7 @@
 #define OSSHttpHeaderContentMD5                 @"Content-MD5"
 #define OSSHttpHeaderCacheControl               @"Cache-Control"
 #define OSSHttpHeaderExpires                    @"Expires"
+#define OSSHttpHeaderHashSHA1                   @"x-oss-hash-sha1"
 
 #define OSSDefaultRetryCount                    3
 #define OSSDefaultMaxConcurrentNum              5

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSDeleteMultipleObjectsRequest.h

@@ -0,0 +1,31 @@
+//
+//  OSSDeleteMultipleObjectsRequest.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/26.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+#import <Foundation/Foundation.h>
+#import "OSSRequest.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface OSSDeleteMultipleObjectsRequest : OSSRequest
+
+@property (nonatomic, copy) NSString *bucketName;
+
+@property (nonatomic, copy) NSArray<NSString *> *keys;
+
+/**
+ invalid value is @"url"
+ */
+@property (nonatomic, copy, nullable) NSString *encodingType;
+
+/**
+ whether to show verbose result,the default value is YES.
+ */
+@property (nonatomic, assign) BOOL quiet;
+
+@end
+
+NS_ASSUME_NONNULL_END

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSDeleteMultipleObjectsResult.h

@@ -0,0 +1,17 @@
+//
+//  OSSDeleteMultipleObjectsResult.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/26.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import "OSSResult.h"
+
+@interface OSSDeleteMultipleObjectsResult : OSSResult
+
+@property (nonatomic, copy) NSArray<NSString *> *deletedObjects;
+
+@property (nonatomic, copy) NSString *encodingType;
+
+@end

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSExecutor.h

@@ -37,7 +37,7 @@ NS_ASSUME_NONNULL_BEGIN
  Returns a new executor that uses the given block to execute continuations.
  @param block The block to use.
  */
-+ (instancetype)executorWithBlock:(void(^)(void(^block)()))block;
++ (instancetype)executorWithBlock:(void(^)(void(^block)(void)))block;
 
 /*!
  Returns a new executor that runs continuations on the given queue.
@@ -55,7 +55,7 @@ NS_ASSUME_NONNULL_BEGIN
  Runs the given block using this executor's particular strategy.
  @param block The block to execute.
  */
-- (void)execute:(void(^)())block;
+- (void)execute:(void(^)(void))block;
 
 @end
 

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSFileLogger.h

@@ -0,0 +1,509 @@
+// Software License Agreement (BSD License)
+//
+// Copyright (c) 2010-2016, Deusty, LLC
+// All rights reserved.
+//
+// Redistribution and use of this software in source and binary forms,
+// with or without modification, are permitted provided that the following conditions are met:
+//
+// * Redistributions of source code must retain the above copyright notice,
+//   this list of conditions and the following disclaimer.
+//
+// * Neither the name of Deusty nor the names of its contributors may be used
+//   to endorse or promote products derived from this software without specific
+//   prior written permission of Deusty, LLC.
+
+// Disable legacy macros
+#ifndef DD_LEGACY_MACROS
+    #define DD_LEGACY_MACROS 0
+#endif
+
+#import "OSSDDLog.h"
+
+@class OSSDDLogFileInfo;
+
+/**
+ * This class provides a logger to write log statements to a file.
+ **/
+
+
+// Default configuration and safety/sanity values.
+//
+// maximumFileSize         -> kDDDefaultLogMaxFileSize
+// rollingFrequency        -> kDDDefaultLogRollingFrequency
+// maximumNumberOfLogFiles -> kDDDefaultLogMaxNumLogFiles
+// logFilesDiskQuota       -> kDDDefaultLogFilesDiskQuota
+//
+// You should carefully consider the proper configuration values for your application.
+
+extern unsigned long long const osskDDDefaultLogMaxFileSize;
+extern NSTimeInterval     const osskDDDefaultLogRollingFrequency;
+extern NSUInteger         const osskDDDefaultLogMaxNumLogFiles;
+extern unsigned long long const osskDDDefaultLogFilesDiskQuota;
+
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ *  The LogFileManager protocol is designed to allow you to control all aspects of your log files.
+ *
+ *  The primary purpose of this is to allow you to do something with the log files after they have been rolled.
+ *  Perhaps you want to compress them to save disk space.
+ *  Perhaps you want to upload them to an FTP server.
+ *  Perhaps you want to run some analytics on the file.
+ *
+ *  A default LogFileManager is, of course, provided.
+ *  The default LogFileManager simply deletes old log files according to the maximumNumberOfLogFiles property.
+ *
+ *  This protocol provides various methods to fetch the list of log files.
+ *
+ *  There are two variants: sorted and unsorted.
+ *  If sorting is not necessary, the unsorted variant is obviously faster.
+ *  The sorted variant will return an array sorted by when the log files were created,
+ *  with the most recently created log file at index 0, and the oldest log file at the end of the array.
+ *
+ *  You can fetch only the log file paths (full path including name), log file names (name only),
+ *  or an array of `DDLogFileInfo` objects.
+ *  The `DDLogFileInfo` class is documented below, and provides a handy wrapper that
+ *  gives you easy access to various file attributes such as the creation date or the file size.
+ */
+@protocol OSSDDLogFileManager <NSObject>
+@required
+
+// Public properties
+
+/**
+ * The maximum number of archived log files to keep on disk.
+ * For example, if this property is set to 3,
+ * then the LogFileManager will only keep 3 archived log files (plus the current active log file) on disk.
+ * Once the active log file is rolled/archived, then the oldest of the existing 3 rolled/archived log files is deleted.
+ *
+ * You may optionally disable this option by setting it to zero.
+ **/
+@property (readwrite, assign, atomic) NSUInteger maximumNumberOfLogFiles;
+
+/**
+ * The maximum space that logs can take. On rolling logfile all old logfiles that exceed logFilesDiskQuota will
+ * be deleted.
+ *
+ * You may optionally disable this option by setting it to zero.
+ **/
+@property (readwrite, assign, atomic) unsigned long long logFilesDiskQuota;
+
+// Public methods
+
+/**
+ *  Returns the logs directory (path)
+ */
+@property (nonatomic, readonly, copy) NSString *logsDirectory;
+
+/**
+ * Returns an array of `NSString` objects,
+ * each of which is the filePath to an existing log file on disk.
+ **/
+@property (nonatomic, readonly, strong) NSArray<NSString *> *unsortedLogFilePaths;
+
+/**
+ * Returns an array of `NSString` objects,
+ * each of which is the fileName of an existing log file on disk.
+ **/
+@property (nonatomic, readonly, strong) NSArray<NSString *> *unsortedLogFileNames;
+
+/**
+ * Returns an array of `DDLogFileInfo` objects,
+ * each representing an existing log file on disk,
+ * and containing important information about the log file such as it's modification date and size.
+ **/
+@property (nonatomic, readonly, strong) NSArray<OSSDDLogFileInfo *> *unsortedLogFileInfos;
+
+/**
+ * Just like the `unsortedLogFilePaths` method, but sorts the array.
+ * The items in the array are sorted by creation date.
+ * The first item in the array will be the most recently created log file.
+ **/
+@property (nonatomic, readonly, strong) NSArray<NSString *> *sortedLogFilePaths;
+
+/**
+ * Just like the `unsortedLogFileNames` method, but sorts the array.
+ * The items in the array are sorted by creation date.
+ * The first item in the array will be the most recently created log file.
+ **/
+@property (nonatomic, readonly, strong) NSArray<NSString *> *sortedLogFileNames;
+
+/**
+ * Just like the `unsortedLogFileInfos` method, but sorts the array.
+ * The items in the array are sorted by creation date.
+ * The first item in the array will be the most recently created log file.
+ **/
+@property (nonatomic, readonly, strong) NSArray<OSSDDLogFileInfo *> *sortedLogFileInfos;
+
+// Private methods (only to be used by DDFileLogger)
+
+/**
+ * Generates a new unique log file path, and creates the corresponding log file.
+ **/
+- (NSString *)createNewLogFile;
+
+@optional
+
+// Notifications from DDFileLogger
+
+/**
+ *  Called when a log file was archieved
+ */
+- (void)didArchiveLogFile:(NSString *)logFilePath NS_SWIFT_NAME(didArchiveLogFile(atPath:));
+
+/**
+ *  Called when the roll action was executed and the log was archieved
+ */
+- (void)didRollAndArchiveLogFile:(NSString *)logFilePath NS_SWIFT_NAME(didRollAndArchiveLogFile(atPath:));
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * Default log file manager.
+ *
+ * All log files are placed inside the logsDirectory.
+ * If a specific logsDirectory isn't specified, the default directory is used.
+ * On Mac, this is in `~/Library/Logs/<Application Name>`.
+ * On iPhone, this is in `~/Library/Caches/Logs`.
+ *
+ * Log files are named `"<bundle identifier> <date> <time>.log"`
+ * Example: `com.organization.myapp 2013-12-03 17-14.log`
+ *
+ * Archived log files are automatically deleted according to the `maximumNumberOfLogFiles` property.
+ **/
+@interface OSSDDLogFileManagerDefault : NSObject <OSSDDLogFileManager>
+
+/**
+ *  Default initializer
+ */
+- (instancetype)init;
+
+/**
+ *  Designated initialized, requires the logs directory
+ */
+- (instancetype)initWithLogsDirectory:(NSString *)logsDirectory NS_DESIGNATED_INITIALIZER;
+
+#if TARGET_OS_IPHONE
+/*
+ * Calling this constructor you can override the default "automagically" chosen NSFileProtection level.
+ * Useful if you are writing a command line utility / CydiaSubstrate addon for iOS that has no NSBundle
+ * or like SpringBoard no BackgroundModes key in the NSBundle:
+ *    iPhone:~ root# cycript -p SpringBoard
+ *    cy# [NSBundle mainBundle]
+ *    #"NSBundle </System/Library/CoreServices/SpringBoard.app> (loaded)"
+ *    cy# [[NSBundle mainBundle] objectForInfoDictionaryKey:@"UIBackgroundModes"];
+ *    null
+ *    cy#
+ **/
+- (instancetype)initWithLogsDirectory:(NSString *)logsDirectory defaultFileProtectionLevel:(NSFileProtectionType)fileProtectionLevel;
+#endif
+
+/*
+ * Methods to override.
+ *
+ * Log files are named `"<bundle identifier> <date> <time>.log"`
+ * Example: `com.organization.myapp 2013-12-03 17-14.log`
+ *
+ * If you wish to change default filename, you can override following two methods.
+ * - `newLogFileName` method would be called on new logfile creation.
+ * - `isLogFile:` method would be called to filter logfiles from all other files in logsDirectory.
+ *   You have to parse given filename and return YES if it is logFile.
+ *
+ * **NOTE**
+ * `newLogFileName` returns filename. If appropriate file already exists, number would be added
+ * to filename before extension. You have to handle this case in isLogFile: method.
+ *
+ * Example:
+ * - newLogFileName returns `"com.organization.myapp 2013-12-03.log"`,
+ *   file `"com.organization.myapp 2013-12-03.log"` would be created.
+ * - after some time `"com.organization.myapp 2013-12-03.log"` is archived
+ * - newLogFileName again returns `"com.organization.myapp 2013-12-03.log"`,
+ *   file `"com.organization.myapp 2013-12-03 2.log"` would be created.
+ * - after some time `"com.organization.myapp 2013-12-03 1.log"` is archived
+ * - newLogFileName again returns `"com.organization.myapp 2013-12-03.log"`,
+ *   file `"com.organization.myapp 2013-12-03 3.log"` would be created.
+ **/
+
+/**
+ * Generates log file name with default format `"<bundle identifier> <date> <time>.log"`
+ * Example: `MobileSafari 2013-12-03 17-14.log`
+ *
+ * You can change it by overriding `newLogFileName` and `isLogFile:` methods.
+ **/
+@property (readonly, copy) NSString *newLogFileName;
+
+/**
+ * Default log file name is `"<bundle identifier> <date> <time>.log"`.
+ * Example: `MobileSafari 2013-12-03 17-14.log`
+ *
+ * You can change it by overriding `newLogFileName` and `isLogFile:` methods.
+ **/
+- (BOOL)isLogFile:(NSString *)fileName NS_SWIFT_NAME(isLogFile(withName:));
+
+/* Inherited from DDLogFileManager protocol:
+
+   @property (readwrite, assign, atomic) NSUInteger maximumNumberOfLogFiles;
+   @property (readwrite, assign, atomic) NSUInteger logFilesDiskQuota;
+
+   - (NSString *)logsDirectory;
+
+   - (NSArray *)unsortedLogFilePaths;
+   - (NSArray *)unsortedLogFileNames;
+   - (NSArray *)unsortedLogFileInfos;
+
+   - (NSArray *)sortedLogFilePaths;
+   - (NSArray *)sortedLogFileNames;
+   - (NSArray *)sortedLogFileInfos;
+
+ */
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * Most users will want file log messages to be prepended with the date and time.
+ * Rather than forcing the majority of users to write their own formatter,
+ * we will supply a logical default formatter.
+ * Users can easily replace this formatter with their own by invoking the `setLogFormatter:` method.
+ * It can also be removed by calling `setLogFormatter:`, and passing a nil parameter.
+ *
+ * In addition to the convenience of having a logical default formatter,
+ * it will also provide a template that makes it easy for developers to copy and change.
+ **/
+@interface OSSDDLogFileFormatterDefault : NSObject <OSSDDLogFormatter>
+
+/**
+ *  Default initializer
+ */
+- (instancetype)init;
+
+/**
+ *  Designated initializer, requires a date formatter
+ */
+- (instancetype)initWithDateFormatter:(NSDateFormatter *)dateFormatter NS_DESIGNATED_INITIALIZER;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ *  The standard implementation for a file logger
+ */
+@interface OSSDDFileLogger : OSSDDAbstractLogger <OSSDDLogger> {
+	OSSDDLogFileInfo *_currentLogFileInfo;
+}
+
+/**
+ *  Default initializer
+ */
+- (instancetype)init;
+
+/**
+ *  Designated initializer, requires a `DDLogFileManager` instance
+ */
+- (instancetype)initWithLogFileManager:(id <OSSDDLogFileManager>)logFileManager NS_DESIGNATED_INITIALIZER;
+
+/**
+ *  Called when the logger is about to write message. Call super before your implementation.
+ */
+- (void)willLogMessage NS_REQUIRES_SUPER;
+
+/**
+ *  Called when the logger wrote message. Call super after your implementation.
+ */
+- (void)didLogMessage NS_REQUIRES_SUPER;
+
+/**
+ *  Called when the logger checks archive or not current log file. 
+ *  Override this method to exdend standart behavior. By default returns NO.
+ */
+- (BOOL)shouldArchiveRecentLogFileInfo:(OSSDDLogFileInfo *)recentLogFileInfo;
+
+/**
+ * Log File Rolling:
+ *
+ * `maximumFileSize`:
+ *   The approximate maximum size (in bytes) to allow log files to grow.
+ *   If a log file is larger than this value after a log statement is appended,
+ *   then the log file is rolled.
+ *
+ * `rollingFrequency`
+ *   How often to roll the log file.
+ *   The frequency is given as an `NSTimeInterval`, which is a double that specifies the interval in seconds.
+ *   Once the log file gets to be this old, it is rolled.
+ *
+ * `doNotReuseLogFiles`
+ *   When set, will always create a new log file at application launch.
+ *
+ * Both the `maximumFileSize` and the `rollingFrequency` are used to manage rolling.
+ * Whichever occurs first will cause the log file to be rolled.
+ *
+ * For example:
+ * The `rollingFrequency` is 24 hours,
+ * but the log file surpasses the `maximumFileSize` after only 20 hours.
+ * The log file will be rolled at that 20 hour mark.
+ * A new log file will be created, and the 24 hour timer will be restarted.
+ *
+ * You may optionally disable rolling due to filesize by setting `maximumFileSize` to zero.
+ * If you do so, rolling is based solely on `rollingFrequency`.
+ *
+ * You may optionally disable rolling due to time by setting `rollingFrequency` to zero (or any non-positive number).
+ * If you do so, rolling is based solely on `maximumFileSize`.
+ *
+ * If you disable both `maximumFileSize` and `rollingFrequency`, then the log file won't ever be rolled.
+ * This is strongly discouraged.
+ **/
+@property (readwrite, assign) unsigned long long maximumFileSize;
+
+/**
+ *  See description for `maximumFileSize`
+ */
+@property (readwrite, assign) NSTimeInterval rollingFrequency;
+
+/**
+ *  See description for `maximumFileSize`
+ */
+@property (readwrite, assign, atomic) BOOL doNotReuseLogFiles;
+
+/**
+ * The DDLogFileManager instance can be used to retrieve the list of log files,
+ * and configure the maximum number of archived log files to keep.
+ *
+ * @see DDLogFileManager.maximumNumberOfLogFiles
+ **/
+@property (strong, nonatomic, readonly) id <OSSDDLogFileManager> logFileManager;
+
+/**
+ * When using a custom formatter you can set the `logMessage` method not to append
+ * `\n` character after each output. This allows for some greater flexibility with
+ * custom formatters. Default value is YES.
+ **/
+@property (nonatomic, readwrite, assign) BOOL automaticallyAppendNewlineForCustomFormatters;
+
+/**
+ *  You can optionally force the current log file to be rolled with this method.
+ *  CompletionBlock will be called on main queue.
+ */
+- (void)rollLogFileWithCompletionBlock:(void (^)(void))completionBlock NS_SWIFT_NAME(rollLogFile(withCompletion:));
+
+/**
+ *  Method is deprecated.
+ *  @deprecated Use `rollLogFileWithCompletionBlock:` method instead.
+ */
+- (void)rollLogFile __attribute((deprecated));
+
+// Inherited from DDAbstractLogger
+
+// - (id <DDLogFormatter>)logFormatter;
+// - (void)setLogFormatter:(id <DDLogFormatter>)formatter;
+
+/**
+ * Returns the log file that should be used.
+ * If there is an existing log file that is suitable,
+ * within the constraints of `maximumFileSize` and `rollingFrequency`, then it is returned.
+ *
+ * Otherwise a new file is created and returned.
+ **/
+@property (nonatomic, readonly, strong) OSSDDLogFileInfo *currentLogFileInfo;
+
+@end
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * `DDLogFileInfo` is a simple class that provides access to various file attributes.
+ * It provides good performance as it only fetches the information if requested,
+ * and it caches the information to prevent duplicate fetches.
+ *
+ * It was designed to provide quick snapshots of the current state of log files,
+ * and to help sort log files in an array.
+ *
+ * This class does not monitor the files, or update it's cached attribute values if the file changes on disk.
+ * This is not what the class was designed for.
+ *
+ * If you absolutely must get updated values,
+ * you can invoke the reset method which will clear the cache.
+ **/
+@interface OSSDDLogFileInfo : NSObject
+
+@property (strong, nonatomic, readonly) NSString *filePath;
+@property (strong, nonatomic, readonly) NSString *fileName;
+
+#if FOUNDATION_SWIFT_SDK_EPOCH_AT_LEAST(8)
+@property (strong, nonatomic, readonly) NSDictionary<NSFileAttributeKey, id> *fileAttributes;
+#else
+@property (strong, nonatomic, readonly) NSDictionary<NSString *, id> *fileAttributes;
+#endif
+
+@property (strong, nonatomic, readonly) NSDate *creationDate;
+@property (strong, nonatomic, readonly) NSDate *modificationDate;
+
+@property (nonatomic, readonly) unsigned long long fileSize;
+
+@property (nonatomic, readonly) NSTimeInterval age;
+
+@property (nonatomic, readwrite) BOOL isArchived;
+
++ (instancetype)logFileWithPath:(NSString *)filePath NS_SWIFT_UNAVAILABLE("Use init(filePath:)");
+
+- (instancetype)init NS_UNAVAILABLE;
+- (instancetype)initWithFilePath:(NSString *)filePath NS_DESIGNATED_INITIALIZER;
+
+- (void)reset;
+- (void)renameFile:(NSString *)newFileName NS_SWIFT_NAME(renameFile(to:));
+
+#if TARGET_IPHONE_SIMULATOR
+
+// So here's the situation.
+// Extended attributes are perfect for what we're trying to do here (marking files as archived).
+// This is exactly what extended attributes were designed for.
+//
+// But Apple screws us over on the simulator.
+// Everytime you build-and-go, they copy the application into a new folder on the hard drive,
+// and as part of the process they strip extended attributes from our log files.
+// Normally, a copy of a file preserves extended attributes.
+// So obviously Apple has gone to great lengths to piss us off.
+//
+// Thus we use a slightly different tactic for marking log files as archived in the simulator.
+// That way it "just works" and there's no confusion when testing.
+//
+// The difference in method names is indicative of the difference in functionality.
+// On the simulator we add an attribute by appending a filename extension.
+//
+// For example:
+// "mylog.txt" -> "mylog.archived.txt"
+// "mylog"     -> "mylog.archived"
+
+- (BOOL)hasExtensionAttributeWithName:(NSString *)attrName;
+
+- (void)addExtensionAttributeWithName:(NSString *)attrName;
+- (void)removeExtensionAttributeWithName:(NSString *)attrName;
+
+#else /* if TARGET_IPHONE_SIMULATOR */
+
+// Normal use of extended attributes used everywhere else,
+// such as on Macs and on iPhone devices.
+
+- (BOOL)hasExtendedAttributeWithName:(NSString *)attrName;
+
+- (void)addExtendedAttributeWithName:(NSString *)attrName;
+- (void)removeExtendedAttributeWithName:(NSString *)attrName;
+
+#endif /* if TARGET_IPHONE_SIMULATOR */
+
+@end

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSGetObjectACLRequest.h

@@ -0,0 +1,26 @@
+//
+//  OSSGetObjectACLRequest.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/26.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import "OSSRequest.h"
+
+NS_ASSUME_NONNULL_BEGIN
+@interface OSSGetObjectACLRequest : OSSRequest
+
+/**
+ the bucket's name which object stored
+ */
+@property (nonatomic, copy) NSString *bucketName;
+
+/**
+ the name of object
+ */
+@property (nonatomic, copy) NSString *objectName;
+
+
+@end
+NS_ASSUME_NONNULL_END

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSGetObjectACLResult.h

@@ -0,0 +1,19 @@
+//
+//  OSSGetObjectACLResult.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/26.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import "OSSResult.h"
+
+@interface OSSGetObjectACLResult : OSSResult
+
+/**
+ the ACL of object,valid values: @"private",@"public-read",@"public-read-write".
+ if object's ACL inherit from bucket,it will return @"default".
+ */
+@property (nonatomic, copy) NSString *grant;
+
+@end

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSHttpResponseParser.h

@@ -0,0 +1,39 @@
+//
+//  OSSHttpResponseParser.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/22.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "OSSConstants.h"
+#import "OSSTask.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ HTTP response parser
+ */
+@interface OSSHttpResponseParser : NSObject
+
+@property (nonatomic, copy) OSSNetworkingOnRecieveDataBlock onRecieveBlock;
+
+@property (nonatomic, strong) NSURL *downloadingFileURL;
+
+/**
+ *  A Boolean value that determines whether verfifying crc64.
+ When set to YES, it will verify crc64 when transmission is completed normally.
+ The default value of this property is NO.
+ */
+@property (nonatomic, assign) BOOL crc64Verifiable;
+
+- (instancetype)initForOperationType:(OSSOperationType)operationType;
+- (void)consumeHttpResponse:(NSHTTPURLResponse *)response;
+- (OSSTask *)consumeHttpResponseBody:(NSData *)data;
+- (nullable id)constructResultObject;
+- (void)reset;
+
+@end
+
+NS_ASSUME_NONNULL_END

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSHttpdns.h

@@ -0,0 +1,16 @@
+//
+//  OSSHttpdns.h
+//  AliyunOSSiOS
+//
+//  Created by zhouzhuo on 5/1/16.
+//  Copyright © 2016 zhouzhuo. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+@interface OSSHttpdns : NSObject
+
++ (instancetype)sharedInstance;
+
+- (NSString *)asynGetIpByHost:(NSString *)host;
+@end

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSIPv6Adapter.h

@@ -0,0 +1,113 @@
+/*
+ * Copyright (c) 2000-2015 Apple Inc. All rights reserved.
+ *
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
+ *
+ * This file contains Original Code and/or Modifications of Original Code
+ * as defined in and that are subject to the Apple Public Source License
+ * Version 2.0 (the 'License'). You may not use this file except in
+ * compliance with the License. The rights granted to you under the License
+ * may not be used to create, or enable the creation or redistribution of,
+ * unlawful or unlicensed copies of an Apple operating system, or to
+ * circumvent, violate, or enable the circumvention or violation of, any
+ * terms of an Apple operating system software license agreement.
+ *
+ * Please obtain a copy of the License at
+ * https://www.opensource.apple.com/apsl/ and read it before using this file.
+ *
+ * The Original Code and all software distributed under the License are
+ * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
+ * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
+ * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
+ * Please see the License for the specific language governing rights and
+ * limitations under the License.
+ *
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
+ */
+/*
+ * Copyright (c) 1980, 1986, 1993
+ *	The Regents of the University of California.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ * 3. All advertising materials mentioning features or use of this software
+ *    must display the following acknowledgement:
+ *	This product includes software developed by the University of
+ *	California, Berkeley and its contributors.
+ * 4. Neither the name of the University nor the names of its contributors
+ *    may be used to endorse or promote products derived from this software
+ *    without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ *
+ *	@(#)route.h	8.3 (Berkeley) 4/19/94
+ * $FreeBSD: src/sys/net/route.h,v 1.36.2.1 2000/08/16 06:14:23 jayanth Exp $
+ */
+
+
+#ifndef AlicloudIPv6Adapter_h
+#define AlicloudIPv6Adapter_h
+#import <Foundation/Foundation.h>
+
+@interface OSSIPv6Adapter : NSObject
+
++ (instancetype)getInstance;
+
+/**
+ *	@brief	Checks if it's a IPv6-only network. If it's true, it's IPv6-only.
+ *
+ *	@return return YES for IPv6-only network,otherWise return NO
+ */
+- (BOOL)isIPv6OnlyNetwork;
+
+/**
+ *	@brief	Refresh the IPV6-only check
+ *
+ *	@return return YES for IPv6-only network,otherWise return NO
+ */
+- (BOOL)reResolveIPv6OnlyStatus;
+
+/**
+ *	@brief	Adapts the IPv4 address into IPv6 format under IPv6-only network.
+ *          For example:
+                42.156.220.114 -> 64:ff9b::2a9c:dc72
+ *	@param 	addr
+ *
+ *	@return return an IPv6 address
+ */
+- (NSString *)handleIpv4Address:(NSString *)addr;
+
+/**
+ *	@brief	Checks if it's an IPv4 address.
+ *
+ *	@return return YES while addr is an IPv4 address,otherwise return NO
+ */
+- (BOOL)isIPv4Address:(NSString *)addr;
+
+/**
+ *	@brief	Checks if it's an IPv6 address
+ *
+ *	@return return YES while addr is an IPv6 address,otherwise return NO
+ */
+- (BOOL)isIPv6Address:(NSString *)addr;
+
+@end
+
+#endif /* OSSIPv6Adapter_h */

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSIPv6PrefixResolver.h

@@ -0,0 +1,23 @@
+//
+//  OSSIPv6PrefixResolver.h
+//
+//  Created by lingkun on 16/5/16.
+//  Edit by zhouzhuo on 16/5/22
+//  Copyright © 2016 Ali. All rights reserved.
+//
+
+#ifndef AlicloudIPv6PrefixResolver_h
+#define AlicloudIPv6PrefixResolver_h
+#import <Foundation/Foundation.h>
+
+@interface OSSIPv6PrefixResolver : NSObject
+
++ (instancetype)getInstance;
+
+- (void)updateIPv6Prefix;
+
+- (NSString *)convertIPv4toIPv6:(NSString *)ipv4;
+
+@end
+
+#endif /* OSSIPv6PrefixResolver_h */

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSLog.h

@@ -7,6 +7,8 @@
 //
 
 #import <Foundation/Foundation.h>
+#import "OSSCocoaLumberjack.h"
+static const OSSDDLogLevel ossLogLevel = OSSDDLogLevelAll;
 
 // colorful log configuration
 // see https://github.com/robbiehanson/XcodeColors
@@ -19,21 +21,33 @@
 
 #define OSSLogVerbose(frmt, ...)\
 if ([OSSLog isLogEnable]) {\
-NSLog(@"[Verbose]: %@", [NSString stringWithFormat:(frmt), ##__VA_ARGS__]);\
+OSSDDLogVerbose(@"[Verbose]: %@", [NSString stringWithFormat:(frmt), ##__VA_ARGS__]);\
 }
 
 #define OSSLogDebug(frmt, ...)\
 if ([OSSLog isLogEnable]) {\
+OSSDDLogDebug(@"[Debug]: %@", [NSString stringWithFormat:(frmt), ##__VA_ARGS__]);\
+}
+
+#define OSSLogDebugNoFile(frmt, ...)\
+if ([OSSLog isLogEnable]) {\
 NSLog(@"[Debug]: %@", [NSString stringWithFormat:(frmt), ##__VA_ARGS__]);\
 }
 
 #define OSSLogError(frmt, ...)\
 if ([OSSLog isLogEnable]) {\
-NSLog(@"[Error]: %@", [NSString stringWithFormat:(frmt), ##__VA_ARGS__]);\
+OSSDDLogError(@"[Error]: %@", [NSString stringWithFormat:(frmt), ##__VA_ARGS__]);\
+}
+
+#define OSSLogWarn(frmt, ...)\
+if ([OSSLog isLogEnable]) {\
+OSSDDLogWarn(@"[Warning]: %@", [NSString stringWithFormat:(frmt), ##__VA_ARGS__]);\
 }
+
 static BOOL isEnable;
 
 @interface OSSLog : NSObject
+
 + (void)enableLog;
 + (void)disableLog;
 + (BOOL)isLogEnable;

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSLogMacros.h

@@ -0,0 +1,82 @@
+// Software License Agreement (BSD License)
+//
+// Copyright (c) 2010-2016, Deusty, LLC
+// All rights reserved.
+//
+// Redistribution and use of this software in source and binary forms,
+// with or without modification, are permitted provided that the following conditions are met:
+//
+// * Redistributions of source code must retain the above copyright notice,
+//   this list of conditions and the following disclaimer.
+//
+// * Neither the name of Deusty nor the names of its contributors may be used
+//   to endorse or promote products derived from this software without specific
+//   prior written permission of Deusty, LLC.
+
+// Disable legacy macros
+#ifndef OSSDD_LEGACY_MACROS
+    #define OSSDD_LEGACY_MACROS 0
+#endif
+
+#import "OSSDDLog.h"
+
+/**
+ * The constant/variable/method responsible for controlling the current log level.
+ **/
+#ifndef OSSLOG_LEVEL_DEF
+    #define OSSLOG_LEVEL_DEF ossLogLevel
+#endif
+
+/**
+ * Whether async should be used by log messages, excluding error messages that are always sent sync.
+ **/
+#ifndef OSSLOG_ASYNC_ENABLED
+    #define OSSLOG_ASYNC_ENABLED YES
+#endif
+
+/**
+ * These are the two macros that all other macros below compile into.
+ * These big multiline macros makes all the other macros easier to read.
+ **/
+#define OSSLOG_MACRO(isAsynchronous, lvl, flg, ctx, atag, fnct, frmt, ...) \
+        [OSSDDLog log : isAsynchronous                                     \
+             level : lvl                                                \
+              flag : flg                                                \
+           context : ctx                                                \
+              file : __FILE__                                           \
+          function : fnct                                               \
+              line : __LINE__                                           \
+               tag : atag                                               \
+            format : (frmt), ## __VA_ARGS__]
+
+/**
+ * Define version of the macro that only execute if the log level is above the threshold.
+ * The compiled versions essentially look like this:
+ *
+ * if (logFlagForThisLogMsg & ddLogLevel) { execute log message }
+ *
+ * When LOG_LEVEL_DEF is defined as ddLogLevel.
+ *
+ * As shown further below, Lumberjack actually uses a bitmask as opposed to primitive log levels.
+ * This allows for a great amount of flexibility and some pretty advanced fine grained logging techniques.
+ *
+ * Note that when compiler optimizations are enabled (as they are for your release builds),
+ * the log messages above your logging threshold will automatically be compiled out.
+ *
+ * (If the compiler sees LOG_LEVEL_DEF/ddLogLevel declared as a constant, the compiler simply checks to see
+ *  if the 'if' statement would execute, and if not it strips it from the binary.)
+ *
+ * We also define shorthand versions for asynchronous and synchronous logging.
+ **/
+#define OSSLOG_MAYBE(async, lvl, flg, ctx, tag, fnct, frmt, ...) \
+        do { if(lvl & flg) OSSLOG_MACRO(async, lvl, flg, ctx, tag, fnct, frmt, ##__VA_ARGS__); } while(0)
+
+/**
+ * Ready to use log macros with no context or tag.
+ **/
+#define OSSDDLogError(frmt, ...)   OSSLOG_MAYBE(NO,                OSSLOG_LEVEL_DEF, OSSDDLogFlagError,   0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
+#define OSSDDLogWarn(frmt, ...)    OSSLOG_MAYBE(OSSLOG_ASYNC_ENABLED, OSSLOG_LEVEL_DEF, OSSDDLogFlagWarning, 0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
+#define OSSDDLogInfo(frmt, ...)    OSSLOG_MAYBE(OSSLOG_ASYNC_ENABLED, OSSLOG_LEVEL_DEF, OSSDDLogFlagInfo,    0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
+#define OSSDDLogDebug(frmt, ...)   OSSLOG_MAYBE(OSSLOG_ASYNC_ENABLED, OSSLOG_LEVEL_DEF, OSSDDLogFlagDebug,   0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
+#define OSSDDLogVerbose(frmt, ...) OSSLOG_MAYBE(OSSLOG_ASYNC_ENABLED, OSSLOG_LEVEL_DEF, OSSDDLogFlagVerbose, 0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
+

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSNSLogger.h

@@ -0,0 +1,14 @@
+//
+//  OSSNSLogger.h
+//  AliyunOSSiOS
+//
+//  Created by jingdan on 2017/10/24.
+//  Copyright © 2017年 zhouzhuo. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "OSSDDLog.h"
+
+@interface OSSNSLogger : OSSDDAbstractLogger <OSSDDLogger>
+@property (class, readonly, strong) OSSNSLogger *sharedInstance;
+@end

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSNetworking.h

@@ -13,36 +13,10 @@
 @class OSSNetworkingRequestDelegate;
 @class OSSExecutor;
 
-/**
- 定义重试类型
- */
-typedef NS_ENUM(NSInteger, OSSNetworkingRetryType) {
-    OSSNetworkingRetryTypeUnknown,
-    OSSNetworkingRetryTypeShouldRetry,
-    OSSNetworkingRetryTypeShouldNotRetry,
-    OSSNetworkingRetryTypeShouldRefreshCredentialsAndRetry,
-    OSSNetworkingRetryTypeShouldCorrectClockSkewAndRetry
-};
-
-/**
- 重试处理器
- */
-@interface OSSURLRequestRetryHandler : NSObject
-@property (nonatomic, assign) uint32_t maxRetryCount;
 
-- (OSSNetworkingRetryType)shouldRetry:(uint32_t)currentRetryCount
-                      requestDelegate:(OSSNetworkingRequestDelegate *)delegate
-                             response:(NSHTTPURLResponse *)response
-                                error:(NSError *)error;
-
-- (NSTimeInterval)timeIntervalForRetry:(uint32_t)currentRetryCount
-                             retryType:(OSSNetworkingRetryType)retryType;
-
-+ (instancetype)defaultRetryHandler;
-@end
 
 /**
- 网络参数设置
+ Network parameters
  */
 @interface OSSNetworkingConfiguration : NSObject
 @property (nonatomic, assign) uint32_t maxRetryCount;
@@ -55,82 +29,11 @@ typedef NS_ENUM(NSInteger, OSSNetworkingRetryType) {
 @property (nonatomic, strong) NSNumber * proxyPort;
 @end
 
-/**
- 对操作发起的每一次请求构造一个信息代理
- */
-@interface OSSNetworkingRequestDelegate : NSObject
-
-@property (nonatomic, strong) NSMutableArray * interceptors;
-@property (nonatomic, strong) OSSAllRequestNeededMessage * allNeededMessage;
-@property (nonatomic, strong) NSMutableURLRequest * internalRequest;
-@property (nonatomic, assign) OSSOperationType operType;
-@property (nonatomic, assign) BOOL isAccessViaProxy;
-
-@property (nonatomic, assign) BOOL isRequestCancelled;
-
-@property (nonatomic, strong) OSSHttpResponseParser * responseParser;
-
-@property (nonatomic, strong) NSData * uploadingData;
-@property (nonatomic, strong) NSURL * uploadingFileURL;
-
-@property (nonatomic, assign) int64_t payloadTotalBytesWritten;
-
-@property (nonatomic, assign) BOOL isBackgroundUploadFileTask;
-@property (nonatomic, assign) BOOL isHttpdnsEnable;
-
-@property (nonatomic, strong) OSSURLRequestRetryHandler * retryHandler;
-@property (nonatomic, assign) uint32_t currentRetryCount;
-@property (nonatomic, strong) NSError * error;
-@property (nonatomic, assign) BOOL isHttpRequestNotSuccessResponse;
-@property (nonatomic, strong) NSMutableData * httpRequestNotSuccessResponseBody;
-
-@property (atomic, strong) NSURLSessionDataTask * currentSessionTask;
-
-@property (nonatomic, copy) OSSNetworkingUploadProgressBlock uploadProgress;
-@property (nonatomic, copy) OSSNetworkingDownloadProgressBlock downloadProgress;
-@property (nonatomic, copy) OSSNetworkingCompletionHandlerBlock completionHandler;
-@property (nonatomic, copy) OSSNetworkingOnRecieveDataBlock onRecieveData;
-
-- (OSSTask *)buildInternalHttpRequest;
-- (void)reset;
-- (void)cancel;
-@end
-
-/**
- 包含一次网络请求所需的所有信息
- */
-@interface OSSAllRequestNeededMessage : NSObject
-@property (nonatomic, strong) NSString * endpoint;
-@property (nonatomic, strong) NSString * httpMethod;
-@property (nonatomic, strong) NSString * bucketName;
-@property (nonatomic, strong) NSString * objectKey;
-@property (nonatomic, strong) NSString * contentType;
-@property (nonatomic, strong) NSString * contentMd5;
-@property (nonatomic, strong) NSString * range;
-@property (nonatomic, strong) NSString * date;
-@property (nonatomic, strong) NSMutableDictionary * headerParams;
-@property (nonatomic, strong) NSMutableDictionary * querys;
-
-@property (nonatomic, assign) BOOL isHostInCnameExcludeList;
-
-- (instancetype)initWithEndpoint:(NSString *)endpoint
-                      httpMethod:(NSString *)httpMethod
-                      bucketName:(NSString *)bucketName
-                       objectKey:(NSString *)objectKey
-                            type:(NSString *)contentType
-                             md5:(NSString *)contentMd5
-                           range:(NSString *)range
-                            date:(NSString *)date
-                    headerParams:(NSMutableDictionary *)headerParams
-                          querys:(NSMutableDictionary *)querys;
-
-- (OSSTask *)validateRequestParamsInOperationType:(OSSOperationType)operType;
-@end
 
 /**
- 每个OSSClient持有一个OSSNetworking用以收发网络请求
+ The network interface which OSSClient uses for network read and write operations.
  */
-@interface OSSNetworking : NSObject <NSURLSessionDelegate>
+@interface OSSNetworking : NSObject <NSURLSessionDelegate, NSURLSessionDataDelegate>
 @property (nonatomic, strong) NSURLSession * dataSession;
 @property (nonatomic, strong) NSURLSession * uploadFileSession;
 @property (nonatomic, assign) BOOL isUsingBackgroundSession;

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSNetworkingRequestDelegate.h

@@ -0,0 +1,76 @@
+//
+//  OSSNetworkingRequestDelegate.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/22.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "OSSConstants.h"
+#import "OSSTask.h"
+
+@class OSSAllRequestNeededMessage;
+@class OSSURLRequestRetryHandler;
+@class OSSHttpResponseParser;
+
+/**
+ The proxy object class for each OSS request.
+ */
+@interface OSSNetworkingRequestDelegate : NSObject
+
+@property (nonatomic, strong) NSMutableArray * interceptors;
+
+@property (nonatomic, strong) NSMutableURLRequest *internalRequest;
+@property (nonatomic, assign) OSSOperationType operType;
+@property (nonatomic, assign) BOOL isAccessViaProxy;
+
+@property (nonatomic, assign) BOOL isRequestCancelled;
+
+@property (nonatomic, strong) OSSAllRequestNeededMessage *allNeededMessage;
+@property (nonatomic, strong) OSSURLRequestRetryHandler *retryHandler;
+@property (nonatomic, strong) OSSHttpResponseParser *responseParser;
+
+@property (nonatomic, strong) NSData * uploadingData;
+@property (nonatomic, strong) NSURL * uploadingFileURL;
+
+@property (nonatomic, assign) int64_t payloadTotalBytesWritten;
+
+@property (nonatomic, assign) BOOL isBackgroundUploadFileTask;
+@property (nonatomic, assign) BOOL isHttpdnsEnable;
+
+
+@property (nonatomic, assign) uint32_t currentRetryCount;
+@property (nonatomic, strong) NSError * error;
+@property (nonatomic, assign) BOOL isHttpRequestNotSuccessResponse;
+@property (nonatomic, strong) NSMutableData *httpRequestNotSuccessResponseBody;
+
+@property (atomic, strong) NSURLSessionDataTask *currentSessionTask;
+
+@property (nonatomic, copy) OSSNetworkingUploadProgressBlock uploadProgress;
+@property (nonatomic, copy) OSSNetworkingDownloadProgressBlock downloadProgress;
+@property (nonatomic, copy) OSSNetworkingRetryBlock retryCallback;
+@property (nonatomic, copy) OSSNetworkingCompletionHandlerBlock completionHandler;
+@property (nonatomic, copy) OSSNetworkingOnRecieveDataBlock onRecieveData;
+
+/**
+ * when put object to server,client caculate crc64 code and assigns it to
+ * this property.
+ */
+@property (nonatomic, copy) NSString *contentCRC;
+
+/** last crc64 code */
+@property (nonatomic, copy) NSString *lastCRC;
+
+/**
+ * determine whether to verify crc64 code
+ */
+@property (nonatomic, assign) BOOL crc64Verifiable;
+
+
+
+- (OSSTask *)buildInternalHttpRequest;
+- (void)reset;
+- (void)cancel;
+
+@end

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSReachability.h

@@ -0,0 +1,64 @@
+/*
+ Copyright (C) 2016 Apple Inc. All Rights Reserved.
+ See LICENSE.txt for this sample’s licensing information
+ 
+ Abstract:
+ Basic demonstration of how to use the SystemConfiguration Reachablity APIs.
+ */
+
+#import <Foundation/Foundation.h>
+#import <SystemConfiguration/SystemConfiguration.h>
+#import <netinet/in.h>
+
+
+typedef enum : NSInteger {
+	OSSNotReachable = 0,
+	OSSReachableViaWiFi,
+	OSSReachableViaWWAN
+} OSSNetworkStatus;
+
+#pragma mark IPv6 Support
+//Reachability fully support IPv6.  For full details, see ReadMe.md.
+
+
+extern NSString *ossReachabilityChangedNotification;
+
+
+@interface OSSReachability : NSObject
+
+/*!
+ * Use to check the reachability of a given host name.
+ */
++ (instancetype)reachabilityWithHostName:(NSString *)hostName;
+
+/*!
+ * Use to check the reachability of a given IP address.
+ */
++ (instancetype)reachabilityWithAddress:(const struct sockaddr *)hostAddress;
+
+/*!
+ * Checks whether the default route is available. Should be used by applications that do not connect to a particular host.
+ */
++ (instancetype)reachabilityForInternetConnection;
+
+
+#pragma mark reachabilityForLocalWiFi
+//reachabilityForLocalWiFi has been removed from the sample.  See ReadMe.md for more information.
+//+ (instancetype)reachabilityForLocalWiFi;
+
+/*!
+ * Start listening for reachability notifications on the current run loop.
+ */
+- (BOOL)startNotifier;
+- (void)stopNotifier;
+
+- (OSSNetworkStatus)currentReachabilityStatus;
+
+/*!
+ * WWAN may be available, but not active until a connection has been established. WiFi may require a connection for VPN on Demand.
+ */
+- (BOOL)connectionRequired;
+
+@end
+
+

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSReachabilityManager.h

@@ -0,0 +1,15 @@
+//
+//  OSSReachabilityManager.h
+//
+//  Created by 亿刀 on 14-1-9.
+//  Edited by junmo on 15-5-16
+//  Copyright (c) 2014 Twitter. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+@interface OSSReachabilityManager : NSObject
+
++ (OSSReachabilityManager *)shareInstance;
+
+@end

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSRequest.h

@@ -0,0 +1,36 @@
+//
+//  OSSRequest.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/22.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "OSSConstants.h"
+
+/**
+ The base class of request to OSS.
+ */
+@interface OSSRequest : NSObject
+/**
+ Flag of requiring authentication. It's per each request.
+ */
+@property (nonatomic, assign) BOOL isAuthenticationRequired;
+
+/**
+ the flag of request canceled.
+ */
+@property (nonatomic, assign) BOOL isCancelled;
+
+/**
+ the flag of verification about crc64
+ */
+@property (nonatomic, assign) OSSRequestCRCFlag crcFlag;
+
+/**
+ Cancels the request
+ */
+- (void)cancel;
+
+@end

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSResult.h

@@ -0,0 +1,42 @@
+//
+//  OSSResult.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/26.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+/**
+ The base class of result from OSS.
+ */
+@interface OSSResult : NSObject
+
+/**
+ The http response code.
+ */
+@property (nonatomic, assign) NSInteger httpResponseCode;
+
+/**
+ The http headers, in the form of key value dictionary.
+ */
+@property (nonatomic, strong) NSDictionary * httpResponseHeaderFields;
+
+/**
+ The request Id. It's the value of header x-oss-request-id, which is created from OSS server.
+ It's a unique Id represents this request. This is used for troubleshooting when you contact OSS support.
+ */
+@property (nonatomic, strong) NSString * requestId;
+
+/**
+ It's the value of header x-oss-hash-crc64ecma, which is created from OSS server.
+ */
+@property (nonatomic, copy) NSString *remoteCRC64ecma;
+
+/**
+ It's the value of local Data.
+ */
+@property (nonatomic, copy) NSString *localCRC64ecma;
+
+@end

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSService.h

@@ -11,7 +11,19 @@
 #define OSS_IOS_SDK_VERSION OSSSDKVersion
 
 #import "OSSDefine.h"
+#import "OSSConstants.h"
+
 #import "OSSNetworking.h"
+#import "OSSNetworkingRequestDelegate.h"
+#import "OSSAllRequestNeededMessage.h"
+#import "OSSURLRequestRetryHandler.h"
+#import "OSSHttpResponseParser.h"
+#import "OSSRequest.h"
+#import "OSSGetObjectACLRequest.h"
+#import "OSSGetObjectACLResult.h"
+#import "OSSDeleteMultipleObjectsRequest.h"
+#import "OSSDeleteMultipleObjectsResult.h"
+
 #import "OSSClient.h"
 #import "OSSModel.h"
 #import "OSSUtil.h"

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSTask.h

@@ -60,7 +60,7 @@ typedef __nullable id(^OSSContinuationBlock)(OSSTask<ResultType> *task);
  Creates a task that is already completed with the given result.
  @param result The result for the task.
  */
-+ (instancetype)taskWithResult:(nullable ResultType)result;
++ (instancetype)taskWithResult:(_Nullable ResultType)result;
 
 /*!
  Creates a task that is already completed with the given error.
@@ -127,7 +127,7 @@ typedef __nullable id(^OSSContinuationBlock)(OSSTask<ResultType> *task);
  If block returns a OSSTask, then the task returned from
  this method will not be completed until that task is completed.
  */
-+ (instancetype)taskFromExecutor:(OSSExecutor *)executor withBlock:(nullable id (^)())block;
++ (instancetype)taskFromExecutor:(OSSExecutor *)executor withBlock:(nullable id (^)(void))block;
 
 // Properties that will be set on the task once it is completed.
 

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSURLRequestRetryHandler.h

@@ -0,0 +1,36 @@
+//
+//  OSSURLRequestRetryHandler.h
+//  AliyunOSSSDK
+//
+//  Created by huaixu on 2018/1/22.
+//  Copyright © 2018年 aliyun. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "OSSConstants.h"
+
+@class OSSNetworkingRequestDelegate;
+
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ The retry handler interface
+ */
+@interface OSSURLRequestRetryHandler : NSObject
+
+@property (nonatomic, assign) uint32_t maxRetryCount;
+
+
++ (instancetype)defaultRetryHandler;
+
+- (OSSNetworkingRetryType)shouldRetry:(uint32_t)currentRetryCount
+                      requestDelegate:(OSSNetworkingRequestDelegate *)delegate
+                             response:(NSHTTPURLResponse *)response
+                                error:(NSError *)error;
+
+- (NSTimeInterval)timeIntervalForRetry:(uint32_t)currentRetryCount
+                             retryType:(OSSNetworkingRetryType)retryType;
+@end
+
+NS_ASSUME_NONNULL_END

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSUtil.h

@@ -7,6 +7,7 @@
 //
 
 #import <Foundation/Foundation.h>
+#import "OSSFileLogger.h"
 
 @class OSSFederationToken;
 
@@ -16,22 +17,55 @@
 + (NSString *)calBase64WithData:(uint8_t *)data;
 + (NSString *)encodeURL:(NSString *)url;
 + (NSData *)constructHttpBodyFromPartInfos:(NSArray *)partInfos;
-+ (NSData *)constructHttpBodyForCreateBucketWithLocation:(NSString *)location;
++ (NSData *)constructHttpBodyForDeleteMultipleObjects:(NSArray<NSString *> *)keys quiet:(BOOL)quiet;
++ (NSData *)constructHttpBodyForCreateBucketWithLocation:(NSString *)location __attribute__((deprecated("deprecated!")));
 + (BOOL)validateBucketName:(NSString *)bucketName;
 + (BOOL)validateObjectKey:(NSString *)objectKey;
 + (BOOL)isOssOriginBucketHost:(NSString *)host;
 + (NSString *)getIpByHost:(NSString *)host;
 + (BOOL)isNetworkDelegateState;
+
++ (NSData *)fileMD5:(NSString *)path;
 + (NSString *)dataMD5String:(NSData *)data;
 + (NSString *)fileMD5String:(NSString *)path;
-+ (NSString*)base64ForData:(uint8_t *)input length:(int32_t)length;
 + (NSString *)base64Md5ForData:(NSData *)data;
 + (NSString *)base64Md5ForFilePath:(NSString *)filePath;
 + (NSString *)base64Md5ForFileURL:(NSURL *)fileURL;
++ (NSString *)base64ForData:(uint8_t *)input length:(int32_t)length;
+
 + (NSString *)populateSubresourceStringFromParameter:(NSDictionary *)parameters;
 + (NSString *)populateQueryStringFromParameter:(NSDictionary *)parameters;
 + (BOOL)isSubresource:(NSString *)param;
 + (NSString *)sign:(NSString *)content withToken:(OSSFederationToken *)token;
 + (NSString *)getRelativePath:(NSString *)fullPath;
 + (NSString *)detemineMimeTypeForFilePath:(NSString *)filePath uploadName:(NSString *)uploadName;
++ (BOOL)hasPhoneFreeSpace;
++ (NSString*)buildNetWorkConnectedMsg;
++ (NSString*)buildOperatorMsg;
+
++ (uint64_t)crc64ecma:(uint64_t)crc1 buffer:(void *)buffer length:(size_t)len;
+
+/**
+ * @brief: combine crc1 and crc2
+ */
+
++ (uint64_t)crc64ForCombineCRC1:(uint64_t)crc1 CRC2:(uint64_t)crc2 length:(size_t)len2;
+
++ (NSString *)sha1WithString:(NSString *)string;
++ (NSString *)sha1WithData:(NSData *)data;
++ (NSString *)sha1WithFilePath:(NSString *)filePath;
+
++ (NSData *)constructHttpBodyForTriggerCallback:(NSString *)callbackParams callbackVaribles:(NSString *)callbackVaribles;
+
++ (NSData *)constructHttpBodyForImagePersist:(NSString *)action toBucket:(NSString *)toBucket toObjectKey:(NSString *)toObjectKey;
+
+@end
+
+@interface NSString (OSS)
+
+- (NSString *)oss_trim;
+- (BOOL)oss_isNotEmpty;
+- (NSString *)oss_stringByAppendingPathComponentForURL:(NSString *)path;
++ (NSString *)oss_documentDirectory;
+
 @end

ios/AliyunSDK/AliyunOSSiOS.framework/Headers/OSSXMLDictionary.h

@@ -0,0 +1,88 @@
+//
+//  XMLDictionary.h
+//
+//  Version 1.4
+//
+//  Created by Nick Lockwood on 15/11/2010.
+//  Copyright 2010 Charcoal Design. All rights reserved.
+//
+//  Get the latest version of XMLDictionary from here:
+//
+//  https://github.com/nicklockwood/XMLDictionary
+//
+//  This software is provided 'as-is', without any express or implied
+//  warranty.  In no event will the authors be held liable for any damages
+//  arising from the use of this software.
+//
+//  Permission is granted to anyone to use this software for any purpose,
+//  including commercial applications, and to alter it and redistribute it
+//  freely, subject to the following restrictions:
+//
+//  1. The origin of this software must not be misrepresented; you must not
+//  claim that you wrote the original software. If you use this software
+//  in a product, an acknowledgment in the product documentation would be
+//  appreciated but is not required.
+//
+//  2. Altered source versions must be plainly marked as such, and must not be
+//  misrepresented as being the original software.
+//
+//  3. This notice may not be removed or altered from any source distribution.
+//
+
+#import <Foundation/Foundation.h>
+#import "OSSConstants.h"
+
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wobjc-missing-property-synthesis"
+@interface OSSXMLDictionaryParser : NSObject <NSCopying>
+
++ (OSSXMLDictionaryParser *)sharedInstance;
+
+@property (nonatomic, assign) BOOL collapseTextNodes; // defaults to YES
+@property (nonatomic, assign) BOOL stripEmptyNodes;   // defaults to YES
+@property (nonatomic, assign) BOOL trimWhiteSpace;    // defaults to YES
+@property (nonatomic, assign) BOOL alwaysUseArrays;   // defaults to NO
+@property (nonatomic, assign) BOOL preserveComments;  // defaults to NO
+@property (nonatomic, assign) BOOL wrapRootNode;      // defaults to NO
+
+@property (nonatomic, assign) OSSXMLDictionaryAttributesMode attributesMode;
+@property (nonatomic, assign) OSSXMLDictionaryNodeNameMode nodeNameMode;
+
+- (NSDictionary *)dictionaryWithParser:(NSXMLParser *)parser;
+- (NSDictionary *)dictionaryWithData:(NSData *)data;
+- (NSDictionary *)dictionaryWithString:(NSString *)string;
+- (NSDictionary *)dictionaryWithFile:(NSString *)path;
+
+@end
+
+
+@interface NSDictionary (OSSXMLDictionary)
+
++ (NSDictionary *)oss_dictionaryWithXMLParser:(NSXMLParser *)parser;
++ (NSDictionary *)oss_dictionaryWithXMLData:(NSData *)data;
++ (NSDictionary *)oss_dictionaryWithXMLString:(NSString *)string;
++ (NSDictionary *)oss_dictionaryWithXMLFile:(NSString *)path;
+
+- (NSDictionary *)oss_attributes;
+- (NSDictionary *)oss_childNodes;
+- (NSArray *)oss_comments;
+- (NSString *)oss_nodeName;
+- (NSString *)oss_innerText;
+- (NSString *)oss_innerXML;
+- (NSString *)oss_XMLString;
+
+- (NSArray *)oss_arrayValueForKeyPath:(NSString *)keyPath;
+- (NSString *)oss_stringValueForKeyPath:(NSString *)keyPath;
+- (NSDictionary *)oss_dictionaryValueForKeyPath:(NSString *)keyPath;
+
+@end
+
+
+@interface NSString (OSSXMLDictionary)
+
+- (NSString *)oss_XMLEncodedString;
+
+@end
+
+
+#pragma GCC diagnostic pop

ios/AliyunSDK/AliyunOSSiOS.framework/PrivateHeaders/aos_crc64.h

@@ -0,0 +1,11 @@
+#ifndef LIBAOS_CRC_H
+#define LIBAOS_CRC_H
+
+#include <_types/_uintmax_t.h>
+#include <_types/_uint64_t.h>
+#include <stddef.h>
+
+uint64_t aos_crc64(uint64_t crc, void *buf, size_t len);
+uint64_t aos_crc64_combine(uint64_t crc1, uint64_t crc2, uintmax_t len2);
+
+#endif

package.json

@@ -1,6 +1,6 @@
 {
   "name": "aliyun-oss-react-native",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.5",
   "description": "React Native SDK for aliyun object storage service",
   "main": "index.js",
   "scripts": {