Skip to content

ceasarXuu/Hongbaoshu

Repository files navigation

Hongbaoshu - Android 电子书应用

⚠️ 重要免责声明 / IMPORTANT DISCLAIMER

本项目仅供 技术研究与学习交流 使用 (For Educational and Research Purposes Only)。

  1. 版权归属:本项目中展示的所有文本、音频及相关素材,其版权均归原作者及出版发行方所有。本项目 不拥有 任何相关内容的版权。
  2. 非商业用途:本项目 严禁 用于任何形式的商业盈利活动。任何个人或组织不得将本项目或其衍生产品用于销售、付费下载或通过广告获利。
  3. 无侵权意图:开发者的初衷仅为探索 Android 原生开发技术(如 Compose UI、ExoPlayer 音频处理等),无意侵犯任何第三方的知识产权。
  4. 责任豁免
    • 使用者应在下载后的 24 小时内自行删除相关资源。
    • 如因使用本项目产生任何版权纠纷或法律责任,概由使用者自行承担,与项目开发者无关。
    • 如果您是版权所有者,且认为本项目侵犯了您的合法权益,请联系开发者,我们将立即删除相关内容。

下载或克隆本项目即代表您完全接受上述条款。


TODO

  • 预计在 2.0.0 版本进行播放器的容器化升级,设计成为独立的阅读器,与资源进行分离,支持导入更多其他作品。

📖 项目简介

这是一个基于 Jetpack Compose 构建的现代化 Android 电子书阅读器应用。它不仅提供了优雅的阅读体验,还深度集成了 "听书" 功能,支持段落级的高亮跟随朗读。

📱 如何使用

安装

您可以在本项目的 Releases 页面下载最新的安装包进行体验。

⚠️ 关于安全警告: 由于应用通过 GitHub 直接分发(未经 Google Play 验证),安装时可能会收到安全软件的警告提示。这是正常现象,本应用是开源项目,不包含任何恶意代码。

应用安全信息

  • 开源透明: 所有源代码公开可审计
  • 无数据收集: 不收集任何用户信息
  • 无网络请求: 应用不需要网络权限
  • 本地存储: 所有数据仅存储在本地设备

验证应用完整性

为确保下载的应用未被篡改,您可以验证 APK 的签名指纹:

# 使用 apksigner 验证
apksigner verify --print-certs app-release.apk

# 或使用 keytool
keytool -printcert -jarfile app-release.apk

官方签名 SHA-256 指纹会在每个 Release 页面中公布。

编译运行

如果您是开发者,可以克隆本项目进行编译:

  1. 克隆仓库:
    git clone [您的仓库地址]
  2. 在 Android Studio 中打开项目。
  3. 同步 Gradle 依赖。
  4. 连接 Android 设备或模拟器,运行 Run 'app'

自动化构建 (Dev)

我们提供了一个脚本来简化发布包的构建流程(自动处理版本号更新、签名与重命名):

# 在项目根目录下执行
# -v 参数指定新的版本名称 (VersionName)
./build_release.sh -v 1.1.0

构建成功后,APK 将生成在 app/build/outputs/apk/release/ 目录下,并命名为 hongbaoshu_v1.1.0.apk

📖 操作指南

1. 基础浏览

  • 进入阅读:点击封面即可进入阅读模式。
  • 翻页操作:在屏幕任意位置左右滑动。

2. 功能菜单

  • 唤出/隐藏:单机屏幕
  • 目录跳转:点击底部菜单栏的“目录”图标,选择章节跳转。
  • 朗读功能:点击底部菜单栏的“播放/暂停”图标,开始/暂停朗读。
  • 夜间模式:点击底部菜单栏的“月亮/太阳”图标切换深色/浅色主题。
  • 字体调节:点击底部菜单栏的“字体”图标 (Aa),滑动调节字体大小。

3. 听书功能 (TTS)

  • 快速播放
    • 点击即读:直接点击正文中的任意段落,即可开始从该段朗读(自动高亮当前句)。
    • 菜单控制:通过底部菜单栏的“播放/暂停”按钮控制。
  • 高级播放设置 (点击底部“耳机”图标打开面板):
    • 倍速调节:滑动滑块调整语速 (0.5x - 1.5x)。
    • 定时关闭:支持设置倒计时或“本章播完停止”。
    • 句段切换:手动控制上一句/下一句。
    • 指定句子开始朗读:双击某个句子开始朗读。

📄 开源协议

本项目代码部分遵循 MIT 协议开源。 注意:项目中包含的媒体资源(/src/main/assets/ 下的音频与文本)排除在开源协议保护之外,请遵守相关法律法规。

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published