RustEpubReader

项目概述

RustEpubReader 是一款用 Rust 编写的跨平台 EPUB 阅读器。桌面端基于 egui/eframe，Android 端通过 JNI 桥接核心逻辑并用 Jetpack Compose 构建界面，桌面与移动端共用同一套核心库。

主要功能

• 书库管理：自动记录已打开的书籍、阅读进度与章节位置
• 阅读模式：支持滚动模式与翻页模式，翻页动画可选滑动、覆盖、仿真或无
• 目录导航：侧边栏目录，可随时展开或折叠
• 外观自定义：亮色或暗色主题，可自定义背景色、字体颜色、背景图片及透明度
• 字体设置：自动发现系统字体，可按需切换字体与字号
• 多语言：内置简体中文与 English 界面
• 局域网共享：通过点对点协议在设备间传输书籍，使用 PIN 配对
• Android 支持：JNI 桥接核心逻辑，Jetpack Compose 构建界面

适用人群

• 需要在多个平台阅读 EPUB 电子书的用户
• 希望自定义阅读外观与字体的用户
• 需要在设备间传输书籍的用户

快速上手

1. 桌面端构建：在项目根目录运行 cargo build --release -p rust_epub_reader
2. macOS：从 Release 下载可执行文件，重命名为 RustEpubReader，执行 chmod +x RustEpubReader，必要时执行 xattr -dr com.apple.quarantine RustEpubReader
3. Android：配置 Android NDK 并设置 sdk.dir，用 cargo ndk 编译 android-bridge，将 .so 放入 android/app/src/main/jniLibs/ 对应 ABI 目录
4. Android 打包：在 android/ 目录运行 ./gradlew assembleRelease

核心优势

• Rust 编写，轻量快速
• 桌面端与 Android 共用同一套核心库
• 支持局域网点对点传书，无需中转服务器

系统要求

• 操作系统：Windows、Linux、macOS、Android
• 支持架构：macOS 提供 Apple Silicon 与 Intel 两种产物，Android 支持 armeabi-v7a、arm64-v8a、x86_64
• 额外依赖：Rust 工具链；Android 构建需配置 NDK 与 cargo-ndk

注意事项

• Release 页面目前提供的是可执行文件而不是 DMG 安装包
• Windows 构建会自动嵌入应用图标，需要 rc.exe
• 首次运行若提示来自未识别开发者，需在系统设置中允许或清除隔离属性