iOS PDFKit 开发指北

2017年夏天，在苹果全球开发者大会（WWDC）上，苹果公司终于推出了针对于 iOS 的 PDFKit 支持。PDFKit 自从 MacOS 10.4 以来一直在 AppKit for MacOS 中。但 UIKit 却迟迟得不到支持，尽管苹果公司之前在 iBooks 和 Mail 中使用过 PDFKit ， 但是该框架并未向开发人员开房。

PDFKit 包含了大量关于 PDF 相关的功能，例如，打开，修改，绘图和保存 PDF ，也包含了搜索文本。在 iOS 11 后，苹果终于开放了 PDFKit 。目前（虽然离 PDFKit 发布已经过了一年多），但是目前中文资料和 Demo 确实比较少，下面笔者就带着大家简单的了解一下 PDFKit。

主要核心功能如下：

PDFView

PDFDocument

PDFPage

PDFAnnotation

让我看到你们的双手， put your hands up!

引入 #import <PDFKit/PDFKit.h> ，创建 PDFView ，创建之前，首先要创建 PDFDocument ，这里通过文件路径 URl 进行创建。

创建 PDFView ，将 PDFDucument 对象赋给 PDFView。

至此，就实现了 PDF 的读取及显示。

首先获取 PDFDocument 的属性 PDFPage ：

通过 PDFPage 的对象方法，可以获取 PDF 的缩略图，这里需传入图片的 size：

创建 collectionViewCell ，通过 collectionView 就可以实现一个大致的功能。

点击跳转

获取 cell 的点击事件，取出所点击的 PDFPage 对象，用下述方法进行跳转：

PDFOutline 是一个层级关系的对象，他表示 PDF 的大纲（也就是我们常用的书签）。每个 PDFOutline 对象都可通过 childAtIndex: 方法获取出他的孩子对象， 注意 ，这里需要先判断 numberOfChildren ，以确定该 outline 对象存在多少个孩子节点，避免下标超界引发的崩溃。

实现大纲功能

从 PDFDocument 中获取 PDFOutline

遍历 outline 孩子节点（默认只遍历一层）

当点击节点时，判断有无孩子节点，进行当前数组的新增或删除。

这里搜索功能主要靠下述方法实现

调用此方法之前，首先需将 PDFDocument 设置代理，通过 PDFDocument 的代理进行回调。获取 PDFSelection 对象，

再根据 selection 对象显示搜索内容。

调用下述方法即可对 PDFView 进行缩放，

实现双击缩放或还原：

这里通过设置 pdfView 的 scaleFactor 属性即可实现， 注意 ： scaleFactorForSizeToFit 属性是当前 PDF 充满屏幕的比例。

GitHub : https://github.com/japho/PDFDemo

本文原地址： https://japho.top/2018/11/21/guideline-of-pdfkit/

iOS 11 后苹果在iOS平台开放了PDFKit SDK，可以使用这个框架显示和 *** 作 pdf 文件，此项目应用PDFKit实现显示pdf、显示缩略图、展开大纲和搜索文字的功能。

github地址: https://github.com/tzshlyt/iOS11-PDFKit-Example

注意 : 本项目需要 Xcode 9 Beta 1, Swift 4 and iOS 11及更高版本。

在 UIKit 中我们使用响应者对象（Responder）接收和处理事件。一个响应者对象一般是 UIResponder 类的实例，它常见的子类包括 UIView，UIViewController 和 UIApplication，这意味着几乎所有我们日常使用的控件都是响应者，如 UIButton，UILabel 等等。

点击后，事件传递由Application->UIWindow->ViewController->View这样传递上来（事件传递是由父到子）

在这过程中，系统会去调用两个方法,如下

hitTest遍历寻找first responder 的规则:

1、调用pointInside来判断点击是否落在当前视图

2、如果pointInside返回NO，则hitTest:withEvent返回nil，查找其他同级的view

3、如果pointInside返回YES，则继续遍历subViews(最后添加的view优先被查找,FILO原则)，向subView发送hitTest查找响应的view。

4、如果有子视图返回非空对象，那么hiTest:withEvent返回此对象，处理结束。（该子视图没有subview，否则应该继续遍历该子视图的subView）

5、如果全部的子视图都返回nil，则hitTest:withEvent返回自身（self）

事件的传递是从上到下（父控件到子控件），事件的响应是从下到上（顺着响应者链条向上传递：子控件到父控件。

参考：

https://juejin.cn/post/6894518925514997767

---