入门指南
福昕 PDF SDK iOS 版致力于帮助开发者轻松将强大的福昕 PDF 技术集成到 iOS / macOS 应用中。借助福昕 SDK,即使是 PDF 领域的新手,也能在 iOS 平台上快速构建出专业的 PDF 阅读器。
更多关于福昕 PDF SDK 移动版介绍,请参见:福昕 PDF SDK - 移动端。
SDK 架构与接口层级
福昕 PDF SDK iOS 版由三个层级的组件构成,开发者可根据需求选择合适的层级进行集成:
| 层级 | 关键类 | 定位 | 适用场景 |
|---|---|---|---|
| UI Extensions | UIExtensionsManager | 带完整 UI 的阅读器组件(开源) | 快速构建功能完整的 PDF 阅读器,内置工具栏、注释、搜索等 UI |
| PDFViewCtrl | FSPDFViewCtrl | 不带 UI 的 Viewer 控件 | 需要自定义 UI 但依赖 SDK 渲染、缩放、滚动等视图能力 |
| Core SDK | FSPDFDoc、FSPDFPage、FSRenderer 等 | 底层 PDF 操作接口 | 直接操作 PDF 文档结构和内容,不依赖任何 UI |
备注
在功能文档中,接口标注为"Core SDK"表示它属于底层 PDF 操作接口,可独立于 UI 使用;标注为"PDFViewCtrl"表示它依赖 Viewer 控件;标注为"UI Extensions"表示它是内置 UI 组件提供的功能。
系统要求
| 平台 | 操作系统要求 | CPU / 架构要求 | 开发 / 运行环境要求 |
|---|---|---|---|
| iOS / macOS | iOS 11.0+(Xcode 9.0+) iOS 13+(Xcode 11.0+) macOS 10.15+(Mac Catalyst) | Apple Silicon / Intel(由 Xcode 自动处理) | Xcode 11.0 及以上(支持 iOS 与 Mac Catalyst 构建) |
备注
自 SDK 7.5.1 版本起,仅支持 Mac 64-bit 设备。这是由于 iOS 11 之后,Apple 要求所有应用必须使用 64 位架构。更多信息参考:Apple 官方文档。
包结构说明
SDK 解压后包含以下主要目录和文件:
| 目录 / 文件 | 说明 |
|---|---|
docs/ | SDK 文档集合 |
| ├─ API 手册 | API 参考文档 |
| ├─ 开发文档 | SDK 使用与集成说明 |
| └─ 版本升级说明手册 | 各版本变更与升级指引 |
icc_profile/ | 色彩配置文件 |
libs/ | 核心库及必需资源 |
samples/ | 示例工程 |
legal.txt | 法律与版权信息 |
release_notes.txt | 版本更新日志 |
getting_started.pdf | 入门指南 |
libs 文件夹说明
libs 目录包含 Foxit PDF SDK iOS 版的核心库、UI 扩展及可选功能模块:
| 分类 | 文件 | 备注 |
|---|---|---|
| 核心 SDK | FoxitRDK.framework / FoxitRDK.xcframework | .xcframework 用于支持 Mac Catalyst 构建 iPad 应用对应的 Mac 版本 |
| UI 扩展 | uiextensions(开源)uiextensionsDynamic.frameworkuiextensionsDynamic.xcframework | — |
| 扫描功能 | pdfscanFoxitPDFScanUI.framework | — |
| 第三方 / 工具 | FoxitPDF.podspecprepare-framework-to-publish-to-appstore.sh | .podspec 为 CocoaPods 配置.sh 用于发布前裁剪 App Store 不接受的架构 |