iOS Document Interaction 编程指南

关于 DocumentInteraction

iOS支持在你的app中用其他app预览和显示文档。iOS还支持文件关联，允许其他app通过你的程序打开文件。这些技术包括了UIKit中提供的UIDocumentInteractionController类（ UIDocumentInteractionController Class Reference)，以及Quick Look框架（Quick Look Framework Reference)。

从iOS4.2开始，Quick Look框架提供了内置的文件打印支持。如果你要定制自己的打印和拷贝行为，你可以自己实现documentinteraction controller委托方法来提供支持。UIDocumentInteractionController和QLPreviewController类的示例代码，请参考DocInteraction示例工程.

预览文档和呈现选项菜单

如果你的app需要打开它不支持的文件，请使用UIDocumentInteractionController。一个documentinteraction controller通过Quick Look框架判断文档是否能被另一个app打开和预览。也就是说，你的app通过documentinteraction controller提供给用户一些可选的操作。

要使用一个document interaction controller，需要以下步骤：

1. 针对每个你想打开的文件，创建相应的UIDocumentInteractionController实例。

2. 在app的UI中提供一个代表这个文件的图像化表示（一般，你应该显示文件名或者图标）。

3. 如果用户和这个对象发生交互，例如触摸了这个控件，则调用document interaction controller显示一个如下的界面：

o 预览文件的内容。

o 一个包含预览和打开操作的菜单。你可以通过实现某些委托方法，向菜单中加入其他操作，比如复制、打印。

o 一个菜单，仅包含“以其它方式打开”操作。

documentinteraction controller内置了一些手势，你可以直接实现它们的action。

如何需要与文件交互的app都可以使用document interaction controller。这些程序绝大部分都需要从网络下载文件。例如，email程序需要打开和预览邮件附件。

即使是从不下载文件的app，也需要document interaction controller。例如，你的app需要支持文件共享（参考“File-Sharing Support” in iOS Technology Overview 以及DocInteraction 示例工程), 你可以对同步到app Documents/Shared目录下的文件使用documentinteraction controller。

创建DocumentInteraction Controller
要创建一个document interaction controller实例，用你想要打开的文件实例化它，并设置它的delegate属性。delegate对象负责告诉document interaction controller呈现视图时需要的信息，以及当视图显示和用户交互时要执行的动作。

如以下代码所示。注意方法的调用者必须retain返回对象。

- (UIDocumentInteractionController *) setupControllerWithURL: (NSURL) fileURL
    usingDelegate: (id <UIDocumentInteractionControllerDelegate>) interactionDelegate {

    UIDocumentInteractionController *interactionController =
        [UIDocumentInteractionController interactionControllerWithURL: fileURL];
    interactionController.delegate = interactionDelegate;

    return interactionController;
}

创建好document interaction controller之后，可以通过它的属性来读取与之关联的文件信息，包括文件名、类型和 URL。该controllerｙ还有一个　icons 属性，其中包含了多个 UIImage 对象,本别用于表示该文档的多个大小的图标。这些信息可用于UI。

如果你想让用户用在其他程序中打开这个文件，可以使用controller的 annotation 属性，将该程序所需的附加信息放在其中。当然信息的格式必须能够被该应用程序识别。例如，该属性将被某个应用程序套件中的单个程序所用。当这个程序想与套件中的其他程序进行交互时，就可以使用annotation 属性。当调用应用程序打开一个文件时，option 字典中会包含 annotation 的值，可以使用UIApplicationLaunchOptionsAnnotationKey 作为键在option字典中检索它。

呈现 Document InteractionController
通过 Documentinteraction controller ，用户可以预览该文件，或者通过弹出菜单让用户选择相应的动作。

· 模式化显示文件预览窗口，调用 presentPreviewAnimated: 方法。

· 通过弹出菜单提示用户选择相应动作，调用presentOptionsMenuFromRect:inView:animated: 或者presentOptionsMenuFromBarButtonItem:animated: 方法。

