《iOS组件与框架——iOS SDK高级特性剖析》——第8章，第8.4节与iCloud交互

本节书摘来自异步社区《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所示），否则就让用户界面返回到正常编辑状态。