CloudKit 初探与教学 - 签到应用

CloudKit 的基础对象类型有 7 种。这些对象类型可能和你在其他编程领域了解的类似对象类型稍有差别。

• CKContainer
  Containers 就像应用运行的沙盒一样，一个应用只能访问自己沙盒中的内容而不能访问其他应用的。Containers 就是最外层容器，每个应用有且仅有一个属于自己的 container。（事实上，经过开发者授权配置 CloudKit Dashboard 之后，一个应用也可以访问其他应用的 container。）
• CKDatabase
  Database 即数据库，私有数据库用来存储敏感信息，比如说用户的性别年龄等，用户只能访问自己的私有数据库。应用也有一个公开的数据库来存储公共信息，例如你在构建一个根据地理位置签到的应用，那么地理位置信息就应该存储在公共数据库里以便所有用户都能访问到。
• CKRecord
  即数据库中的一条数据记录。CloudKit 使用 record 通过 k/v 结构来存储结构化数据。关于键值存储，目前值的架构支持 NSString、NSNumber、NSData、NSDate、CLLocation，和 CKReference、CKAsset（这两个下面我们会说明），以及存储以上数据类型的数组。
• CKRecordZone
  Record 不是以零散的方式存在于 database 之中的，它们位于 record zones 里。每个应用都有一个 default record zone，你也可以有自定义的 record zone。
• CKRecordIdentifier
  是一条 record 的唯一标识，用于确定该 record 在数据库中的唯一位置。
• CKReference
  Reference 很像 RDBMS 中的引用关系。还是以地理位置签到应用为例，每个地理位置可以包含很多用户在该位置的签到，那么位置与签到之间就形成了这样一种包含式的从属关系。
• CKAsset
  即资源文件，例如二进制文件。还是以签到应用为例，用户签到时可能还包含一张照片，那么这张照片就会以 asset 形式存储起来。

Convenience API 顾名思义是对 CloudKit 操作的便利 API。利用 Convenience API 就可以对 record 进行数据的三种基本操作：存储、读取、更改。
那么，继续完善我们的签到应用吧！开始前记得应用 CloudKit 框架并获得公开数据库的引用：

#import <CloudKit/CloudKit.h>
// ...
CKDatabase *publicDB = [[CKContainer defaultContainer] publicCloudDatabase];

下面，新建一个位置信息并存储
因为 CloudKit 在异步运行 saveRecord:completionHandler:
时会使用网络与服务器交互，网络状况是不定的，所以 一定 记得要在 block 中处理错误，一个好的应用应当有完善的错误处理机制。
你需要检查 NSError 对象来确定正在处理哪种错误。例如，无网络线连接的时候会触发CKErrorNetworkUnavailable 类型的错误，然后你需要做的就是失败后重试。等等，那么要什么时候重试呢？立刻，还是十秒之后？别担心，CloudKit 在 error 的 userInfo 字典中提供了一个建议的重试时间 CKErrorRetryAfterKey ：

    CKRecordID *markID = [[CKRecordID alloc] initWithRecordName:@"mark"];
    
    CKRecord *place = [[CKRecord alloc] initWithRecordType:@"Place" recordID:markID];
    
    [publicDB saveRecord:place completionHandler:^(CKRecord *savedPlace, NSError *error) {
        
        if (!error) {
            
            NSLog(@"[success]\n keys: %@\n type: %@\n rName: %@", savedPlace.changedKeys, savedPlace.recordType, savedPlace.recordID.recordName);
        } else {
            
            NSLog(@"[error]\n info:%@", error.userInfo);
            
            double retryAfterValue = [error.userInfo[CKErrorRetryAfterKey] doubleValue];
            NSDate *retryAfterDate = [NSDate dateWithTimeIntervalSinceNow:retryAfterValue];
            
            NSLog(@"[retrydata]\n %@", retryAfterDate);
        }
    }];

错误情况

下面，获取一个位置信息

    CKRecordID *greatID = [[CKRecordID alloc] initWithRecordName:@"GreatPlace"];
    
    [publicDB fetchRecordWithID:greatID completionHandler:^(CKRecord *fetchedPlace, NSError *error) {
         // handle errors here
    }];

更改一个已经存在的位置信息

    CKRecordID *greatID = [[CKRecordID alloc] initWithRecordName:@"GreatPlace"];
    
    [publicDB fetchRecordWithID:greatID completionHandler:^(CKRecord *fetchedPlace, NSError *error) {
        if (fetchedPlace != nil) {
            NSString *name = fetchedPlace[@"name"];
            fetchedPlace[@"name"] = [name stringByAppendingString:@" Door A"];
            
            [publicDB saveRecord:fetchedPlace completionHandler:^(CKRecord *savedPlace, NSError *savedError) {
                //...
            }];
        } else {
            // handle errors here
        }
    }];

查询

如果我想查询名字中含有 Dylan 的

    NSPredicate *predicate = [NSPredicate predicateWithFormat:@"name CONTAINS 'Dylan'"];
    CKQuery *query = [[CKQuery alloc] initWithRecordType:@"Place" predicate:predicate];
    
    [publicDB performQuery:query
              inZoneWithID:nil
         completionHandler:^(NSArray *results, NSError *error) {
             // ...
    }];

订阅通知

    NSPredicate *predicate = [NSPredicate predicateWithFormat:@"description CONTAINS 'party'"];
    
    CKSubscription *subscription = [[CKSubscription alloc] initWithRecordType:@"Checkin" predicate:predicate options:CKSubscriptionOptionsFiresOnRecordCreation];
    
    CKNotificationInfo *info = [CKNotificationInfo new];
    info.alertLocalizationKey = @"NEW_PARTY_ALERT_KEY";
    info.soundName = @"NewAlert.aiff";
    info.shouldBadge = YES;
    
    subscription.notificationInfo = info;
    
    [publicDB saveSubscription:subscription
             completionHandler:^(CKSubscription *subscription, NSError *error) {
                 //...
             }];

收到推送通知时，在 app delegate 中处理

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo{
    CKNotification *ckNotification = [CKNotification notificationFromRemoteNotificationDictionary:userInfo];
    if (ckNotification.notificationType == CKNotificationTypeQuery) {
        CKQueryNotification *queryNotification = ckNotification;
        CKRecordID *recordID = [queryNotification recordID];
        // ...
    }
}

目前苹果允许你使用 CloudKit 存储 10 GB 资源，100 M 数据库存储，每天 2 GB 流量；当你的用户数量增加的时候，这些免费额度也相应地增加到 1 PB 存储、10 TB 数据库存储，以及每天 200 TB 流量

WWDC 2015 中提到，CloudKit 已经 不仅 可以在 iOS 和 OS X 上使用，可以在你的网站上集成CloudKit JS，以便 iCloud 用户可以在浏览器中也能使用相应的功能，或者是使用 CloudKit web service 对 CloudKit 服务端直接进行 HTTP 请求。这意味着，现在其他移动或桌面平台都可以使用 CloudKit 了！

CopyRight@Dylan. Copy@NSHipster