因项目需求接触的 EPub 阅读器,前前后后尝试了很多库,最后找到了个相对兼容不错的展开了调试;
其中对解压缩和数据加载方面进行了改造优化,使其更加的完美;
其大概原理是首先将 epub 文件解压后得到其资源文件包,其中会包含相应的文件夹,通过 OEBPS 文件夹中的资源文件提取所需的数据并进行拼装后渲染;
其中包含了文件的解压缩和通过 touchXML 对 xml 数据的解析和写入;
对 xml 解析获取到节点内容并保存,遍历数据数组找到其中所需的节点,将其遍历节点得到所需属性的 name 和 value 作为字典对象填充至模型.
/** 解析 OPF 文件,从 ncx 读取书籍目录 @param opfRelativePath 文件相对路径 @param bookInfoModel 数据填充模型 @return 结果集 */ + (NSArray *)parseOPF:(NSString *)opfRelativePath bookInfoModel:(LPPBookInfoModel *)bookInfoModel {...}
具体内容还是直接通过 Demo 中的 code 表述更加直观,Demo 中也包含了一些注释看着相对较为轻松;
关于 SDK 集成
1)首先,引入‘SSZipArchive‘,通过该解压进行对 EPub 文件的解压,获取其文件资源;
2)其次,引入‘MWPhotoBrowser‘库,此处需要注意因‘MWPhotoBrowser‘库已经将‘SDWebImage‘和‘MBProgressHUD‘两个库包含其中.若项目中已经引入上面两个库可以直接通过‘MWPhotoBrowser‘来代替,避免导致文件冲突的异常;
3)最后,引入‘DTCoreText‘,将 html 字符串转化为富文本使用的工具,保证原生实现的同时起到灵活修改样式的功能,且在性能方面相比 WebView 加载方式更具优势.
platform :ios, ‘8.0‘ target "TestEpub" do pod ‘SSZipArchive‘ pod ‘DTCoreText‘ pod ‘MWPhotoBrowser‘, ‘~> 2.1.2‘ end
关于项目集成后配置
1)将头文件引入至 pch 文件中
#import "XDSReaderHeader.h"
2)编译会抛出 arc 的文件异常,勿慌,此异常由于类文件包中的文件所引起
按照下图所示步骤,在所对应的类中添加"-fno-objc-arc"即可搞定
3)arc 异常处理完毕后再次编译程序会再次提示文件缺失的异常信息
工程文件层级目录中对文件进行检索"mdjyml"后将其文件删除,再次编译工程即可搞定
关于方法调用
配置好文件路径后调用如下方法即可
// *传 TestEpub NSURL *fileURL = [[NSBundle mainBundle] URLForResource:@"*传"withExtension:@"epub"]; dispatch_async(dispatch_get_global_queue(0, 0), ^{ XDSBookModel *bookModel = [XDSBookModel getLocalModelWithURL:fileURL]; dispatch_async(dispatch_get_main_queue(), ^{ XDSReadPageViewController *pageView = [[XDSReadPageViewController alloc] init]; [[XDSReadManager sharedManager] setResourceURL:fileURL];//文件位置 [[XDSReadManager sharedManager] setBookModel:bookModel]; [[XDSReadManager sharedManager] setRmDelegate:pageView]; [self presentViewController:pageView animated:YES completion:nil]; }); });
文件夹方式读取加载方式
/** 配置文件路径*/ NSString *filePath = [[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:[NSString stringWithFormat:@"%@", @"xx文件名称xx"]]; // 文件检索 NSFileManager *fileManager = [NSFileManager defaultManager]; if (![fileManager fileExistsAtPath:filePath]) { [MBProgressHUD showError:@"暂无此书" toView:controller.view]; return; } NSURL *fileURL = [NSURL fileURLWithPath:filePath]; // Reading book dispatch_async(dispatch_get_global_queue(0, 0), ^{ XDSBookModel *bookModel = [XDSBookModel getLocalModelWithURL:fileURL]; dispatch_async(dispatch_get_main_queue(), ^{ XDSReadPageViewController *pageView = [[XDSReadPageViewController alloc] init]; [[XDSReadManager sharedManager] setResourceURL:fileURL]; [[XDSReadManager sharedManager] setBookModel:bookModel]; [[XDSReadManager sharedManager] setRmDelegate:pageView]; [controller presentViewController:pageView animated:YES completion:nil]; }); });
Demo 已上传至 GitHub,直接引入所需的 epub 文件(Demo 中含示例文件)后编译即可查阅效果;
https://github.com/survivorsfyh/YHEpubDemo
_______
以上便是此次 Epub 阅读器的小结,首次搞还望多多指教.