完全开源Android项目：PDF电子书架软件——不动的大图书馆

不动的大图书馆

Author：雾雨霜星

Web：雾雨霜星 | DA☆ZE (shuangxing.top)

Time：2021-09-04

软件简介

“不动的大图书馆”是一款简单、高效、开源的PDF电子书书架软件。

特点：

• 简单：简洁UI界面；无需用户登录；
• 干净：不带有任何广告，不会插播任何等待打开页面
• 安全：不提供联 接口，不会发送任何用户信息
• 高效：功能清晰，记录每次最后阅读
• 独立：不与任何第三方软件进行交互
• 兼容：适用于任何Android版本的系统
• 轻量：自身体积小，后期所占空间由添加的PDF文件决定
• 开源：源码完全开放，可根据需求自定义

开源地址：不动的大图书馆: 不动的大图书馆(APP)：一款简单、干净、高效、开源的PDF电子书架软件。 (gitee.com)

开源地址(github)：pdf-library-app

下载APK：app-release.apk · 雾雨魔理沙/不动的大图书馆 – 码云 – 开源中国 (gitee.com)

下载APK：pdf-library-app-apk(github)

使用说明

主要有四个页面：主页面(书架与电子书)、搜索页面、阅读页面、目录页面

页面说明

主页面：

• 工具栏左上角的加 按键：创建新书架
• “最近阅读”书架：记录了上次阅读的PDF文件及其页码
• 书架块靠左侧加 按键：对此书架添加PDF文件，进入搜索页面
• 书架块靠右侧菜单按键：下拉展示此书架内的PDF文件
• 长按书架块：对书架进行重命名或者删除操作
• 长按电子书块：对相应书架文件夹下的PDF文件进行重命名或者删除操作
• 点击电子书块：进入阅读页面，打开此PDF文件

搜索页面：

• 返回书架按键：关闭搜索页面，返回主页面
• 从手机中选择文件按键：从手机中选择PDF文件添加到相应的书架
• 从文件夹搜索文件按键：从手机中选择文件夹，搜索此文件夹内的PDF文件，列出搜索结果，点击搜索结果决定是否选择添加

阅读页面：

• 上一页按键：自动翻页到上一页
• 目录按键：进入目录页面
• 下一页按键：自动翻页到下一页

目录页面：

• 左上角的返回按键：关闭目录页面，返回阅读页面
• 目录项左侧的箭头按键：点击下拉展开该目录项的子目录
• 点击目录项块：关闭目录页面并返回阅读页面，翻页到相应的页码

内部存储模式

• APP安装后第一次启动，会在自己的目录路径下建立以下两个文件
  • library文件夹：其内为书架文件夹(每个书架对应一个文件夹)，书架文件夹内为该书架所有的PDF文件
• 关于添加PDF文件：复制操作，而不是移动操作。即原位置的PDF文件不会改变，只是复制多了一份到相应的书架文件夹下。
• 内部存储空间占用：软件自身大小约为20M左右，后期内部存储空间占用为所添加的PDF文件。考虑到某些PDF文件比较大(甚至可能大于25M)，可考虑删除其原本所在位置下的PDF文件。

软件卸载

卸载软件时，其中的library文件夹和recentReadRecord.txt也会被一并删除。故已经复制到了书架文件夹中的PDF文件的复制文件也会被删除。

已知BUG

1. 视图延迟：

• 电子书执行重命名或者删除操作后，书架中PDF文件的顺序未变化，仅视图上变化了。要重新点击展开按键，来实现更改。
• “最近阅读”软件后重开才生效，即不关闭软件，显示上不会改变。但记录文件在阅读页面退出时已更新。

2. 视图缺失：

   对普通书架进行重命名或删除操作后，”最近阅读”书架会在界面消失。重新打开软件即可。

3. 记录延迟：

   “最近阅读”中对应的PDF文件被删除后，记录未发生改变时，打开会直接显示空白。

4. 记录缺失：

   “最近阅读”书架重命名后其内保存的记录会消失。

源码浅析

src/main/java/com.example.ebookapp/

• MainActivity.java：主页面类
  1. 主页面挂载activity_main.xml，文件夹管理器(FileManager)、视图控制管理器(ViewManager)初始化
  2. 视图管理器控制显示书架、”最近阅读”书架
  3. 主页面的ToolBar初始化
• CatalogueActivity.java：目录页面类，主要是控制显示目录列表，设置子目录显示的监听
• PdfViewActivity.java：阅读页面类
  1. 获取上一个页面启动Intent传输过来的PDF文件位置、页码
  2. pdfView的设置：事件监听、渲染风格、文件确定
  3. 完全加载后获取目录树数据
  4. 设置目录页面的回调监听
