CloudKit 入门贴

本文技术内容转自原帖

CloudKit牵扯了一系列的前期设置,详见参考

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

CKContainer

CKContainer: Containers 就像应用运行的沙盒一样,一个应用只能访问自己沙盒中的内容而不能访问其他应用的。Containers 就是最外层容器,每个应用有且仅有一个属于自己的 container。事实上,经过开发者授权配置 CloudKit Dashboard 之后,一个应用也可以访问其他应用的 container。这里和App Group相同,和iCloud Documents也是一样的,允许不同App访问同一个存储空间。

属性和方法

+ (CKContainer *)defaultContainer;  //默认容器
+ (CKContainer *)containerWithIdentifier:(NSString *)containerIdentifier; //根据identifier获取容器,同一个App有可能有多个iCloud容器。

- (void)addOperation:(CKOperation *)operation; //CKOperation 是CKDatabase操作的基类,继承他,重写main方法。

//私有云数据库
@property (nonatomic, readonly) CKDatabase *privateCloudDatabase;
//公有云数据库
@property (nonatomic, readonly) CKDatabase *publicCloudDatabase;

typedef NS_ENUM(NSInteger, CKAccountStatus) {
    /* 无法获取账户*/
    CKAccountStatusCouldNotDetermine                   = 0,
    /* 账户可用 */
    CKAccountStatusAvailable                           = 1,
    /* 权限禁止使用 */
    CKAccountStatusRestricted                          = 2,
    /* 没有登陆iCloud账户 */
    CKAccountStatusNoAccount                           = 3,
} NS_ENUM_AVAILABLE(10_10, 8_0);

//账户更换通知
CK_EXTERN NSString * const CKAccountChangedNotification NS_AVAILABLE(10_11, 9_0);

//获取账户状态,账户通过授权可以让知道你邮箱的人,知道你正在使用这个应用。
- (void)accountStatusWithCompletionHandler:(void (^)(CKAccountStatus accountStatus, NSError * __nullable error))completionHandler;

一个基本使用范例:

[[CKContainer defaultContainer] accountStatusWithCompletionHandler:^(CKAccountStatus accountStatus, NSError * _Nullable error) {
        
        void  (^requestPremission)(void) = ^{
            
            [[CKContainer defaultContainer] requestApplicationPermission:CKApplicationPermissionUserDiscoverability completionHandler:^(CKApplicationPermissionStatus applicationPermissionStatus, NSError * _Nullable error) {
                
                switch (applicationPermissionStatus) {
                    case CKApplicationPermissionStatusCouldNotComplete:
                    {
                        //无法完成
                        NSLog(@"CKApplicationPermissionStatusCouldNotComplete");
                        break;
                    }
                    case CKApplicationPermissionStatusDenied:
                    {
                        //拒绝
                        NSLog(@"CKApplicationPermissionStatusDenied");
                        break;
                    }
                    case CKApplicationPermissionStatusGranted:
                    {
                        //授权通过
                        NSLog(@"CKApplicationPermissionStatusGranted");
                        break;
                    }
                    case CKApplicationPermissionStatusInitialState:
                    {
                        break;
                    }
                    default:
                        break;
                }
                
            }];
        };
        
        void  (^signPremission)(void) = ^{
            [[CKContainer defaultContainer] statusForApplicationPermission:CKApplicationPermissionUserDiscoverability completionHandler:^(CKApplicationPermissionStatus applicationPermissionStatus, NSError * _Nullable error) {
                
                switch (applicationPermissionStatus) {
                    case CKApplicationPermissionStatusInitialState:
                    {
                        requestPremission();
                        break;
                    }
                    case CKApplicationPermissionStatusGranted:
                    {
                        //授权过了
                        break;
                    }
                    case CKApplicationPermissionStatusDenied:
                    {
                        //已经拒绝
                        break;
                    }
                    case CKApplicationPermissionStatusCouldNotComplete:
                    {
                        //无法获取状态
                        break;
                    }
                    default:
                        break;
                }
            }];
        };
        
        switch (accountStatus) {
            case CKAccountStatusAvailable:
            {
                //账户可用
                signPremission();
                break;
            }
            case CKAccountStatusCouldNotDetermine:
            {
                //无法获取账户信息
                break;
            }
            case CKAccountStatusNoAccount:
            {
                //当前无登录账户
                break;
            }
            case CKAccountStatusRestricted:
            {
                //账户被禁用此功能
                break;
            }
            default:
                break;
        }
    }];

