运行示例程序 (iOS)

福昕 PDF SDK iOS 版 提供多个示例程序（Demo），帮助开发者快速了解 SDK 的 API 使用方式以及在实际应用中的集成方案。所有 Demo 同时提供 Objective-C 和 Swift 两种语言版本，Swift 示例位于 samples/swift 目录下。

在运行示例程序前，请确保已安装以下开发环境：

• Xcode
• iOS 模拟器或真机设备

本文档不包含 Xcode 的安装说明，如尚未安装，请参考 Apple 官方开发者文档。

---

示例程序概览

福昕 PDF SDK iOS 版 提供以下三类示例程序：

Demo 类型	说明
Function Demo	演示 PDF Core API 的基础功能调用
Viewer Control Demo	演示 View Control 层的阅读器功能实现
Complete PDF Viewer Demo	演示接近真实产品形态的完整 PDF 阅读器

说明：

• Swift 版本的 Complete PDF Viewer Demo 支持多文档标签阅读模式
• Mac Catalyst 平台仅提供 Complete PDF Viewer Demo（Objective-C）

---

通用运行步骤

以下步骤适用于大多数 iOS Demo（如无特殊说明）：

1. 在 samples 目录中，双击对应的 .xcodeproj 文件以打开 Demo。
   • Objective-C 示例：samples/function_demo/function_demo.xcodeproj
   • Swift 示例：samples/swift/function_demo_swift/function_demo_swift.xcodeproj
2. 选择 iOS 模拟器或真机设备作为运行目标。
3. 点击 Product → Run 运行 Demo。

提示：
也可以直接打开 samples/samples_xcworkspace，该 Workspace 包含所有示例工程。

---

Function Demo（功能示例）

Function Demo 用于演示如何使用 福昕 PDF SDK iOS 版 的 PDF Core API 实现单一、独立的 PDF 功能，适合快速了解具体接口能力。

包含的示例功能包括：

• pdf2txt：将 PDF 文档内容导出为 TXT 文件
• outline：编辑书签（Outline）的标题和显示样式
• annotation：添加注释并导出为 JSON 文件
• docinfo：导出 PDF 文档的基础信息
• render：将指定页面渲染为 Bitmap
• signature：添加签名、签署 PDF 并验证签名
• image2pdf：将图片转换为 PDF 文件
• watermark：添加文本、水印图片或 PDF 页面水印
• search：在 PDF 文档中搜索文本
• graphics_objects：创建包含图形对象的 PDF 文档

运行成功后，应用界面将列出所有功能入口，点击对应按钮即可执行相关操作。

---

Viewer Control Demo（阅读器控件示例）

Viewer Control Demo 主要展示 福昕 PDF SDK 在 View Control 层提供的典型 PDF 阅读器功能实现方式，适合需要自行构建阅读器 UI 的开发者参考。

该 Demo 演示的功能包括：

• 文本搜索
• 书签（Outline）
• 阅读书签（Reading Bookmarks）
• 注释操作（高亮、下划线、删除线、打字机等）
• 数字签名

Demo 的代码结构清晰，便于快速定位并理解常见 PDF 阅读器功能的实现逻辑。

说明：

• Outline 是 PDF 规范中的技术术语，对应传统 PDF 阅读器中的“书签”
• Reading Bookmarks 为应用层阅读标记，不存储于 PDF 文件中

---

Complete PDF Viewer Demo（完整阅读器示例）

Complete PDF Viewer Demo 展示了一个功能完善、接近真实产品形态的 PDF 阅读器，集成了 福昕 PDF SDK iOS 版 提供的全部核心功能和内置 UI。

不使用 Mac Catalyst（iOS / iPadOS）

• 支持 Objective-C 和 Swift
• Swift 版本支持多文档标签阅读模式

运行后，应用首页将展示内置的示例文件：

• Sample.pdf
• complete_pdf_viewer_guide_ios.pdf

点击切换按钮可进入多文档标签模式，在多个 PDF 文档之间切换浏览。

提示：
如需测试其他 PDF 文件，请将文件拷贝至设备的 Documents 目录。

---

使用 Mac Catalyst（macOS）

福昕 PDF SDK iOS 版（Mac Catalyst）提供一个 Complete PDF Viewer Demo（Objective-C），用于演示如何将 iPad 应用构建为 Mac 应用。

运行要求：

• macOS 10.15 或以上
• Xcode 11 或以上

运行步骤：

1. 打开 samples/complete_pdf_viewer/complete_pdf_viewer.xcodeproj
2. 将运行目标选择为 My Mac
3. 点击 Product → Run 启动 Demo

该 Demo 提供的功能与 iOS 版本基本一致。

注意： 运行 Mac Catalyst Demo 可能需要配置支持在 Mac 上运行的开发证书（Provisioning Profile）。