福昕开发者文档中心

入门指南 ​

安装并集成 Foxit PDF SDK 鸿蒙库非常简单。您只需要几分钟就能见证其强大的功能。本指南主要介绍如何在鸿蒙平台使用福昕 PDF SDK。本章的主要内容是包结构的介绍以及如何运行 demo。

系统要求 ​

鸿蒙设备要求

  • 支持arm64-v8a和 x86_64架构
  • HarmonyOS Next SDK 5.0.0(12)

DevEco Studio NEXT Developer Beta3

包中 Demos 的运行环境：

  • Build #DS-233.14475.28.36.503600
  • Build Version: 5.0.3.600, built on August 7, 2024
  • Runtime version: 17.0.10+1-b1087.17 aarch64
  • VM: OpenJDK 64-Bit Server VM by JetBrains s.r.o.

包结构说明 ​

下载 "foxitpdfsdk_2_0_harmonyos_next.zip" 包，解压到一个新的目录如 "foxitpdfsdk_2_0_harmonyos_next"，如下图所示。其中解压包中包括如下的内容：

文件夹描述
docsAPI手册，开发文档，说明手册
libsLicense文件，HAR库，UI Extensions组件源代码
samples鸿蒙示例工程
legal.txt法律和版权信息
release_notes.txt发布信息

release_package.png

"libs" 文件夹是 Foxit PDF SDK 鸿蒙版的核心组件，如下图所示。

core_components.png

其中：

  • uiextensions 工程 – 在 libs 文件夹下。它是一个开源库，包含了一些即用型的 UI 模块实现，可以帮助开发人员快速将功能齐全的 PDF 阅读器嵌入到他们的鸿蒙应用中。当然，开发人员也可以通过 "uiextensions" 工程为特定的应用灵活自定义和设计 UI。

  • FoxitRDK.har – 包含了 Foxit PDF SDK 鸿蒙版所有的 TS APIs，以及 ".so" 库。".so" 库是 SDK 的核心，包含了 Foxit PDF SDK 鸿蒙版的核心函数。它针对每种架构单独编译，当期支持 arm64-v8a 和 x86_64 架构。

  • FoxitRDKUIExtensions.har – 由 libs 目录下的 "uiextensions" 工程编译生成。包含内置UI实现，以及 UI 所需要的资源文件，如图片，字符串、颜色值、布局文件以及其他 UI 资源。

运行 demo ​

下载和安装DevEco Studio IDE (https://developer.huawei.com/consumer/cn/download/deveco-studio)。

Foxit PDF SDK 鸿蒙版为开发人员提供了一个 Complete PDF Viewer demo，位于 samples 目录下。该 demo 阐述了如何通过使用 Foxit PDF SDK 鸿蒙版实现一个功能齐全的 PDF 阅读器，该阅读器几乎可以作为实际移动端的 PDF 阅读器使用。该 demo 使用了 Foxit PDF SDK 鸿蒙版所提供的所有功能和内置 UI 实现。

在 DevEco Studio 中运行该 demo，请按如下的步骤：

a) 在 DevEco Studio 中打开 demo，通过 "File -> Open…", 然后找到 Complete PDF Viewer demo 所在的位置，选择 complete_pdf_viewer。点击 "OK"。

b) 开启一个鸿蒙设备或者模拟器。在本章中，将使用模拟器来运行 demo。在运行该 demo 时，samples\complete_pdf_viewer\app\src\main\assets 目录下的 "欢迎使用福昕PDF编辑器.pdf" 文件将会被自动拷贝到模拟器的沙盒目录下。

c) 点击 "Run -> Run 'entry'" 来运行 demo。当在模拟器上安装成功后，会显示 Complete PDF Viewer demo 的主页，点击 "所有 PDF"，然后点击 "欢迎使用福昕PDF编辑器.pdf" 文档，可以看到如下图所示的功能选项。该 demo 实现了一个功能齐全的PDF阅读器，请随意体验。

demo_result.png