文件查看 UIDocumentInteractionController

UIDocumentInteractionController是从iOS 3.2的SDK开始支持的，它是直接继承的NSObject，而不是我们想象的UIViewController。

基础操作

在当前“视图控制器”里面：

NSString *cachePath = [[NSBundle mainBundle] pathForResource:@"民族" ofType:@"xlsx"]; 
NSURL * pathUrl = [NSURL fileURLWithPath:cachePath];//文件路径
UIDocumentInteractionController *documentController = [UIDocumentInteractionController interactionControllerWithURL:pathUrl];
documentController.delegate = self;

[documentController presentPreviewAnimated:YES];//跳转到查看页面



#pragma mark - UIDocumentInteractionControllerDelegate
-(UIViewController *)documentInteractionControllerViewControllerForPreview:(UIDocumentInteractionController *)controller{
    return self;
}
-(UIView *)documentInteractionControllerViewForPreview:(UIDocumentInteractionController *)controller{
    return self.view;
}
-(CGRect)documentInteractionControllerRectForPreview:(UIDocumentInteractionController *)controller{
    return self.view.bounds;
}
//-(void)documentInteractionController:(UIDocumentInteractionController *)controller willBeginSendingToApplication:(NSString *)application {
//    NSLog(@"%@",controller);
//}
//-(void)documentInteractionController:(UIDocumentInteractionController *)controller didEndSendingToApplication:(NSString *)application {
//    NSLog(@"%@",controller);
//}
//-(void)documentInteractionControllerDidDismissOpenInMenu:(UIDocumentInteractionController *)controller {
//    NSLog(@"%@",controller);
//}

🌰“支持类型”的展示例子：

播放音乐

NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);//文件路径
NSString *docDir_Str = [paths objectAtIndex:0];
NSString *doc_PathStr = [docDir_Str stringByAppendingString:@"/localFile"];

//直接打开
fullFileNameStr = @"心跳（原味版）-于文文.mp3";
NSString * filePathStr = [doc_PathStr stringByAppendingPathComponent:fullFileNameStr];
NSURL * fileUrl = [NSURL fileURLWithPath:filePathStr];
UIDocumentInteractionController *documentController =  [UIDocumentInteractionController interactionControllerWithURL:fileUrl];
documentController.delegate = self;
//跳转到文档查看页面
[documentController presentPreviewAnimated:YES];

播放音乐，效果：

播放视频

fullFileNameStr = @"11111.mp4";

播放视频，效果：

#####文档查看

fullFileNameStr = @"民族.xlsx";

文档查看，效果：

#####图片查看

fullFileNameStr = @"chx.jpg";

图片查看，效果：

其文件查看非常强大，支持很多类型！

🌰“文档操作”例子 在自己App里面，对文档 进行操作：（可自动检测可进行分享的App）

---

打开 第三方App里面的文档

当我们需要打开 在 第三方App里面的文档时，可以在“info.plist”中添加键值对来搞定这个问题： “Source Code”格式：

<key>CFBundleDocumentTypes</key>
<array>
   <dict>
       <key>CFBundleTypeName</key>          <!--类型名-->
       <string>pdf</string>                 <!--随意取名字-->
       <key>CFBundleTypeIconFiles</key>     <!--类型文件的icon图-->
       <array>
           <string>MySmallIcon.png</string>
           <string>MyLargeIcon.png</string>
       </array>
       <key>LSItemContentTypes</key>        <!--所关联的UTI格式，一个类型名可以对应多个UTI-->
       <array>
           <string>com.adobe.pdf</string>
       </array>
       <key>LSHandlerRank</key>             <!--是不是app所拥有的类型，Default:不是，Owner:是-->
       <string>Owner</string>
   </dict>
</array>

 在以下链接中，有文件后缀 和 UTI(统一类型标识符) 的对应表： developer.apple.com/library/mac…

“info.plist”修改实例：（“Property List”格式）

如何导入文档：

当我们从其他的App，用“readerApp”打开文档时，会调用“readerApp”的方法！ “- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation { }”

其中，url对应的就是该文档的位置。 实际在此时，该文档已经复制到“readerApp”的“document/inbox”文件夹下。 我们需要将该文档移动到其他位置，因为每次其他应用调用“readerApp”打开该文档时，都会在inbox文件夹下复制一份文件（不考虑该文件是否已经存在），如果多次使用，那么inbox将会占用大量的存储空间。

