本节书摘来自异步社区《iOS组件与框架——iOS SDK高级特性剖析》一书中的第8章,第8.4节与iCloud交互,作者 【美】Kyle Richter , Joe Keeley,更多章节内容可以访问云栖社区“异步社区”公众号查看
8.4 与iCloud交互
iOS组件与框架——iOS SDK高级特性剖析
添加iCloud功能后,应用需要处理一些额外的复杂问题。应用未使用iCloud时,列出其文档很简单,但使用iCloud后,可用文档清单随时会变,甚至在清单生成和显示期间都会改变。另外,由于可能在多台设备上同时编辑同一个文档,可能导致不使用iCloud时根本不会出现的冲突。本节介绍如何妥善地处理这些问题。
8.4.1 列出iCloud中的文档
要显示可用的备忘录清单,示例应用需要查询iCloud目录,以确定那里都有哪些文件。这是使用NSMetadataQuery完成的。
将NSMetadataQuery的搜索范围设置成了NSMetadataQueryUbiquitousDocumentsScope,它表示应用的iCloud目录。接下来,将谓词指定为一个文件模式字符串,这个字符串与文件扩展名为.icfnote的文档都匹配。元数据查询是在ICFMasterViewController的viewDidLoad方法中执行的,这个视图控制器还接收来自NSMetadataQuery的通知。
这两个通知分别在如下两种情况下调用方法processFiles::NSMetadataQuery收集了与谓词匹配的信息;其他设备修改了iCloud中的文档。iCloud同步来自其他设备的新文件时,将更新iCloud目录。
调用processFiles:后,在处理结果期间让NSMetadataQuery停止收集信息很重要。这可避免这个方法在更新期间被再次调用,以免应用崩溃或获得错误的结果。然后,可迭代查询结果并创建新的备忘录清单。创建备忘录清单后,再更新表视图,如图8.4所示。接下来,让NSMetadataQuery继续获取文件系统更新。
NSMetadataQuery生成的文件清单是一个NSURL数组。在方法tableView:cell ForRowAtIndexPath:中,从这些NSURL中提取了文件名(不包括扩展名),以便将其显示在表单元格中。
其中的if逻辑检查备忘录是不是最后更新的备忘录,这种信息是使用iCloud键值存储维护的,这将在本章后面介绍(参见8.6节)。如果是,就在文件名前面加上一个星号。
打开文档和新建文档在8.3.2节介绍过。用户选择一个表行或轻按加号按钮时,将把新文档或既有文档的URL传递给详细视图控制器,后者打开或创建指定的文档,在文本视图中显示该文档的文本,并将文本视图设置为第一响应者,让用户马上能够进行编辑。
关闭文档很简单。在详细视图控制器的方法viewWillDisappear:中,使用文本视图中的文本更新文档,再关闭文档。由于启用了自动保存功能,因此保存是自动完成的。
8.4.2 检测iCloud冲突
所有的同步技术都可能发生冲突。冲突指的是文档在多台设备上被同时编辑,导致iCloud根据同步规则无法确定哪个版本是最新的。
要引发冲突,可在两台设备上同时运行示例应用。将一台设备切换到飞行模式,编辑并保存一份备忘录;再在另一台设备上编辑并保存这份备忘录。然后,在第一台设备上关闭飞行模式,并尝试在第二台设备上再次编辑那份备忘录。第二台设备将发生冲突。
UIDocument类有一个文档状态属性,指出了文档发生了冲突还是可正常编辑。UIDocument对象还在文档状态发生变化时发出通知,这很有用,因为编辑文档期间发生冲突时,如果能够马上获悉并解决冲突,用户体验将好得多。为检测冲突,详细视图控制器需要通过注册从文档那里收到文档状态变化通知,这是在方法viewWillAppear: 中完成的。
如果文档状态为UIDocumentStateEditingDisabled,这个方法就让文本视图放弃第一响应者地位,导致编辑马上结束。如果文档状态为UIDocumentStateInConflict,就更新用户界面,显示一个让用户能够通过轻按来解决冲突的按钮(如图8.5所示),否则就让用户界面返回到正常编辑状态。