福昕开发者文档中心

入门指南 ​

本文说明福昕 PDF SDK 鸿蒙版的开发环境、HarmonyOS / OpenHarmony 支持范围，以及发版包目录结构。完成环境与包结构确认后，可继续 初始化、运行示例 或 快速构建。

环境配置 ​

环境要求 ​

版本说明：

  • 从 SDK 2.1 版本开始，OpenHarmony SDK 最低支持版本已更新为 ≥ 5.0 Release (API Level 12)
  • 如需使用 SDK 2.0 及以下版本，OpenHarmony SDK 最低支持版本为 ≥ 4.1 Release (API Level 12)，并推荐获取与 OpenHarmony Release 版本配套的 IDE 进行开发。

系统要求 ​

  • arm64-v8a 和 x86_64 架构

HarmonyOS 与 OpenHarmony 支持差异 ​

福昕 PDF SDK 鸿蒙版同时面向 HarmonyOS 与 OpenHarmony。自 3.0 起，平台支持差异如下：

组件与预置 HAR ​

平台PDFViewCtrl（FoxitRDK.har）UIExtensions（预置 FoxitRDKUIExtensions.har）UIExtensions 源码（libs/uiextensions）
HarmonyOS支持支持，可直接使用随包提供，便于定制
OpenHarmony支持尚未完整支持（试验性）已按 HMS / OH 分目录实现；依赖 HMS 的能力（如 TTS）在 OH 上为空实现，功能不可用，但主工程可编译

NOTE

  • OpenHarmony 若需 UIExtensions：请基于随包 libs/uiextensions 自行配置并编译 HAR。

示例工程 ​

平台示例
OpenHarmony基础显示示例 view_ctrl_demo
HarmonyOSview_ctrl_demo，以及功能完整的阅读器示例 complete_pdf_viewer（Complete Viewer）

授权码 ​

从 SDK 2.1 版本开始，两个操作系统平台可以使用同一个授权码。SDK 2.0 及以下版本需要使用不同的授权码。

包结构说明 ​

提示：

  • 预置 FoxitRDKUIExtensions.har 面向 HarmonyOS 完整能力；OpenHarmony 请按上文「试验性」说明处理。
  • 配置项说明见包内 docs/uiextensions_config.md，在线文档见 配置项说明。

鸿蒙版 SDK 包解压后，内容结构如下：

docs/
├── API 手册（如 FoxitPDFSDK_HarmonyOS_API_Reference.html）
├── uiextensions_config.md（配置项说明）
└── …
libs/
├── uiextensions/          （UIExtensions 开源工程）
├── FoxitRDK.har
├── FoxitRDKUIExtensions.har
├── xxx_key.txt / xxx_sn.txt
samples/
├── complete_pdf_viewer/   （Complete Viewer，推荐在 HarmonyOS 体验）
└── view_ctrl_demo/        （基础 PDFViewCtrl 示例）
legal.txt
release_notes.txt

libs 文件夹说明 ​

  • uiextensions/: 开源库，提供一系列即用型 UI 模块，帮助开发者快速嵌入功能丰富的 PDF 阅读器，并允许按需自定义 UI。
  • FoxitRDK.har: 包含 ArkTS API 及 .so 库，是 SDK 的核心部分，支持 arm64-v8a 和 x86_64 架构。
  • FoxitRDKUIExtensions.har: 由 uiextensions 工程编译生成，包含内置 UI 实现及所需资源（图片、字符串、颜色、布局等）。
  • xxx_key.txt 和 xxx_sn.txt: 初始化 SDK 所需的授权信息。