项目需要在客户端显示用户上传的多格式文件,包括常见的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中的方法都是选择性实现的,其中的方法从命名中大概也能猜到它的作用。