iOS-实现文件导入和导出

最近应用中有个需求，是关于文件的导入和导出的。在网上找了找，并没有合适的资料以参考学习。索性自己写一篇，以供记录和学习使用。
文件的导入和导出在iOS开发中经常会用到。例如应用可以导出文档以便其他应用使用，或者允许其他应用可以导入文档到你的应用中以便使用。又比如，前几天一位前同事向我咨询这种其他应用的文件拿来使用的栗子。总而言之，应用很广泛。话不多说，多说无益，是时候亮出真正的技术了。

---

忽然发现，并没有合适的表述方式，索性写个Demo，用来编写“iOS-实现文件导入和导出”这篇文章吧！

创建应用

新建一个工程，基础界面如下图所示，其中：

@property (strong, nonatomic) UIWebView *webView; //用来显示文件
@property (strong, nonatomic) UIButton *exportFileButton; //导出文件按钮
@property (strong, nonatomic) UIButton *displayFileButton; //显示导入文件按钮

Demo_HomePage.png

往工程里面拖进一个测试文件：一个PDF文件“test.pdf”，好的，目前已经初步完成了一个在资源文件夹中包含一个PDF文档的iOS应用。

---

导出文档

将工程里资源文件夹中的PDF文件导出，并使用外部应用打开此文件。
首先，在ViewController.m中声明一个UIDocumentInteractionController类型的变量：

@property (strong, nonatomic) UIDocumentInteractionController *documentController;

UIDocumentInteractionController类提供了应用内用户文件交互的支持。在这个例子中，你会使用它来导出文档。
实现以下方法：

- (void)openDocumentInResourceFolder {
    NSString *filePath = [[NSBundle mainBundle] pathForResource:@"test" ofType:@"pdf"];
    _documentController = [UIDocumentInteractionController  interactionControllerWithURL:[NSURL fileURLWithPath:filePath]];
    _documentController.delegate = self;
    _documentController.UTI = @"com.adobe.pdf";
    [_documentController presentOpenInMenuFromRect:CGRectZero inView:self.view animated:YES];
}

#pragma mark - UIDocumentInteractionControllerDelegate
- (void)documentInteractionController:(UIDocumentInteractionController *)controller willBeginSendingToApplication:(NSString *)application {
    
}
- (void)documentInteractionController:(UIDocumentInteractionController *)controller didEndSendingToApplication:(NSString *)application {
    
}
- (void)documentInteractionControllerDidDismissOpenInMenu:(UIDocumentInteractionController *)controller {
    
}

-(void)openDocumentInResourceFolder;
这个方法用来创建一个指向需要导出PDF文件的路径，通过它来关联UIDocumentInteractionController对象。
需要设置UTI（Uniform Type Identifiers，唯一类型标识）以便能让系统找到合适的应用来打开你的文档。在这个例子中，设置为“com.adobe.pdf”，表示PDF文档。其他的常用UTI有如“public.html”(HTML文档)、“public.jpeg”（JPEG文件）等。
更多标识可以查阅Apple官方文档

其他方法是UIDocumentInteractionControllerDelegate代理方法。在本Demo中可以不实现这三个方法。
最后，在-(void)exportFileButtonClick方法中，添加如下代码：

- (void)exportFileButtonClick:(id)sender {    
    [self openDocumentInResourceFolder];
}

真机测试Demo，点击“导出到其他应用显示”按钮（exportFileButton）运行如下图所示：

exportFileButtonClick.png

选择任一个支持打开文档格式的外部应用，就将文档导出到外部应用中。

---

导入文档

在iOS中，一般有两种方法导入文档

• 通过iTunes导入文档
• 应用间的文件交换

1.通过iTunes导入文档

通过iTunes导入文档，是用一种比较简单和直接的方式。用户可以传入或传出一些较大的文件到应用中。
在Info.plist中，添加键UIFileSharingEnabled如下：
Show Raw Keys/Values 模式下

ShowRawKeys:Values1.png

非Show Raw Keys/Values 模式下

非ShowRawKeys:Values1.png

运行Demo程序。然后打开iTune，选择设备，然后选择“应用”

iTunes左侧选择.png

只要把文件拖进右侧文件共享，应用中。所有传入的文件都会放置在应用沙盒中的Documents文件夹中。