• SearchBookActivity.java：搜索页面类
  1. 初始化UriFileService
  2. 页面控件初始化，视图控制管理器监听控制页面变化
  3. 配置使用Intent获取URI进行文件访问的回调监听
• Service/Manager/：
  • FileManager：文件管理类
    1. 读取书架文件夹
    2. 删除文件夹或者文件
  • ViewManager：视图控制管理类
    1. 书架显示
    2. 显示”最近阅读”书架
    3. 目录显示
    4. 显示搜索结果列表
  • PermissionManager：权限控制类。主要进行动态获取权限、检查权限状况。
• Service/Service/：提供服务接口的类
  • UriFileService：提供使用Intent获取URI访问文件的服务
    1. 启动Intent获取打开文件、文件树的URI的页面
    2. 文件复制：提供文件URI与目录路径执行复制操作
    3. 获取文件树URI对应文件夹下所有的PDF文件的URI
• Service/Listener/：
  • ListenerAddBook：添加PDF文件的按键的点击事件监听器
  • ListenerCatalogueGoBack：目录页面返回按键的点击事件监听器
  • ListenerCatalogueItemOnClick：目录页面目录项的点击事件监听器
  • ListenerCatalogueSubset：目录页面展示子目录按键的点击事件监听器
  • ListenerCreateShell：创建新书架按键的点击事件监听器
  • ListenerDisplayBook：下拉显示电子书按键的点击事件监听器
  • ListenerDisplayBookRecentRead：下拉”最近阅读”书架显示电子书按键的点击事件监听器
  • ListenerOpenCatalogue：阅读页面打开目录按键的点击事件监听器
  • ListenerRemoveRenameBook：电子书块的长按执行重命名或删除的事件监听器
  • ListenerRemoveRenameRecentRead：”最近阅读”书架长按执行重命名或删除的事件监听器
  • ListenerRenameRemoveShell：普通书架块的长按执行重命名或删除的事件监听器
  • ListenerSearchItemOnClick：搜索结果列表各项的点击事件监听器
  • ListenerToolbarOnClick：主页面的工具栏(ToolBar)点击事件监听器
• Service/Adapter/：各个ListView的子元素数据接口Adapter
  • ListViewAdapter：用于显示：书架电子书、搜索项电子书的ListView的子元素数据接口
  • ListViewCatalogueSubsetAdapter：主要用于显示目录的子目录的ListView每一项的数据接口
• widget/：JavaBean风格抽象类
  • Book：电子书抽象化
  • Shell：书架抽象化
  • MyListView：自定义ListView控件，解决ScrollView中只显示一项的问题
  • TreeNodeData：树形控件数据类（会用于页面间传输，所以需实现Serializable 或 Parcelable）

src/main/res/values/strings.xml

各处显示文本的资源文件，可在此处集中修改显示文本。

外部依赖

使用的外部依赖是：android-pdfview

开源地址：[GitHub – JoanZapata/android-pdfview: DEPRECATED] A fast PDF reader component for Android development

主要用于完成PDF文件的解码、渲染、载入工作。

UI资源

其他

源码中已经做了详细注释。

具体技术实现可以从我的 站上的文章进行了解。

起源

大概就是没事找事然后就做了这么一件事。

之前获得了大量的PDF电子书文件，每次打开WPS来看首先就是广告，然后不小心点到哪里，又是弹出广告…服了=_=。

为了方便此后对PDF电子书和文献的阅读，顺路玩玩Android，于是不动的大图书馆就出现了。

欢迎任何BUG的反馈、新的需求的提出，可在评论区留言或者在我的 站留言。

欢迎对新主题的开发。

参考

Android官方文档：从共享存储空间访问文档和其他文件 | Android 开发者 | Android Developers (google.cn)

关于基本布局：Android——六大基本布局总结_编程小马-CSDN博客_android 布局

关于Android10/11的分区存储策略：Android Q & Android 11存储适配(一) 基础知识点梳理 – 掘金 (juejin.cn)

关于权限的管理：Android权限（Permissions）处理 – 简书 (jianshu.com)

关于PDF文件目录树的解析：Android原生PDF功能实现 – 齐行超 – 博客园 (cnblogs.com)

关于URI的使用：Android中的Uri详解_yy的博客-CSDN博客_android uri

关于URI的使用：Android 调用系统文件管理器在指定路径目录打开文件 – SegmentFault 思否

关于URI与文件管理器：Android文件管理器选择文件，获得文件路径URI转File – 简书 (jianshu.com)

关于Android的系统资源图标：Android系统资源图标android.R.drawable – 竹山一叶 – 博客园 (cnblogs.com)

鸣谢

自然是要感谢我自己。

推广一下：雾雨霜星 | DA☆ZE (shuangxing.top)