Objective-C SDK

pod "Qiniu", "~> 8.9.0"

App 对接:
File -> Swift Packages -> Add Package Dependency，输入库链接，选择相应版本即可。
库链接: https://github.com/qiniu/objc-sdk

库对接:
let package = Package(
    dependencies: [
        .package(url: "https://github.com/qiniu/objc-sdk", from: "8.9.0")
    ],
    // ...
)

库引入方式：
import QiniuSDK

// Upload_Domain1, Upload_Domain2 为服务下发的上传域名
QNFixedZone *fixedZone = [[QNFixedZone alloc] initWithUpDomainList:@[@"Upload_Domain1", @"Upload_Domain2"]];
QNConfiguration *config = [QNConfiguration buildV2:^(QNConfigurationBuilder *builder) {
    builder.zone = fixedZone;
}];
QNUploadManager *manager = [[QNUploadManager alloc] initWithConfiguration:config];

// 指定上传区域为 华东-浙江
QNFixedZone *zone = [QNFixedZone createWithRegionId:@"z0"];

// Upload_Domain1, Upload_Domain2 为服务下发的上传域名
QNFixedZone *fixedZone = [[QNFixedZone alloc] initWithUpDomainList:@[@"Upload_Domain1", @"Upload_Domain2"]];

// 不指定 uc 域名，使用七牛公有云默认域名
QNAutoZone *zone = [[QNAutoZone alloc] init];

// 指定 uc 域名，公有云无需指定
QNAutoZone *zone = [QNAutoZone zoneWithUcHosts:@[@"UCHost0", @"UCHost1"]];

#import <QiniuSDK.h>

QNConfiguration *configuration = [QNConfiguration buildV2:^(QNConfigurationBuilder *builder) {
    // 配置上传区域，Host0、Host1 建议通过服务方式下发
    builder.zone = [[QNFixedZone alloc] initWithUpDomainList:@[@"Host0", @"Host2"]];
    // 分片上传阈值：4MB，大于 4MB 采用分片上传，小于 4MB 采用表单上传
    builder.putThreshold = 4*1024*1024;
    // 开启并发分片上传
    builder.useConcurrentResumeUpload = true;
    // 使用分片 V2
    builder.resumeUploadVersion = QNResumeUploadVersionV2;
    // 文件分片上传时断点续传信息保存，表单上传此配置无效
    NSString *recorderPath = [NSHomeDirectory() stringByAppendingPathComponent:@"Documents"];
    builder.recorder = [QNFileRecorder fileRecorderWithFolder:recorderPath error:nil];
}];
QNUploadManager *upManager = [[QNUploadManager alloc] initWithConfiguration:configuration];

__weak typeof(self) weakSelf = self;
QNUploadOption *uploadOption = [[QNUploadOption alloc] initWithMime:nil progressHandler:^(NSString *key, float percent) {
    NSLog(@"percent == %.2f", percent);
}
                                                             params:nil
                                                           checkCrc:NO
                                                 cancellationSignal:^BOOL{
    // 当需要取消时，此处返回 true，SDK 内部会多次检查返回值，当返回值为 true 时会取消上传操作
    return false;
}];

NSString *filePath = @"";    // 文件路径
NSString *key = @"";         // 文件 key
NSString *uploadToken = @""; // 上传的 Token
[upManager putFile:filePath key:key token:uploadToken complete:^(QNResponseInfo *info, NSString *key, NSDictionary *resp) {
    if (info.isOK) {
        // 上传成功
    } else {
        // 上传失败
    }
} option:uploadOption];

// 1. 在七牛云存储控制台修改 Bucket 配置，域名管理 -> 开启传输加速（SDK 开启使用加速域名上传的功能仅仅是 SDK 支持
//    使用加速域名，所以要想使用传输加速，七牛云服务端需开启此功能）
// 
// 2. SDK 配置 
// 方式一：使用 QNFixZone 配置
QNConfiguration *config = [QNConfiguration buildV2:^(QNConfigurationBuilder *builder) {
    // Upload_Domain1 和 Upload_Domain2 为加速域名，可以参考七牛云存储控制台域名管理页面，建议通过用户服务下发，不要硬编码
    builder.zone =  [[QNFixedZone alloc] initWithUpDomainList:@[@"Upload_Domain1", @"Upload_Domain2"]];
}];

