PDF SDK 是干什么的？为什么不该自己解析 PDF

PDF 规范描述的不是文档结构，而是绘制指令：在什么坐标画什么。所以「这一段文字」「这一行」「这个表格」这些概念，PDF 里并不直接存在——它们要靠解析与推断还原出来。

自己解析 PDF，难在哪

• 没有段落概念。文字是一堆带坐标的绘制指令；要还原成段落，得自己做聚类与阅读顺序判断。
• 字体与编码。子集字体、编码映射、竖排与连字，都要处理。
• 渲染。显示、缩放、翻页，还有大文件的渐进式渲染，全都要自己实现。
• 编辑。改一个字要让这一段重新排版，而 PDF 的版面是按坐标固定的。
• 标注与安全。多种标注类型、加密解密、数字签名，各有各的细节。

每一件都不是「做不到」，但合起来就是一个需要专门团队长期维护的项目。

SDK 把它们封装成了什么

知叶PDF SDK 把应用层逻辑收在库内，对外按功能分组给接口：

• 阅读：页面渲染、页面跳转、显示与缩放模式、页面导航、文本选择。
• 文字编辑：段落识别，字符属性读取（字体、字号、颜色、粗斜体、上下标、对齐），文字修改。
• 图片与图形编辑：添加、删除、旋转、裁剪、等比缩放与次序管理；图形（路径）的删除、拉伸、旋转与颜色修改。
• 标注：创建（支持全部标注类型）、修改（颜色、透明度、线宽、外观）、数据提取。
• 页面管理：插入、替换、删除、旋转、裁剪，以及拆分与合并（按页数、按章节、按文件体积）。
• 文档安全：加密、解密与数字签名。

于是「合并两份 PDF」变成传文件路径，「按章节拆分」变成传参数——不需要先啃 PDF 规范。

什么情况下该用 SDK

• 你的产品要内建 PDF 能力，而不是让用户跳到外部阅读器。
• 团队不想为此长期养一个 PDF 方向的岗位。
• 需要在多个平台上提供一致的 PDF 体验。

常见问题

支持哪些平台？

Windows、macOS、iOS、Android、Linux。这是 SDK 的支持范围——知叶PDF 客户端目前只发布 Windows 版，两件事别混，见一套接口五个平台。

怎么试用？

在 SDK 页提交申请，或发邮件到 sales-cn@arkopdf.com；沟通确认需求后提供 SDK 试用包与接入文档。

只能集成二进制吗？

除二进制集成外支持源码授权，可以把 PDF 核心源码交给开发者，便于深度定制与自主维护。具体范围按项目沟通。

接口在哪看？

SDK API 参考：12 个头文件、35 个类、622 个方法，接口说明保留头文件里的英文原文。

来源：知叶PDF 官方文档。能力范围以 SDK 接口文档为准，更新于 2026 年 9 月。