美文网首页iOS开发超神学院
使用UIDocumentInteractionControlle

使用UIDocumentInteractionControlle

作者: ghost__ | 来源:发表于2017-03-08 16:30 被阅读227次

    背景一: 在app中需要打开类似于 word pdf ppt 等等文件 做一个预览
    背景二: 所有文件都是进行的本地文件预览 网上在线预览无法实现 这个了解到需要后台人员进行配合 提供在线预览的功能
    背景三: 在下列方法中使用的沙盒文件路径 是由于已经做过文件存入沙盒处理 所以可以直接取
    背景四: 下列所有代码 可以直接新建一个工程 然后拷贝到viewController.m 进行运行 前提是记得要做文件写入沙盒处理 不然会获取不到的

    方法一 :使用webView进行 这种方式很简单 只测试了word 可以行的通
       - (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
        //本地沙盒文件路径
        NSString *pathWord = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:@"word.doc"];
        
        //创建webView
        UIWebView *webV = [[UIWebView alloc]initWithFrame:self.view.bounds];
        [self.view addSubview:webV];
        
        //设置request
        NSURL *fileUrl = [NSURL fileURLWithPath:pathWord];
        NSURLRequest *request = [NSURLRequest requestWithURL:fileUrl];
        
        //加载request
        [webV loadRequest:request];
    }
    
    方法二 使用UIDocumentInteractionController 进行预览

    看名字有没有一种感觉 一个控制器。感觉还不错 但是你错了 这个不是一个控制器 这个类继承自NSObject
    不多说直接看用法 运行起来就行了

    @interface ViewController ()<UIDocumentInteractionControllerDelegate>
    
    @property (nonatomic, strong) UIDocumentInteractionController *documentIntController;
    @end
    
    @implementation ViewController
    - (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
        //本地沙盒文件路径
        NSString *pathWord = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:@"word.doc"];
        
        //创建对象 嵌入文件路径
        self.documentIntController = [UIDocumentInteractionController interactionControllerWithURL:[NSURL fileURLWithPath:pathWord]];
        self.documentIntController.name = @"word.doc";//文件名 不设置也可以 系统会获取到传入文件的名字进行展示  如果自定义的话  可以通过这个进行设置
        self.documentIntController.delegate = self;//代理
        
        
        //下面是三种效果  可以一一打开注释进行查看  同一时间只能运行一种效果
        //    [self.documentIntController presentOptionsMenuFromBarButtonItem:barButtonItem animated:YES];//显示提示框 再选择是否开启预览
        
        
        //    [self.documentIntController presentOpenInMenuFromBarButtonItem:barButtonItem animated:YES];//显示提示框 但是第三行不能选择预览
        
        
        [self.documentIntController presentPreviewAnimated:YES];//直接预览  然后在预览中选择是否使用其他软件打开
    }
    
    //UIDocumentInteractionControllerDelegate
    //返回的控制器  指明预览将在那个控制器上进行 不进行设置 无法进行预览
    - (UIViewController *)documentInteractionControllerViewControllerForPreview:(UIDocumentInteractionController *)controller {
        return self;
    }
    @end
    
    • 注意点:
      一:记得在创建的用来预览的控制器中进行强引用 @property (nonatomic, strong) UIDocumentInteractionController *documentIntController;

      • 理由一:反推,不进行强应用,直接在代码块中进行创建或者进行弱引用 当代码块执行完 UIDocumentInteractionController实例同时被释放 实例代理对象也同时被释放掉了 这个时候点击文件进行预览 谁来响应代理 返回预览控制器 找不到预览控制器 系统怎么知道该在哪里进行预览展示 (这是直接预览的情况)
      • 理由二:可以不直接进行展示 先展示菜单栏(记得在代码块中创建UIDocumentInteractionController对象 弱引用创建属性没用) 在执行代码块的过程中 菜单已经被执行出来了 但是执行完后 对象又被释放了 代理也被释放了 然后进行点击菜单第三方app 或者点击预览的时候 系统又找不到预览控制器了 或者找不到调用者(调用第三方app) 然后直接疯掉 崩溃了(展示菜单栏)

      二:记得代理方法 实现一个方法就可以得到效果 返回的是一个控制器 指明预览将在那个控制器上面进行

    三:如果先展示菜单没有任何效果 可能原因是模拟器上没有软件能用来打开文件 (一般这种没有任何反应的 在模拟器上会出现 真机上出现几率不大 原因就是没能找到能开启文件的app 所以就不做展示了)

    四:这里只做简单应用 细节问题 提供一个链接http://www.jianshu.com/p/3f03897cf98a

    方法三 使用QLPreviewController进行预览

    这个就是一个真正的控制器 使用这个的时候 记得导入框架QuickLook.framework 感觉上面有点类似tableView数据源方法 设置数量 然后设置返回的url(类似于tableView里面的cell)

    直接代码(新建控制器继承自QLPreviewController 内部实现):

    .h文件
    @interface YHPreviewController : QLPreviewController
    //多文件预览 加载数据
    - (void)loadUrlPathList:(NSArray *)urlPathList andCurrentPreVItemIndex:(NSInteger)index;
    //单文件预览  加载数据
    - (void)loadUrlPath:(NSURL *)fileUrl;
    @end
    
    .m 文件
    @interface YHPreviewController ()<QLPreviewControllerDelegate,QLPreviewControllerDataSource>
    
    @property (nonatomic, strong) NSMutableArray *fileUrlList;//记录文件路径
    @end
    
    @implementation YHPreviewController
    
    - (NSMutableArray *)fileUrlList {//懒加载
        if (!_fileUrlList) {
            _fileUrlList = [NSMutableArray array];
        }
        return _fileUrlList;
    }
    - (void)viewDidLoad {
        [super viewDidLoad];
        //设置代理
        self.delegate = self;
        self.dataSource = self;
    }
    
    #pragma mark -- QLPreviewControllerDelegate  QLPreviewControllerDataSource
    //返回数据 数量
    - (NSInteger)numberOfPreviewItemsInPreviewController:(QLPreviewController *)controller {
        return self.fileUrlList.count;
    }
    //返回具体的文件路径  直接返回NSURL对象就行   点击QLPreviewitem 进去  滚动到文件最后  你会看到这样一样东西@interface NSURL (QLPreviewConvenienceAdditions) <QLPreviewItem>    NSURL 是遵守QLPreviewItem的
    - (id<QLPreviewItem>)previewController:(QLPreviewController *)controller previewItemAtIndex:(NSInteger)index {
        return self.fileUrlList[index];
    }
    
    #pragma mark -- 数据加载   封装的加载方法
    //加载数据 同时设置当前预览的文件  
    //多文件
    - (void)loadUrlPathList:(NSArray *)urlPathList andCurrentPreVItemIndex:(NSInteger)index {
        for (NSURL *urlPath in urlPathList) {
            if ([YHPreviewController canPreviewItem:urlPath]) {//判断是否可以打开文件
                [self.fileUrlList addObject:urlPath];
            }
        }
        self.currentPreviewItemIndex = index;
        [self reloadData];
    }
    //单文件
    - (void)loadUrlPath:(NSURL *)fileUrl {
        if ([YHPreviewController canPreviewItem:fileUrl]) {
            [self.fileUrlList addObject:fileUrl];
        }
        [self reloadData];
    }
    
    - (void)didReceiveMemoryWarning {//这个  呵呵......
        [super didReceiveMemoryWarning];
    }
    
    
    
    //怎么使用创建的控制器  打开文件  调用方法   这里还是在viewController.m里面看调用代码
    - (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
        //获取沙盒二进制文件路径  多个文件路劲  都是提前写进沙盒过了
        NSString *pathPPT = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:@"578b06d152364.pptx"];
        NSString *pathPDF = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:@"[如何掌控自己的时间和生活].How.to.Get.Control.of.Your.Time.and.Your.Life.2006.Scan.CHS-INTERNET.pdf"];
        NSString *pathWord = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:@"word.doc"];
        NSString *pathPng = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:@"Bar.png"];
        NSString *pathXlsx = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:@"xlse.xlsx"];
        
        
        YHPreviewController *pre = [[YHPreviewController alloc]init];//创建对象
        
        //    [pre loadUrlPath:[NSURL fileURLWithPath:path]];//单文件预览
        
        [pre loadUrlPathList:@[[NSURL fileURLWithPath:pathWord],[NSURL fileURLWithPath:pathXlsx],[NSURL fileURLWithPath:pathPPT],[NSURL fileURLWithPath:pathPDF],[NSURL fileURLWithPath:pathPng]] andCurrentPreVItemIndex:0];//多文件预览
        
        //跳转  这里也可以使用push 自带光环 导航栏
        [self presentViewController:pre animated:YES completion:nil];
    }
    

    ok 到这里 就结束了 第三种文件打开的方式

    其实,个人感觉第二种与第三种其实是一种 第二种方式UIDocumentInteractionController 内部就是对QLPreviewController的封装
    上一张图片 使用UIDocumentInteractionController打开预览后 的图层结构 看看是不是有点眼熟


    873B67F1-66DE-4CB1-BCF3-3E6056329E41.png

    所以具体使用哪种 就看自己怎么选了

    一些讨论,关于预览视图的自定义:说说预览视图 导航栏的设置 与 底部bar的设置
    直接设置并没有什么卵用 苹果已经禁用掉了
    我用的方式是 通过视图的外观代理类 进行获取 然后设置的 亲测有效

    #pragma mark -- 设置导航栏和底部标签栏
    - (void)setNavgationBarAndTabBar {
        //获取导航栏
        UINavigationBar *navBar = [UINavigationBar appearanceWhenContainedIn:[QLPreviewController class], nil];//这个方法的意思是 在QLPreviewController 这个类中获取 UINavigationBar类型的对象  这是一个局部的    还有一个全局的 获取所有类中UINavigationBar类型的对象   值得注意的是 这个方法在iOS9之后就不能用的  点进去看  会有提示该使用哪个方法
        [navBar setBarTintColor:[UIColor whiteColor]];//导航栏颜色
        [navBar setTintColor:[UIColor blackColor]];//按钮颜色
        [navBar setTitleTextAttributes:@{NSForegroundColorAttributeName : [UIColor blackColor]}];//标题颜色
        
        //获取标签栏
        UIToolbar *toolBar = [UIToolbar appearanceWhenContainedIn:[QLPreviewController class], nil];
        //    [toolBar setBackgroundImage:[UIImage imageNamed:@"Bar"] forToolbarPosition:UIBarPositionBottom barMetrics:UIBarMetricsDefault];
        [toolBar setTintColor:[UIColor blackColor]];
    //这里关于toolBar  为什么不使用 setBarTintColor 进行颜色的设置  这里有一个问题 是能设置颜色  但是是底层toolBar的颜色  表层的并没有设置上     但是使用图片的方式却可以设置上    
    //看下图 
    }
    
    66CFECB7-D6B1-4A0B-91CF-93284F5E1592.png

    设置后的 导航栏 与 底部Bar颜色都变了 证明是有效的


    DC2A1077-D765-4818-B330-9663E3E5F641.png

    关于UIAPPearance


    508BC46C-0908-4D04-9539-797E06112F6F.png
    7786798A-C1E7-4F1E-8B68-3BE043CC31F0.png
    补充:消除导航栏与标签栏
    思路:将加载出来的预览视图抽离出来  加载到一个新的控制器上面
    此思路并非原创 在哪里看到的忘了......
    @implementation PHViewController
    
    - (void)viewDidLoad {
        [super viewDidLoad];
        self.view.backgroundColor = [UIColor whiteColor];
        self.edgesForExtendedLayout = UIRectEdgeNone;
        //文件写入沙盒
        NSString *path = [[NSBundle mainBundle] pathForResource:@"word" ofType:@"doc"];
        NSData *dataWord = [NSData dataWithContentsOfFile:path];
        BOOL resultWord = [dataWord writeToFile:[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:@"word.doc"] atomically:YES];
        if (resultWord) {
            NSLog(@"写入成功");
        }
        [self navigationBar];
    }
    - (void)navigationBar {
        self.navigationItem.title = @"文章浏览";
        self.navigationItem.leftBarButtonItem = [[UIBarButtonItem alloc]initWithTitle:@"完成" style:UIBarButtonItemStyleDone target:self action:@selector(done)];
        self.navigationItem.rightBarButtonItem = [[UIBarButtonItem alloc]initWithTitle:@"查看文章" style:UIBarButtonItemStyleDone target:self action:@selector(preview)];
    }
    - (void)done {
        [self dismissViewControllerAnimated:YES completion:nil];
    }
    - (void)preview {
        NSString *pathWord = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:@"word.doc"];
        YHPreviewController *pre = [[YHPreviewController alloc]init];//创建对象
        [pre loadUrlPath:[NSURL fileURLWithPath:pathWord]];//单文件预览
        [self addChildViewController:pre];
        pre.view.frame = CGRectMake(0, -44, [UIScreen mainScreen].bounds.size.width, [UIScreen mainScreen].bounds.size.height - self.navigationController.navigationBar.bounds.size.height - [[UIApplication sharedApplication] statusBarFrame].size.height);
        dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(1.f * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
            //延迟一秒显示 文件貌似需要调整
            [self.view addSubview:pre.view];//视图抽离与添加
        });
    }
    
    核心代码:
    - (void)preview {
    //1.加载需要预览的文件
        NSString *pathWord = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:@"word.doc"];
        YHPreviewController *pre = [[YHPreviewController alloc]init];//创建对象
        [pre loadUrlPath:[NSURL fileURLWithPath:pathWord]];//单文件预览
        [self addChildViewController:pre];//这里是为了不让预览控制器释放
    
    2.给预览控制器视图设置frame
        pre.view.frame = CGRectMake(0, -44, [UIScreen mainScreen].bounds.size.width, [UIScreen mainScreen].bounds.size.height - self.navigationController.navigationBar.bounds.size.height - [[UIApplication sharedApplication] statusBarFrame].size.height);
    
    3.延迟一秒将预览视图添加到当前控制器上面   在测试的时候加载预览视图的时候 视图会有错位 感觉上是没有加载完成  所以延迟一秒执行
        dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(1.f * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
            //延迟一秒显示 文件貌似需要调整
            [self.view addSubview:pre.view];//视图抽离与添加
        });
    }
    

    demo:https://github.com/DeepSeaGhost/openFileDemo
    demo注意点:所有文件都没有 所以运行之前需要导入文件 文件名随意 注意代码同步

    相关文章

      网友评论

      • 哈么么茶:是否可以禁止分享 禁止复制 ? 感觉只有用uiwebView做了

      本文标题:使用UIDocumentInteractionControlle

      本文链接:https://www.haomeiwen.com/subject/izhbgttx.html