在iOS中预览PDF,Word,Excel格式文件

项目需要在客户端显示用户上传的多格式文件，包括常见的PDF,Word,Excel。在网上简单查看了一下，学习了一些前辈的经验。

查看这些格式文件最快的方法就是用webView去加载，简单粗暴而且有效，缺点也比较明显就是只能看，显示的效果也算不上很友好。而且不能自己管理缓存。

NSURL *url = [NSURL URLWithString:[NSString stringWithFormat:@"https://www.xxx.demo.pdf"]];

self.wkWeb = [[WKWebView alloc] initWithFrame:self.view.bounds];
self.wkWeb.allowsBackForwardNavigationGestures = YES;
self.wkWeb.navigationDelegate = self;
[self.wkWeb loadRequest:[NSURLRequest requestWithURL:url]];
[self.view addSubview:self.wkWeb];

比如像这样一段代码，运行后就可以预览pdf文件了。

另外一种实现预览多文件格式的方式就是使用QuickLook框架的QLPreviewViewController。这种方式需要传入的是一个本地的文件路径。注意加载网络路径是不可以的，所以我们需要把文件下载到沙盒，然后再进行读取。

附上整个操作的完整示例(以pdf为例，其他格式都一样)：

NSString *documentsDirectory = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) lastObject];
NSString *reportsDirectory = [documentsDirectory stringByAppendingPathComponent:@"Reports"];
NSFileManager *fileManager = [NSFileManager defaultManager];
// 创建目录
if (![fileManager fileExistsAtPath:reportsDirectory]) {
    [fileManager createDirectoryAtPath:reportsDirectory withIntermediateDirectories:YES attributes:nil error:nil];
}

首先在沙盒重建一个文件夹，代码中在Library文件夹中创建了一个名字叫Reports的目录。这里文件夹的位置和名字根据需要自己随便就好了

NSString *urlString = @"https://www.xxx.demo.pdf";
NSString *filePath = [reportsDirectory stringByAppendingString:[NSString stringWithFormat:@"/%@", [urlString componentsSeparatedByString:@"/"].lastObject]];

这里根据请求路径最后的文件名字生成了在Report文件夹下的文件路径。比如在这里filePath就是/Users/xxx/Library/Developer/CoreSimulator/Devices/xxx/data/Containers/Data/Application/xxx/Library/Reports/demo.pdf

if ([fileManager fileExistsAtPath:filePath]) {
    self.pdfArr = @[[NSURL fileURLWithPath:filePath]];//需要给QLPreviewViewControler传入的数组参数
    NELPreviewViewController* qlPreview = [[NELPreviewViewController alloc] init];//这是作者根据项目需要自己写的QLPreviewViewControler的子类，实现代码就不贴了。这里可以直接替换成QLPreviewViewControler
    qlPreview.dataSource = self; //需要打开的文件的信息要实现dataSource中的方法
    qlPreview.delegate = self;  //视图显示的控制
    [self.navigationController pushViewController:qlPreview animated:YES];
}else{
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
    NSURL *url = [NSURL URLWithString:urlString];
    NSLog(@"NSHomeDirectory:  %@", NSHomeDirectory());
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    
    //下载文件
    NSURLSessionDownloadTask *task = [manager downloadTaskWithRequest:request progress:^(NSProgress * _Nonnull downloadProgress) {
        //打印下下载进度
        //NSLog(@"%lf",1.0 * downloadProgress.completedUnitCount / downloadProgress.totalUnitCount);
    } destination:^NSURL * _Nonnull(NSURL * _Nonnull targetPath, NSURLResponse * _Nonnull response) {
        //下载地址
        NSLog(@"默认地址:%@",targetPath);
        NSString *filePath = [reportsDirectory stringByAppendingString:[NSString stringWithFormat:@"/%@", response.suggestedFilename]];
        return [NSURL fileURLWithPath:filePath];//为下载的文件指定和上段代码写的filePath相同的地址
    } completionHandler:^(NSURLResponse * _Nonnull response, NSURL * _Nullable filePath, NSError * _Nullable error) {
        
        if (error) {
            [fileManager removeItemAtPath:filePath.absoluteString error:nil];//下载失败删除路径
        }else{
            NSLog(@"下载完成：");
            self.pdfArr = @[filePath];
            NELPreviewViewController* qlPreview = [[NELPreviewViewController alloc] init];
            qlPreview.name = model.filename;
            qlPreview.dataSource= self; 
            qlPreview.delegate= self;  
            [self.navigationController pushViewController:qlPreview animated:YES];
        }
    }];
    
    [task resume];
}

这段首先判断了将要下载的文件是否在本地以及存在，如果存在则直接读取显示，不存在的话执行下载任务。下载方法用的afn3.0。

关于QLPreviewViewController的代理方法，首先要引入QLPreviewControllerDelegate,QLPreviewControllerDataSource这两个代理。看起来和tableView的代理很像，其实用起来也有点类似。

其中必须要实现的是previewControllerDataSource代理中的两个方法

-(NSInteger)numberOfPreviewItemsInPreviewController:(QLPreviewController*)controller{
    return self.pdfArr.count; //要预览的文件的数量，类似于tableView的numberOfRow
}

-(id<QLPreviewItem>)previewController:(QLPreviewController*)controller previewItemAtIndex:(NSInteger)index{
    return self.pdfArr[index];//返回需要显示的文件的本地路径
}

PreviewControllerDelegate中的方法都是选择性实现的，其中的方法从命名中大概也能猜到它的作用。