总结：记得在移动了文档后，要删除掉“inbox”路径里面的内容！

---

---

---

自己的文档阅读APP 书写🌰：

1.在“info.plist”里面，添加可以支持的所有类型：（“Source Code”格式：）

<key>CFBundleDocumentTypes</key>
<array>
	<dict>
		<key>CFBundleTypeName</key>
		<string>com.myapp.common-data</string>
		<key>LSItemContentTypes</key>
		<array>        <!--罗列了 支持的类型-->
			<string>com.microsoft.powerpoint.ppt</string>
			<string>public.item</string>
			<string>com.microsoft.word.doc</string>
			<string>com.adobe.pdf</string>
			<string>com.microsoft.excel.xls</string>
			<string>public.image</string>
			<string>public.content</string>
			<string>public.composite-content</string>
			<string>public.archive</string>
			<string>public.audio</string>
			<string>public.movie</string>
			<string>public.text</string>
			<string>public.data</string>
		</array>
	</dict>
</array>

这样，其他应用程序的文档在使用第三方打开的时候，就可以看到你的应用程序了。

对应的“Property List”格式:

文档查看及操作：

添加可支持的类型之前	添加可支持的类型之后

反复导入文档：

每次导入，都会在inbox文件夹下复制一份文件。 所以出现了：名称后面文档 命名为“-3”的情况

解决的操作

导入文档后，不管是否保存在本地，都要删除Inbox 里面的文件：

//fileNameStr：文件名  （导入所产生文档所在的Url 获取来的）
NSString * fileNameStr = [_docUrl lastPathComponent];

NSArray * paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString * docDir_Str = [paths objectAtIndex:0];//沙盒文档路径

//删除文件的路径
NSString * deleteDocPath = [[docDir_Str stringByAppendingPathComponent:@"Inbox"] stringByAppendingPathComponent:fileNameStr];
//删除Inbox里面的文件
[[NSFileManager defaultManager] removeItemAtPath:deleteDocPath error:nil]; 

2.文档导入操作：

全局变量：NSURL * _docUrl;//文档Url

/** 文档导入 */
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {  
      if (self.window) { 
          if (url) {
              _docUrl = url;
              NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
              NSString *docDir_Str = [paths objectAtIndex:0];
              NSString *pathStr = [docDir_Str stringByAppendingString:@"/localFile"];
              NSFileManager * fileManager = [NSFileManager defaultManager];
              if(![fileManager fileExistsAtPath:pathStr]){
                  //如果不存在,则说明是第一次运行这个程序，那么建立这个文件夹
                  NSString *directryPath = [docDir_Str stringByAppendingPathComponent:@"localFile"];
                  [fileManager createDirectoryAtPath:directryPath withIntermediateDirectories:YES attributes:nil error:nil];
              }
            

              //提醒视图: UIActionSheet
              UIActionSheet *actionSheet = [[UIActionSheet alloc] initWithTitle:@"是否需要保存文档？" delegate:self cancelButtonTitle:@"取消" destructiveButtonTitle:@"确认" otherButtonTitles:nil];
              [actionSheet showInView:self.window.rootViewController.view];


              //在NSUserDefaults里：保存“从文档进入App”为YES
              [User_Def setBool:YES forKey:JoinAPPFromDocumVC]; 
              [User_Def synchronize];
            
              //跳转，查看文档
              UIDocumentInteractionController *documentController =  [UIDocumentInteractionController interactionControllerWithURL:url];
              documentController.delegate = self;
              [documentController presentPreviewAnimated:YES];//跳转到查看页面
          }
     }

}

3.文档查看：UIDocumentInteractionControllerDelegate

#pragma mark - UIDocumentInteractionControllerDelegate
-(UIViewController *)documentInteractionControllerViewControllerForPreview:(UIDocumentInteractionController *)controller{
    return self.window.rootViewController;
}
-(UIView *)documentInteractionControllerViewForPreview:(UIDocumentInteractionController *)controller{
    return self.window.rootViewController.view;
}
-(CGRect)documentInteractionControllerRectForPreview:(UIDocumentInteractionController *)controller{
    return self.window.rootViewController.view.bounds;
}
//-(void)documentInteractionController:(UIDocumentInteractionController *)controller willBeginSendingToApplication:(NSString *)application {
//    NSLog(@"%@",controller);
//}
//-(void)documentInteractionController:(UIDocumentInteractionController *)controller didEndSendingToApplication:(NSString *)application {
//    NSLog(@"%@",controller);
//}
//-(void)documentInteractionControllerDidDismissOpenInMenu:(UIDocumentInteractionController *)controller {
//    NSLog(@"%@",controller);
//}