// 方式二：使用 AutoZone
QNConfiguration *config = [QNConfiguration buildV2:^(QNConfigurationBuilder *builder) {
    builder.accelerateUploading = YES;        // 开启传输加速，此参数仅对使用 QNAutoZone 时有效 （v8.8.0 开始支持）
    builder.zone = [[QNAutoZone alloc] init]; // 默认是 AutoZone，所以 zone 也可以不配置
}];

QNConfiguration *configuration = [QNConfiguration buildV2:^(QNConfigurationBuilder *builder) {
    builder.zone = [[QNAutoZone alloc] init]; // 配置上传区域，使用 QNAutoZone
    builder.recorderKeyGen = ^NSString *(NSString *uploadKey, NSString *filePath) {
        // 自定义 文件分片上传时断点续传信息保存的 key，默认使用 uploadKey
        return [NSString stringWithFormat:@"%@-%@", uploadKey, filePath];
    };
    // 文件分片上传时断点续传信息保存，表单上传此配置无效
    NSString *recorderPath = [NSHomeDirectory() stringByAppendingPathComponent:@"Documents"];
    builder.recorder = [QNFileRecorder fileRecorderWithFolder:recorderPath error:nil];
    // 文件采用分片上传时，分片大小为 2MB
    builder.chunkSize = 2*1024*1024;
    
    // 分片上传阈值：4MB，大于 4MB 采用分片上传，小于 4MB 采用表单上传
    builder.putThreshold = 4*1024*1024;
    
    // 单个域名/IP请求失败后最大重试次数为 1 次
    builder.retryMax = 1;
    
    // 重试时间间隔：0.5s
    builder.retryInterval = 0.5;
    
    // 请求超时时间：60s
    builder.timeoutInterval = 60;
    
    // 使用 HTTPS
    builder.useHttps = true;
    
    // 使用备用域名进行重试
    builder.allowBackupHost = true;
    
    // 开启加速上传
    builder.accelerateUploading = true;
   
    // 开启并发分片上传
    builder.useConcurrentResumeUpload = true;
    
    // 使用并发分片上传时，一个文件并发上传的分片个数
    builder.concurrentTaskCount = 2;
    
    // 使用分片 V2
    builder.resumeUploadVersion = QNResumeUploadVersionV2;
}];

// 指定文件 mime type
NSString *mimeType = @"";
// 用于服务器上传回调通知的自定义参数，参数的key必须以x: 开头  eg: x:foo
NSDictionary <NSString *, NSString *> * params = @{};
// 用于设置meta数据，参数的key必须以x-qn-meta- 开头  eg: x-qn-meta-key
NSDictionary <NSString *, NSString *> * metaDataParams = @{};
BOOL checkCrc = true;
QNUploadOption *option = [[QNUploadOption alloc] initWithMime:mimeType
                                          byteProgressHandler:^(NSString *key, long long uploadBytes, long long totalBytes) {
    // 处理上传进度
} params:params metaDataParams:metaDataParams checkCrc:checkCrc cancellationSignal:^BOOL{
    // 当需要取消时，此处返回 false，SDK 内部会不间断检测此返回值
    return false;
}];

// 关闭 DNS 预解析
//从 7.4.0 开始增加了 DNS 预解析和缓存策略（每 2 分钟（进程非挂起状态）会自动刷新缓存策略）来减少 DNS 解析错误。默认预解析开启，需获取 IP 信息。
kQNGlobalConfiguration.isDnsOpen = NO;

// 关闭网络状态检测，当因网络异常而失败时，会检测网络状态，进而根据情况调整重试逻辑。默认开启网络状态检测。
kQNGlobalConfiguration.connectCheckEnable = NO;