KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #claude-code #dsh #dsh-plugin #deepseek-harness #cli #macos #ai-agent #open-source

RustEpubReader

★ 70 Open GitHub ↗

zhongbai's Epub Reader

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# RustEpubReader

一款用 Rust 编写的跨平台 EPUB 阅读器，支持 **桌面端（Windows / Linux / macOS）** 和 **Android**。

## 特性

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

## 项目结构

```
RustEpubReader/
├── core/           # 核心库：EPUB 解析、书库、i18n、局域网共享协议
├── desktop/        # 桌面端（egui/eframe）
├── android-bridge/ # Android JNI 桥接层（cdylib）
└── android/        # Android 工程（Kotlin + Jetpack Compose）
```

## 构建

### 桌面端

```bash
cargo build --release -p rust_epub_reader
```

Windows 下会自动嵌入应用图标（需要 `rc.exe`）。

### macOS 安装说明

Release 页面目前提供的是可执行文件而不是 DMG 安装包：

- `RustEpubReader-macOS-AppleSilicon-*`：适用于 Apple Silicon 芯片 Mac（M1 / M2 / M3 / M4 等）。
- `RustEpubReader-macOS-Intel-*`：适用于 Intel 芯片 Mac。

下载后可按以下方式运行：

1. 将文件重命名为 `RustEpubReader`（可选，但更方便）。
2. 在“终端”中进入下载目录，执行 `chmod +x RustEpubReader`。
3. 首次运行时如果 macOS 提示来自未识别开发者，可在“系统设置 → 隐私与安全性”中选择“仍要打开”，或在终端执行 `xattr -dr com.apple.quarantine RustEpubReader` 后再运行。

后续若提供 DMG，会在 Release 资产中额外发布。

### Android

1. 配置 Android NDK，并在 `android/local.properties` 中设置 `sdk.dir`。
2. 使用 `cargo-ndk` 编译 `android-bridge`：
   ```bash
   rustup target add armv7-linux-androideabi aarch64-linux-android x86_64-linux-android
   cargo ndk -t armeabi-v7a -t arm64-v8a -t x86_64 build --release -p android-bridge
   ```
3. 将产物 `.so` 文件放入 `android/app/src/main/jniLibs/` 对应 ABI 目录。
4. 在 `android/` 目录下运行：
   ```bash
   ./gradlew assembleRelease
   ```

## 依赖

| 用途 | 库 |
|------|----|
| EPUB 解析 | `rbook` |
| HTML 提取 | `scraper` |
| 桌面 UI | `eframe` / `egui` |
| 文件对话框 | `rfd` |
| 图像处理 | `image` |
| Android JNI | `jni` |
| 序列化 | `serde` / `serde_json` |

## License

本项目采用 [Apache License 2.0](LICENSE)。

RustEpubReader

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README