4.提醒视图:UIActionSheetDelegate 以及 5.保存操作

#pragma mark - UIActionSheetDelegate
- (void)actionSheet:(UIActionSheet *)actionSheet clickedButtonAtIndex:(NSInteger)buttonIndex {
    NSLog(@"ACActionSheet delegate - %ld",buttonIndex);

    if (buttonIndex == 0) { //是否考虑 保存
        NSFileManager * fileManager = [NSFileManager defaultManager];
        NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
        NSString *docDir_Str = [paths objectAtIndex:0];
        NSString *pathStr = [docDir_Str stringByAppendingString:@"/localFile"];
        NSDirectoryEnumerator *enumerator = [fileManager enumeratorAtPath:pathStr];//遍历
    
    
        NSArray *fileList = [NSArray arrayWithArray:[fileManager contentsOfDirectoryAtPath:pathStr error:nil]];
        if (fileList.count == 0) { //个数为0
            NSString * fileNameStr = [_docUrl lastPathComponent];
            NSString * DocPathStr = [[NSHomeDirectory() stringByAppendingPathComponent:@"Documents/localFile"] stringByAppendingPathComponent:fileNameStr];   //保存的路径
            NSData * data = [NSData dataWithContentsOfURL:_docUrl];//保存的数据
        
            if ([data writeToFile:DocPathStr atomically:YES]) {
                NSString * deleteDocPath = [[docDir_Str stringByAppendingPathComponent:@"Inbox"] stringByAppendingPathComponent:fileNameStr];
                [fileManager removeItemAtPath:deleteDocPath error:nil]; //删除Inbox里面的文件
            }
        } else {
            for (NSString *fileName in enumerator) {
                NSLog(@"%@",fileName);
                NSString * fileNameStr = [_docUrl lastPathComponent];
                NSString * fileName_total = [fileName componentsSeparatedByString:@" -"][0];
                NSString * fileNameStr_total = [fileNameStr componentsSeparatedByString:@" -"][0];
                if (![fileName_total isEqualToString:fileNameStr_total]) {
                    NSString * DocStr = [[NSHomeDirectory() stringByAppendingPathComponent:@"Documents/localFile"] stringByAppendingPathComponent:fileNameStr];   //保存的路径
                    NSData * data = [NSData dataWithContentsOfURL:_docUrl];//保存的数据
                
                    if ([data writeToFile:DocStr atomically:YES]) {
                        NSString * deleteDocPath = [[docDir_Str stringByAppendingPathComponent:@"Inbox"] stringByAppendingPathComponent:fileNameStr];
                        [fileManager removeItemAtPath:deleteDocPath error:nil]; //删除Inbox里面的文件
                    }
                }
            }
        }
    
    } else { //不保存在本地

        //删除Inbox里面的文件
        NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
        NSString *docDir_Str = [paths objectAtIndex:0];
        NSString * fileNameStr = [_docUrl lastPathComponent];
        NSString * deleteDocPath = [[docDir_Str stringByAppendingPathComponent:@"Inbox"] stringByAppendingPathComponent:fileNameStr];
        [[NSFileManager defaultManager] removeItemAtPath:deleteDocPath error:nil];
    }
}

当然，最简单的 删除“Inbox”里文件操作：

就是 —— 在文档展示界面消失后，再删除“Inbox”里面的文件。

实现代理方法：

- (void)documentInteractionControllerDidEndPreview:(UIDocumentInteractionController *)controller { //结束 展示文档
   //(不保存，直接删除) 删除“Inbox”里面的文件
   NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
   NSString *docDir_Str = [paths objectAtIndex:0];
   NSString * fileNameStr = [_docUrl lastPathComponent];//文件名
   NSString * deleteDocPath = [[docDir_Str stringByAppendingPathComponent:@"Inbox"] stringByAppendingPathComponent:fileNameStr];
   [[NSFileManager defaultManager] removeItemAtPath:deleteDocPath error:nil];

   NSLog(@"%@",controller);
}

---

---

---

（2017.11.02）

goyohol's essay