iOS - CloudKit基本使用

什么是CloudKit

在此之前可能大家都都知道苹果有iCloud功能,也就是iCloud Drive 了——iCloud Drive 是可以存储用户数据和文件的地方,以便在其他设备也能够访问。iOS8.0以后推出了帮助我们在应用里也能够轻松访问这些数据的框架 CloudKit

CloudKit 提供 API 让你能够访问 iCloud 服务器;它可以使用用户的 iCloud 账户来创建一个用户,并且拥有可供每个用户访问的公开权限的数据库,以及每个用户自己的私有数据库来存储信息;你也可以通过 CloudKit 的文件存储系统来存储结构化数据和大文件;这一切都不仅仅发生在用户本地,数据被存储在云端,用户可以在任意其它设备上访问。

总的来说,CloudKit 是你所熟知的数据库、文件存储、用户认证系统的集合服务。有了 CloudKit 的帮助,你不需要担心这些数据库什么的,只要专注在应用开发上就好了。

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 形式存储起来。

使用 CloudKit
1. 注册准备
1.1 前往开发者中心 注册一个 iCloud Container

注意点

  • Container 的 ID 必须以 iCloud 开头 , 这个ID并不是 APP的Bundle ID
  • iCloud Container 创建无法删除,起码目前开发中心还没有给出删除的入口,所以创建时 必须要要慎重,尤其是 Container ID ,因为一旦创建 Container 的 ID 无法更改


    注册iCloud Containers
1.2 配置真机调试证书

1.2.1 原因
如果在虚拟机上面跑,是无法调用到iCloud 上面的数据的


无法发送有效签名

1.2.2 配置一个带有 iCloud 功能的调试证书


步骤1
步骤2

创建完APP ID 后 可以看到 iCloud 功能并没有显示绿色 而是黄色 显示可配置 所以需要配置一下


步骤3
点击编辑后进入

这个时候就可以看到之前创建的iCloud Container了


选择 iCloud Container

选择iCloud Container 点击完成修改后

这里就可以看到 iCloud 功能变成绿色 激活状态了 ,上一步就是 iCloud Container 与 APP Bundle ID绑定


OK的APP ID

然后通过 APP ID 创建调试证书,这里就不做详细说明了.步骤很简单

1.3项目配置
项目配置

通过 CloudKit Dashboard 按钮 可以跳转到管理中心


管理中心
2. 增删改查

导入框架
#import <CloudKit/CloudKit.h>

2.1 绑定 Container 拿到 Database

NSString *containerWithIdentifier:UbiquityContainerIdentifier = @"iCloud.com.xxxxxxx"; // Container ID 
CKContainer *container = [CKContainer containerWithIdentifier:UbiquityContainerIdentifier];
CKDatabase *publicDB = [container publicCloudDatabase];

我们从管理网站上面看到 只能查看 publicCloudDatabase 的数据 所以一般我们都用 publicCloudDatabase 获取 Database
publicCloudDatabase

如果 Container ID 绑定错误 会报如下错误 (defaultContainer 返回的 CKContainer 也会报这个错误)


Container ID 绑定错误

2.2 增加数据

    CKRecordID *personRecordID  = [[CKRecordID alloc] initWithRecordName:@"Person"];
    CKRecord *personRecord = [[CKRecord alloc] initWithRecordType:@"Person" recordID:personRecordID];
    [personRecord setValue:@"hello,word" forKey:@"name"];
    [personRecord setValue:@18 forKey:@"age"];
    [self.publicDB saveRecord:personRecord completionHandler:^(CKRecord * _Nullable record, NSError * _Nullable error) {
        if (error) {
            NSLog(@"保存失败 %@",error);
        }else{
            NSLog(@"保存成功:%@",record);
        }
    }];

重复添加

如果重复添加 控制台会输出上图错误,重复添加是指 recordID 相同, 如果 recordID 不同, RecordType 相同, 那么可以添加成功,只不过之前 RecordType 对应的 Record 会被替换

2.3 查询
通过 CKRecordID 查询

    CKRecordID *fetchRecordID = [[CKRecordID alloc] initWithRecordName:@"Person"];
    [self.publicDB fetchRecordWithID:fetchRecordID completionHandler:^(CKRecord * _Nullable record, NSError * _Nullable error) {
        NSLog(@"%@",record.allKeys);
        [record.allKeys enumerateObjectsUsingBlock:^(NSString * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
            NSLog(@"key: %@  value:%@",obj,[record objectForKey:obj]);
        }];
    }];
查询结果

2.4 修改
先通过 CKRecordID 查询到对应的 CKRecord , 然后修改 CKRecord 的值 重新保存

    CKRecordID *editRecordID = [[CKRecordID alloc] initWithRecordName:@"Person"];
    [self.publicDB fetchRecordWithID:editRecordID completionHandler:^(CKRecord * _Nullable record, NSError * _Nullable error) {
        if (record != nil) {
            record[@"name"] = @"hello,iOS";
            [self.publicDB saveRecord:record completionHandler:^(CKRecord * _Nullable record, NSError * _Nullable error) {
                if (error) {
                    NSLog(@"修改失败:%@",error);
                }else{
                    NSLog(@"修改成功 %@",record);
                }
            }];
        } else {
            NSLog(@"%@",error);
        }
    }];
修改结果

2.5 删除
通过 CKRecordID 删除 这样下次添加时 就不会说已经存在, 因为只有 RecordID 相同时才会报重复添加的错误

    CKRecordID *delegateRecordID = [[CKRecordID alloc] initWithRecordName:@"Person"];
    [self.publicDB deleteRecordWithID:delegateRecordID completionHandler:^(CKRecordID * _Nullable recordID, NSError * _Nullable error) {
        if (error) {
            NSLog(@"删除失败:%@",error);
        }else{
            NSLog(@"删除成功 %@",recordID);
        }
    }];
删除结果
管理网站的数据截图
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,185评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,445评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,684评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,564评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,681评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,874评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,025评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,761评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,217评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,545评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,694评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,351评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,988评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,778评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,007评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,427评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,580评论 2 349

推荐阅读更多精彩内容