要在 App 裡預覽 Office 文件與 PDF,不必自己寫解析器,也沒必要為每種格式各刻一個檢視器。iOS 內建的 QuickLook 框架已經把這件事包好了,只要幾個 delegate 方法就能上線。
#import <UIKit/UIKit.h> #import <QuickLook/QuickLook.h> @interface ViewController : UIViewController <QLPreviewControllerDataSource, QLPreviewControllerDelegate, UIDocumentInteractionControllerDelegate> @property (strong, nonatomic) QLPreviewController *previewController; @end
#import "ViewController.h"
@interface ViewController ()
@property (strong, nonatomic) NSArray *dirArray;
@property (strong, nonatomic) UIDocumentInteractionController *docInteractionController;
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentsPath = [paths objectAtIndex:0];
// 從 App Bundle 取一份範例文件,複製到 Documents 目錄
NSString *pathPPT = [[NSBundle mainBundle] pathForResource:@"C" ofType:@"pdf"];
NSData *pptData = [NSData dataWithContentsOfFile:pathPPT];
NSString *filePath = [documentsPath stringByAppendingPathComponent:@"C1.pdf"];
[pptData writeToFile:filePath atomically:YES];
NSFileManager *fileManager = [NSFileManager defaultManager];
self.dirArray = [fileManager contentsOfDirectoryAtPath:documentsPath error:nil];
NSLog(@"%@", self.dirArray);
self.view.backgroundColor = [UIColor redColor];
self.previewController = [[QLPreviewController alloc] init];
self.previewController.view.backgroundColor = [UIColor grayColor];
self.previewController.dataSource = self;
self.previewController.delegate = self;
self.previewController.currentPreviewItemIndex = 0;
[self presentViewController:self.previewController animated:YES completion:^{
[self.view addSubview:self.previewController.view];
}];
[self.view addSubview:self.previewController.view];
}
#pragma mark - QLPreviewControllerDataSource
// 可預覽的項目數量
- (NSInteger)numberOfPreviewItemsInPreviewController:(QLPreviewController *)controller {
return [self.dirArray count];
}
// 回傳指定索引的預覽項目,需為符合 QLPreviewItem 協議的物件(NSURL 即可)
- (id<QLPreviewItem>)previewController:(QLPreviewController *)controller previewItemAtIndex:(NSInteger)index {
NSArray *documentPaths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentDir = [documentPaths objectAtIndex:0];
NSString *name = [self.dirArray objectAtIndex:index];
NSString *path = [documentDir stringByAppendingPathComponent:name];
return [NSURL fileURLWithPath:path];
}
- (void)previewControllerDidDismiss:(QLPreviewController *)controller {
// 使用者關閉預覽時的收尾處理
}
- (void)didReceiveMemoryWarning {
[super didReceiveMemoryWarning];
}
@end
UIDocumentInteractionController 叫出系統的「用其他 App 開啟」面板,把檔案丟給已安裝的第三方檢視器。previewItemAtIndex: 要回傳的是符合 QLPreviewItem 協議的物件,最常用的是 NSURL;如果傳入的是 NSURL 但用 URLWithString: 產生了非 file scheme,一樣會預覽失敗。previewControllerDidDismiss: 有助於釋放快取、記錄使用者閱讀行為。整體來說,QuickLook 用不到三十行就能換來一個支援十餘種格式的文件檢視器,是 iOS 開發裡性價比相當高的一套 API。