使用PDFKit写一个基本的PDF阅读器

Posted 2022-12-08 人生如梦91

• PDFKit相关类
• 加载PDF文档
• 显示PDF文档
  • 滚动控制
  • 缩放控制
• 目录视图
• 文档搜索
• Annotation
• 结束

WWDC 2017 苹果发布了一个新的关于PDF的库—PDFKit， 看起来很不错的样子，现在是时候学习一波了。

PDFKit相关类

PDFKit的相关类不多，用起来也很容易，比之前苹果的QuartzCore的C语言API使用起来容易太多了。相关类如下：

1､PDFDocument: 这个类的作用一目了然，它代表了一个PDF文档，可以使用它的初始化方法-initWithURL:

2､PDFView: 这个类是一个呈现PDF文档的UIView，包括所有的UI操作，使用-initWithDocument:方法进行初始化

3､ PDFThumbnailView: 这个类是一个关于PDF的缩略视图。通过设置其PDFView属性来关联一个PDFView

4､ PDFPage: 表示了当前PDF文档中的一页

5､ PDFOutline: 表示了整个PDF文档的轮廓，比如有些带目录标签的文档

6､ PDFAnnotation: 表示了PDF文档中加入的一些标注，如下划线，删除线，备注等等。

7､ PDFSelection：表示了PDF文档中的一个选区

8､ PDFAction: 表示了PDF文档中的一个动作，比如点击一个链接等等

加载PDF文档

PDFDocument代表了一个PDF文档，加载的代码如下所示：

PDFDocument文档中包含了PDF文档的每一页，一般的PDF App在文档页面，都有一个缩略图，可以使用PDFPage的-thumbnailOfSize:forBox:方法来生成一个缩略图，如下所示：

我们使用PDFDocument的pageAtIndex:方法，获取到首页的PDFPage对象，然后调用PDFPage对应的方法即可拿到缩略图，效果如下所示：

显示PDF文档

加载PDF完成之后，下一步要做的就是显示PDF文档，这该是PDFView的功劳了。只要使用PDFView的初始化方法即可。实现的UI如下所示：

其中，我们可以通过 displayMode 属性对显示的样式进行控制，取值如下：

typedef enum PDFDisplayMode : NSInteger 
    //单页显示
    kPDFDisplaySinglePage = 0,
    //单页连续
    kPDFDisplaySinglePageContinuous = 1,
    //双页显示
    kPDFDisplayTwoUp = 2,
    //双页连续
    kPDFDisplayTwoUpContinuous = 3
 PDFDisplayMode;

使用 displayPageBreaks 控制是否显示页面之间的分隔符。

滚动控制

可以看到，右边有一个页面指示器，当页面滚动的时候指示器会跟随着对应的滚动，并且指示当前是哪个页面，我们输出PDFView的subViews可以看到，其实里面包含一个PDFScrollView，其实就是一个UIScrollView，但是问题来了，本来UIScrollView我们可以使用代理，不过我们可以使用KVO监听contentOffset属性来控制，通过contentSize及屏幕高度的比例来移动Cursor，如下所示：

缩放控制

我们在进入PDF文档的时候，可以看到PDF的大小是适配屏幕的，调整缩放，我们使用 scaleFactor，minScaleFactor，maxScaleFactor 来控制，PDFView里面有一个 autoScales 属性，本来以为他是自动适配屏幕的，结果发现不是。只好自己来实现了，计算正确的scaleFactor的代码如下：

其中_xContentSize是当scaleFactor为1.0的时候的contentSize.width。

目录视图

PDFOutline代表的是整个PDF文档的轮廓，其中PDFDocument中的属性 outlineRoot 表示了整个PDF文档的根目录，我们可以使用PDFOutline中的 label 获取目录的相关文档，使用numberOfChilds 方法可以获取到子目录标签的数目，基本代码如下：

当我们点击一项的时候，应该要跳转到对应的地方，PDFDestination表示一个PDF文档上的地点，我们使用PDFView的goToDestination方法，跳到相应的地方去，如下所示：

如下所示：

文档搜索

文档搜索也很简单，使用-findString:withOptions:方法，可以进行搜索，代码如下所示：

其中，我们可以设置PDFSelection中的 color 属性，可以调整选区的颜色。当搜索出来之后，可以使用-setHighlightedSelections:方法对搜索到的字符串进行高亮显示，同时可以使用-scrollSelectionToVisible:方法来滚动到选区，但是我发现不起作用，不知道为什么，可能是我使用方法不对。

Annotation

添加Annotation的方法如下：

添加Annotation的代码几乎都一样的，其中PDFBorder可以设置线宽和线型，比如虚线、实线等。同样的我在使用的时候发现设置lineWidth并不管用，不知道是不是我的使用方法不对，还是怎么样的，完全不起作用，我通过设置bounds方法的高度来设置线宽。

使用Annotation还可以有很多功能，看WWDC17视频，甚至可以在PDF中加入文本TextView，Button，RadioButton，CheckBox等，简直强大。

结束

PDFKit确实是一个不错的库，很轻松的就能实现一个PDF阅读器，比以前的那个框架容易了不少，除了牛逼，我还能说什么呢？