《iOS 6高级开发手册（第4版）》——2.3节秘诀：监测Documents文件夹

本节书摘来自异步社区《ios 6高级开发手册（第4版）》一书中的第2章，第2.3节秘诀：监测documents文件夹，作者 【美】erica sadun，更多章节内容可以访问云栖社区“异步社区”公众号查看

2.3　秘诀：监测documents文件夹

ios 6高级开发手册（第4版）

ios文档并没有受困在它们的沙盒中，你可以并且应该与用户共享它们。应该允许用户直接控制他们的文档，以及访问他们可能在设备上创建的任何资料。一个简单的info.plist设置将使itunes能够显示用户的documents文件夹的内容，并使那些用户能够根据需要添加和删除资料。

在将来某个时间，你可能使用一个简单的nsmetadataquery监测器来监视documents文件夹并报告更新。在编写本书时，元数据监视还没有扩展到icloud之外以用于其他的文件夹。从os x导出的代码无法像期望的那样在ios上工作。目前，准确地讲，有两个搜索域可供ios使用：即普遍存在的数据范围和普遍存在的文档范围（即icloud和icloud）。

直到ios中出现了一般的功能之后，才能使用kqueue。这种老式技术提供了可伸缩的事件通知。利用kqueue，可以监测添加和清除事件。这粗略地等同于寻找要添加和删除的文件，它们是你想做出反应的主要更新类型。秘诀2-3展示了一个用于监视documents文件夹的kqueue实现。

2.3.1 支持文档文件共享

要支持文件共享，可以向应用程序的info.plist中添加一个uifilesharingenabled键，并把它的值设置为yes，如图2-2所示。在处理非原始的键和值时，这个项目被称为支持itunes文件共享的application。itunes将在每个设备的apps选项卡中列出所有声明文件共享支持的应用程序，如图2-3所示。

在itunes中，将在设备的apps选项卡中列出每个安装的声明了uifilesharingenabled的应用程序

2.3.2 用户控制

不能指定在documents文件夹中允许存放哪些类型的项目。用户可以添加他们喜欢的任何项目，以及删除他们希望删除的任何项目。不过，他们不能做的是使用itunes界面导航子文件夹。注意图2-3中的inbox文件夹，这是一个从应用程序之间的文档共享中遗留下来的工件，但它不应该出现在那里。用户不能直接管理数据，不应该把子文件夹留在那里以使他们混淆。

用户在itunes中不能像删除其他文件和文件夹那样删除inbox，应用程序应该也不能直接把文件写到inbox中。尊重inbox的角色，它用于捕获从其他应用程序传入的任何数据。在实现文件共享支持时，总是要检查inbox以恢复活动状态，并且处理该数据以清空inbox，以及无论何时应用程序启动和恢复运行时都要删除它。在本章后面将讨论处理传入的文档的最佳实践。

2.3.3 xcode访问

作为一位开发人员，你不仅能够访问documents文件夹，而且能够访问整个应用程序沙盒。使用xcode organizer (command-2) > devices选项卡>“设备”> applications >“应用程序名称”可以浏览沙盒，以及从中上传和下载文件。

通过启用应用程序的uifilesharingenabled属性，可以测试基本的文件共享，以及把数据加载到documents文件夹中。在创建了那些文件之后，可以使用xcode和itunes检查、下载和删除它们。

2.3.4 扫描新文档

秘诀2-3通过在其begingeneratingdocumentnotificationsinpath:方法中请求kqueue通知来工作。在这里，它获取一个用于你所提供的路径（在这里是documents文件夹）的文件描述符，并请求用于添加和清除事件的通知。它将把这个功能添加到当前的运行循环中，无论何时监测的文件夹更新，都会启用通知。

一旦接收到那个回调，它将发布一条通知（我自定义的kdocumentchanged，在kqueuefired方法中），并且继承监视新事件。在主线程上的主运行循环中都会运行它，因此一旦接收到通知，gui就可以响应并更新它自身。

下面的代码段演示了如何使用秘诀2-3的监视器来更新gui中的文件列表。无论何时内容改变了，更新通知都允许应用程序刷新那些目录内容清单：

把设备连接到itunes，测试这个秘诀。使用itunes app选项卡界面添加和删除项目。设备的机载文件列表将会更新，以实时反映那些改变。

在使用这个秘诀时，要知道一些警告。首先，对于较大的文档，在收到了创建它们的通知之后，不应该立即阅读它们。你可能希望调查文件大小，以确定何时应该停止写入数据。第二，itunes file sharing在必要时可以暂缓传输，要相应地进行编码。

秘诀2-3 使用kqueue文件监测器