· 提示用户用其他程序打开该文件，调用presentOpenInMenuFromRect:inView:animated: 方法或者presentOpenInMenuFromBarButtonItem:animated: 方法。

这些方法都会显示一个视图——要么是预览窗口，要么是弹出菜单。任何一个方法的调用，都要检查返回值。返回值为 NO，表示这个视图没有任何内容，将不能显示。例如，presentOpenInMenuFromRect:inView:animated:方法返回NO,表明已安装的程序中没有任何程序能够打开该文档。

如果你要显示预览窗口，委托对象必须实现 documentInteractionControllerViewControllerForPreview: 方法。预览窗口以模式窗口的形式显示，因此需要在该方法中返回一个view controller ，作为预览窗口的父窗口。如果你不实现该方法，或者在该方法中返回 nil，或者你返回的 view controller 无法呈现模式窗口，则该预览窗口不会显示。

document interactioncontroller 会自动解散它呈现出来的窗口。当然你也可以调用 dismissMenuAnimated: 或dismissPreviewAnimated: 方法手动解散它。

在示例项目 DocInteraction 中，演示了如何呈现一个document interaction controller（使用了手势识别）。

注册应用程序支持的文档类型

如果你的程序可以打开某种特定的文件类型，则你可以通过Info.pllist 文件注册程序所能打开的文档类型。当其他程序向系统询问哪些程序可以识别该类型的文件时，你的程序将会被列到选项菜单中，供用户选择。

相关章节: “注册应用程序支持的文件类型”

注册应用程序支持的文件类型
如果你的程序能够打开某种文件，你可以向系统进行注册。这会运行其他程序通过 iOS 的 document interaction 技术提供给用户一个选择，从而调用你的程序处理这些文件。

这需要在程序的Info.plist 文件中包含 CFBundleDocumentTypes 键 (查看 “CoreFoundation Keys”) 。系统将该键中包含的内容进行登记，这样其他程序就可以通过 document interaction controller 访问到这些信息。

CFBundleDocumentTypes 键是一个dictionary数组，一个dictionary表示了一个指定的文档类型。一个文档类型通常与某种文件类型是一一对应的。但是，如果你的程序对多个文件类型采用同样的处理方式，你也可以把这些类型都分成一个组，统一视作一个文档类型。例如，你的程序中使用到的本地文档类型，有一个是旧格式的，还有一个新格式（似乎是影射微软office文档），则你可以将二者分成一组，都放到同一个文档类型下。这样，旧格式和新格式的文件都将显示为同一个文档类型，并以同样的方式打开。

CFBundleDocumentTypes 数组中的每个dictionary 可能包含以下键：

· CFBundleTypeName 指定文档类型名称。

· CFBundleTypeIconFiles 是一个数组，包含多个图片文件名，用于作为该文档的图标。

· LSItemContentTypes 是一个数组，包含多个 UTI 类型的字符串。UTI 类型是本文档类型（组）所包含的文件类型。

· LSHandlerRank 表示应用程序是“拥有”还是仅仅是“打开”这种类型而已。

在应用程序的角度而言，一个文档类型其实就是一种文件类型（或者多个文件类型），该程序将一个文档类型的文件都视作同样的东西对待。例如，一个图片处理程序可能将各种图片文件都看成不同的文档类型，这样便于根据每个类型进行相应的优化。但是，对于字处理程序来说，它并不关心真正的图形格式，它把所有的图片格式都作为一个文档类型对待。

下表列出了Info.plist 中的一个 CFBundleTypeName 示例。

LSItemContentTypes 表示与文件格式对应的 UTI，CFBundleTypeIconFiles 指定了该类型所用的图标资源。

表 1 自定义文件格式的文档类型

<dict>
   <key>CFBundleTypeName</key>
   <string>My File Format</string>
   <key>CFBundleTypeIconFiles</key>
       <array>
           <string>MySmallIcon.png</string>
           <string>MyLargeIcon.png</string>
       </array>
   <key>LSItemContentTypes</key>
       <array>

补充：移动开发 , IOS ,