鸿蒙版本的电子书阅读APP开放源码啦

书籍是人类进步的阶梯，在手机上阅读电子书，既可以学习又可以娱乐。早在2022年出版的《Android Studio开发实战：从零基础到App上线(第3版)》中，笔者就基于Android实现了一个具备翻页浏览功能的电子书APP，不仅支持常见的PDF格式，还支持开放标准EPUB格式，还支持古籍数字化的DJVU格式，可谓小巧的电子书架。

《鸿蒙HarmonyOS 6应用开发:从零基础到App上线》一书作为《Android Studio开发实战：从零基础到App上线(第3版)》的鸿蒙姊妹篇，已将安卓一书的大部分实战项目改造为鸿蒙版本。但在写作鸿蒙一书时，限于时间进度与项目难度，安卓一书的电子书阅读项目未能同步改造为鸿蒙版本，成为鸿蒙一书的小小缺憾。

不过笔者并未放弃，在《鸿蒙HarmonyOS 6应用开发:从零基础到App上线》出版之后，一直记得电子书APP的鸿蒙改造事宜。在鸿蒙官网文档与AI编程工具的加持之下，终于把安卓版本的电子书APP一步步改造成了鸿蒙APP，电子书APP的项目源码添加到了鸿蒙一书的第17章源码（新增章节），具体的源码托管地址为 https://gitee.com/aqi00/harmony/tree/main/chapter17 。

电子书阅读的鸿蒙APP仍然有着简洁的界面，原来安卓版本仅支持PDF、EPUB、DJVU三种格式，而鸿蒙版本扩充支持PDF、EPUB、MOBI、AZW3、DJVU等五种格式，相比安卓版本功能更加强大。下面分别介绍鸿蒙APP是怎样支持这五种格式的。

一、PDF格式的电子书

对于PDF格式的电子书，鸿蒙系统早在5.0.0版本（API 12）就引入了PDF Kit（PDF服务），该服务提供了打开PDF文件、导出PDF图片，以及给页面添加批注、页眉页脚、水印、背景及书签等相关的功能，方便开发者在各种应用场景快捷操作PDF文档。

PDF Kit包含pdfService和PdfView组件，其中PdfView组件又包含了PdfView、pdfViewManager和PdfController。鸿蒙APP对于PDF文档有下列两种处理方式：

1、仅需简单浏览PDF文档时，只要在ArkUI布局中嵌入PdfView组件，然后搭配PdfController加载指定路径的PDF文件即可。

2、需要对PDF文档做增删改操作时，则应采用pdfService加载PDF文档，使用Image组件渲染PDF页面，然后根据定制化需求对PDF文档展开精细化处理。

二、EPUB、MOBI、AZW3等格式

对于EPUB、MOBI、AZW3等格式的电子书，鸿蒙系统从5.0.4版本（API 16）开始引入Reader Kit（阅读服务），该服务提供了包含EPUB、MOBI、AZW3等多种格式电子书的解析、排版、阅读交互能力，开发者可以借助Reader Kit的能力和组件快速构建书籍阅读能力。

Reader Kit包含下列三个组件：

ReadPageComponent（阅读页组件）：这是个ArkUI组件，支持对书籍排版内容的显示、多种翻页交互和翻页动效，以及翻页阅读过程中阅读器所需要的进度、行为感知能力。

bookParser（书籍解析能力）：该模块提供书籍解析的能力，支持解析txt、epub、mobi、azw、azw3等格式的电子书，可将书籍基本信息、书脊内容列表、目录列表和章节内容解析出来。

readerCore（阅读核心能力）：该模块提供阅读页面数据基础类、页面状态、内容分页信息、页面排版属性、组件控制器等能力，主要用于播放、翻页等动作。

三、DJVU格式的电子书

然而对于DJVU格式的电子书，鸿蒙尚未提供官方的解析服务，查找OpenHarmony三方库中心仓，也未发现支持djvu格式的三方解析库，这意味着要么自己手搓，要么改造其他平台的djvu库，可选的改造路线说明如下：

1、采用开源的JavaScript库djvu.js，该库支持在HTML5前端解析、渲染djvu格式文档，无需后端服务、不用安装本地DjVu阅读器。该方案要求开发H5网页，然后嵌入到鸿蒙App的Web组件中，不能由APP原生来解析和渲染djvu文档。

2、采用开源的C/C++库DjVuLibre，该库由djvu格式原作者维护，包含完整的C++解码库、编码器和命令行工具(ddjivu、djvused等)，是兼容性最好的djvu解析库，绝大多数DjVu文件都以它为基准测试。目前Github上的DjVuLibre最新稳定版为3.5.30，该库同时依赖于zlib、libjpeg-turbo等三方库，需要连带移植依赖库。

3、采用Android平台现有的VuDroid/DjvuDroid，该库是DjVuLibre的安卓封装版本，是在Android上的成品移植工程。比如《Android Studio开发实战：从零基础到App上线(第3版)》第15章的实战项目“15.5  实战项目：笔墨飘香之电子书架”就基于VuDroid库浏览DJVU文件。

从上述改造路线可见，如果要用鸿蒙原生来解析和渲染PDF文档，移植安卓平台的VuDroid库是相对容易可行的。于是博主就从VuDroid库着手，把它的NDK编译方式从Android改为HarmonyOS，并且APP的页面布局代码也从安卓的Java+XML改造为鸿蒙的ArkTS+ArkUI。

就DjvuDroid库的鸿蒙版改造而言，主要把安卓端的编译文件Android.mk改写为鸿蒙端的编译文件CMakeLists.txt。改造后的DjVu文件的鸿蒙展示页面如下图所示：

如果您想入门鸿蒙APP开发，或者正在学习鸿蒙开发，电子书APP都是很好的学习项目，不仅用到了多种鸿蒙开发技能，而且兼具实战性和观赏性，对开发者快速掌握鸿蒙开发具有很大的帮助。