福昕开发者文档中心

集成 SDK ​

本文介绍如何在 iOS 工程中集成福昕 PDF SDK，并完成授权初始化。

步骤 1：创建 iOS 工程 ​

  1. 打开 Xcode，选择 File → New → Project…。
  2. 选择 App 模板，点击 Next。
  3. 填写应用信息并创建工程（例如工程名 PDFReader），语言可选 Objective-C 或 Swift。

步骤 2：集成福昕 PDF SDK ​

福昕 PDF SDK iOS 版提供两种集成方式：手动导入 Framework 或通过 CocoaPods。

方式一：手动导入 Framework（推荐快速验证） ​

2.1 拷贝 Framework 到工程 ​

将 SDK 包 libs/ 中的以下文件拷贝到工程目录：

  • 必需（核心）

    • FoxitRDK.framework（或 FoxitRDK.xcframework）

  • 可选（内置 UI / 按需启用）

    • UI Extensions：uiextensionsDynamic.framework（或 .xcframework）
    • 扫描：FoxitPDFScanUI.framework

备注

如需支持 Mac Catalyst 构建（将 iPad 应用运行在 macOS 上），请使用 .xcframework 版本。

2.2 在 Xcode 中添加 Framework ​

  1. 在 Xcode 中选中工程 Target → General → Frameworks, Libraries, and Embedded Content。
  2. 点击 "+" 按钮，选择 Add Other → Add Files…，添加上述 Framework。
  3. 确认 Embed 列设置为 Embed & Sign。

2.3 配置 Build Settings ​

在 Target → Build Settings 中：

  • 搜索 Framework Search Paths，添加 Framework 所在目录路径（如 $(PROJECT_DIR)/libs）。
  • 搜索 Other Linker Flags，添加 -ObjC。

方式二：通过 CocoaPods 集成 ​

SDK 包中提供了 FoxitPDF.podspec，可通过本地 CocoaPods 方式集成。

2.4 创建 Podfile ​

在工程根目录下创建 Podfile：

ruby
platform :ios, '11.0'

target 'PDFReader' do
  use_frameworks!

  # 将路径替换为 SDK libs/ 目录的实际路径
  pod 'FoxitPDF/FoxitRDK', :podspec => 'path/to/libs/FoxitPDF.podspec'
  pod 'FoxitPDF/uiextensionsDynamic', :podspec => 'path/to/libs/FoxitPDF.podspec'
end

2.5 安装依赖 ​

在工程根目录下运行：

bash
pod install

安装完成后，使用 .xcworkspace 文件打开工程。

2.6（可选）启用 UI Extensions ​

如果您需要构建"功能完整的 PDF 阅读器（UI Extensions）"，请确保已添加 uiextensionsDynamic.framework。若您需要深度定制 UI，可直接引入 UI Extensions 源码工程（libs/uiextensions），详见 通过源码自定义 UI 实现。

2.7（可选）启用扫描功能 ​

如果需要扫描功能，请额外添加 FoxitPDFScanUI.framework，并在 Info.plist 中配置相机权限：

xml
<key>NSCameraUsageDescription</key>
<string>需要使用相机进行文档扫描</string>

步骤 3：授权并初始化 SDK ​

在调用任何 Foxit API 之前，必须先完成授权初始化。请参考：试用与授权。