iTunes右侧文件拖进.png

当然，先前导入的文件也会在这里显示，完全可以选择文件，然后选择“存储到...”将应用中的文件保存到电脑中。
好了，我们已经运用**
![Uploading 通过iTunes导入文档并验证导入成功_807781.png . . .]
**这种方法将文件导入到了应用。可以通过添加到ViewController.m中的代码进行证明：

- (void)displayFileButtonClick:(id)sender {
    [self listFilesFromDocumentsFolder];
}

- (void)listFilesFromDocumentsFolder {    
    NSString *documentsDirectory = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) firstObject];
    NSFileManager *manager = [NSFileManager defaultManager];
    NSArray *fileList = [manager contentsOfDirectoryAtPath:documentsDirectory error:nil];
    NSMutableString *filesStr = [NSMutableString stringWithString:@"Documents文件夹中文件的名称： \n"];
    for (NSString *str in fileList) {
        [filesStr appendFormat:@"%@ \n", str];
    }
    [self displayAlert:filesStr];
    [self loadFileFromDocumentsFolder:fileList[0]];
}

- (void)displayAlert:(NSString *)str {
    UIAlertController *alertController = [UIAlertController alertControllerWithTitle:@"提示" message:str preferredStyle:UIAlertControllerStyleAlert];
    UIAlertAction *cancelAction = [UIAlertAction actionWithTitle:@"知道了" style:UIAlertActionStyleCancel handler:nil];
    [alertController addAction:cancelAction];
    [self presentViewController:alertController animated:YES completion:nil];
}

- (void)loadFileFromDocumentsFolder:(NSString *)filename {
    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *documentDirectory = [paths objectAtIndex:0];
    NSString *filePath = [documentDirectory stringByAppendingPathComponent:filename];
    NSURL *fileURL = [NSURL fileURLWithPath:filePath];
    [self handleDocumentOpenURL:fileURL];
}

- (void)handleDocumentOpenURL:(NSURL *)url {
    NSURLRequest *requestObj = [NSURLRequest requestWithURL:url];
    [_webView setUserInteractionEnabled:YES];
    [_webView loadRequest:requestObj];
}

运行结果如图：

通过iTunes导入文档并验证导入成功.png

2.应用间的文件交换

首先，注册应用。你要使Demo能够接受PDF类型的文件。
在Info.plist中，添加键CFBundleDocumentTypes如下：
Show Raw Keys/Values 模式下

ShowRawKeys:Values2.png

非Show Raw Keys/Values 模式下

非ShowRawKeys:Values2.png

CFBundleDocumentTypes键：Array类型，它包含一个dictionary数组，这个dictionary表示你的应用可以支持的文档类型
Item0类型为Dictionary
CFBundleTypeName：文档类型名
LSHandleRank：应用的所有者（以上声明的这种文件类型的创建者），有Alternate（这种文件类型的另外一个浏览者）、None或Default
CFBundleTypeRole：应用通过什么方式处理这种文件：Editor、Viewer、Shell或None
LSItemContentTpyes:Array类型，它包含表示这种文件类型的UTI数组通过以上设置就可以向IOS注册你的应用，以便可以处理PDF文档。

当一个PDF类型的文档传到应用中后，应用就会自动调用方法：application:openURL:options: 该方法必须在application delegate中实现。

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    if (url != nil && [url isFileURL]) {
        if (self.window.rootViewController && [self.window.rootViewController isKindOfClass:[ViewController class]]) {
            ViewController *VC = (ViewController *)self.window.rootViewController;
            [VC handleDocumentOpenURL:url];  //handleDocumentOpenURL:公有方法
        }
    }
    return YES;
}

当文档传入到应用中时，它会被复制到Document文件夹下的“Inbox”目录中。以上方法url参数表示Inbox目录的路径。一旦文档被传入，你将调用ViewController类的handleDocumentOpenURL:方法，以便加载文档到WebView。
运行其他应用，打开文档，选择使用其他其他应用打开，就可以看到如下所示的情形：

应用间的文件交换.png

---

好了，暂时就这样把，对于更多类型的文件导入，可以查阅Apple官方文档里的UTI进行添加。

---