福昕开发者文档中心

入门指南 ​

福昕 PDF SDK 鸿蒙版旨在助力开发者高效构建高性能、跨平台的鸿蒙 PDF 应用。即便您对 PDF 开发知之甚少，也能通过我们的 SDK，仅用数行代码，快速打造专业的 PDF 阅读器。

鸿蒙版 SDK 全面支持 HarmonyOS Next 和 OpenHarmony 操作系统，并与 Android、iOS SDK 共享统一的组件化架构。了解更多，请参阅 探索福昕 PDF SDK 移动端。

我们提供一系列核心功能，旨在帮助应用程序开发者在大幅降低开发成本的同时，快速实现所需功能。功能详情请参阅 福昕 PDF SDK 移动版主要功能列表。

环境配置 ​

环境要求 ​

版本说明：

  • 从 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 Next 与 OpenHarmony 支持差异 ​

福昕 PDF SDK 鸿蒙版在 HarmonyOS Next 和 OpenHarmony 两个操作系统上的支持基本一致，仅在以下方面存在差异：

  1. 组件支持：

    • OpenHarmony：仅提供基础的 PDF 显示类组件。详细信息请参考 SDK 组件概览
    • HarmonyOS Next：提供基础的 PDF 显示类组件和即用型 UIEXTENSION 组件

  2. 示例支持：

    • OpenHarmony： 提供基础显示示例 - view_ctrl_demo
    • HarmonyOS Next：提供基础显示示例 - view_ctrl_demo 和 功能完整的阅读器示例 - complete_pdf_viewer

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

包结构说明 ​

提示：

  • 以下涉及 UIEXTENSIONS 相关库仅适用于 HarmonyOS Next 操作系统。

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

docs/
├── API手册
├── 开发文档
└── 版本升级说明手册
libs/ （包含核心库文件和其他必需资源）
├── uiextensions/ （开源库）
├── FoxiRDK.har
├── FoxiRDKUIExtension.har
├── xxxsdk_key.txt
├── xxxsdk_sn.txt  
samples/
└── 鸿蒙示例工程
legal.txt (法律和版权信息)
release_notes.txt (更新日志)

libs 文件夹说明 ​

  • UIEXTENSIONS/: 开源库，提供了一系列即用型的UI模块实现，帮助开发者快速将功能丰富的PDF阅读器嵌入应用中。此外，还允许根据特定需求自定义 UI。
  • FoxiRDK.har: 包括所有的 ArtTS APIs 及.so库，这是 SDK 的核心部分，支持 arm64-v8a 和 x86_64 架构。
  • FoxitRDKUIExtensions.har – 由 uiextensions 工程编译生成。包含内置 UI 实现，以及 UI 所需要的资源文件，如图片，字符串、颜色值、布局文件以及其他UI资源。
  • xxx_key.txt 和 xxx_sn.txt: 包含初始化 SDK 必须的授权信息。