区别

CloudKitiCloud Documents的区别在于,前者是存储在苹果服务器中的,后者则是存储在用户设备的特定区域中。

CKDatabase

CKDatabase: Database 即数据库,私有数据库用来存储敏感信息,比如说用户的性别年龄等,用户只能访问自己的私有数据库。应用也有一个公开的数据库来存储公共信息,例如你在构建一个根据地理位置签到的应用,那么地理位置信息就应该存储在公共数据库里以便所有用户都能访问到。

CKRecord

CKRecord: 即数据库中的一条数据记录。CloudKit 使用 record 通过 k/v 结构来存储结构化数据。关于键值存储,目前值的架构支持 NSString、NSNumber、NSData、NSDate、CLLocation,和 CKReference、CKAsset(这两个下面我们会说明),以及存储以上数据类型的数组。

   CKRecord *postRecrod = [[CKRecord alloc] initWithRecordType:@"item"];
    postRecrod[@"password"] = @"asdasdasdasd";
    CKDatabase *publicDatabase = [[CKContainer defaultContainer] privateCloudDatabase];
    [publicDatabase saveRecord:postRecrod completionHandler:^(CKRecord *record, NSError *error) {
        if(error) {
            NSLog(@"%@", error);
        } else {
            NSLog(@"Saved successfully");
        }
    }];

 CKContainer *defaultContainer = [CKContainer defaultContainer];
    NSPredicate *predicate = [NSPredicate predicateWithFormat:@"TRUEPREDICATE"];
    CKDatabase *publicDatabase = [defaultContainer privateCloudDatabase];
    CKQuery *query = [[CKQuery alloc] initWithRecordType:@"item" predicate:predicate];
    [publicDatabase performQuery:query inZoneWithID:nil completionHandler:^(NSArray *results, NSError *error) {
        if (!error) {
            NSLog(@"%@", results);
        } else {
            NSLog(@"%@", error);
        }
    }];

  CKContainer *defaultContainer = [CKContainer defaultContainer];
    CKDatabase *publicDatabase = [defaultContainer publicCloudDatabase];
    CKRecordID *recordID = [[CKRecordID alloc] initWithRecordName:@"1"];
    [publicDatabase fetchRecordWithID:recordID completionHandler:^(CKRecord *record, NSError *error) {
        if(error) {
            NSLog(@"%@", error);
        } else {
            record[@"postText"] = @"123 Beggers Canyon, Tatooine";;
            [publicDatabase saveRecord:record completionHandler:^(CKRecord *record, NSError *error) {
                if(error) {
                    NSLog(@"Uh oh, there was an error updating ... %@", error);
                } else {
                    NSLog(@"Updated record successfully");
                }
            }];
        }
    }];

    CKContainer *defaultContainer = [CKContainer defaultContainer];
    CKDatabase *publicDatabase = [defaultContainer publicCloudDatabase];
    CKRecordID *recordID = [[CKRecordID alloc] initWithRecordName:@"1"];
    [publicDatabase deleteRecordWithID:recordID completionHandler:^(CKRecordID *recordID, NSError *error) {
        if(error) {
            NSLog(@"%@", error);
        } else {
            NSLog(@"Deleted record successfully")
        }
    }];

特别注意,如果出现未知错误,请进入iCloud Dashboard调试

CKRecordZone

CKRecordZone: Record 不是以零散的方式存在于 database 之中的,它们位于 record zones 里。每个应用都有一个 default record zone,你也可以有自定义的 record zone。

CKRecordIdentifier

CKRecordIdentifier: 是一条 record 的唯一标识,用于确定该 record 在数据库中的唯一位置。

CKReference

CKReference: Reference 很像 RDBMS 中的引用关系。还是以地理位置签到应用为例,每个地理位置可以包含很多用户在该位置的签到,那么位置与签到之间就形成了这样一种包含式的从属关系。

CKAsset

CKAsset: 即资源文件,例如二进制文件。还是以签到应用为例,用户签到时可能还包含一张照片,那么这张照片就会以 asset 形式存储起来。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 196,264评论 5 462
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 82,549评论 2 373
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 143,389评论 0 325
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,616评论 1 267
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,461评论 5 358
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,351评论 1 273
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,776评论 3 387
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,414评论 0 255
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,722评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,760评论 2 314
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,537评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,381评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,787评论 3 300
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,030评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,304评论 1 252
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,734评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,943评论 2 336

推荐阅读更多精彩内容