# EpubReader

**Repository Path**: zeratulzhou/epub-reader

## Basic Information

- **Project Name**: EpubReader
- **Description**: EpubReader程序， ai生成的测试版
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-06
- **Last Updated**: 2026-03-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EPUB 阅读器

一个使用 .NET MAUI 开发的跨平台 EPUB 电子书阅读器应用程序。

## 功能特性

- **打开 EPUB 文件** - 支持从设备文件系统选择并打开 EPUB 格式的电子书
- **章节导航** - 支持上一章/下一章的便捷导航功能
- **优雅的阅读界面** - 使用 WebView 渲染 HTML 内容，提供良好的阅读体验
- **图书信息显示** - 显示书名和作者信息
- **进度跟踪** - 显示当前阅读章节

## 技术栈

- **.NET MAUI** - 跨平台应用框架
- **VersOne.Epub** (v3.3.4) - EPUB 文件解析库
- **C#** - 编程语言
- **XAML** - 用户界面标记语言

## 支持的平台

- Windows (10.0.19041.0 及以上)
- Android (API 21 及以上)
- iOS (15.0 及以上)
- Mac Catalyst (15.0 及以上)

## 项目结构

```
EpubReader/
├── ViewModels/
│   └── EpubReaderViewModel.cs    # 主视图模型，处理业务逻辑
├── MainPage.xaml                  # 主界面 UI 定义
├── MainPage.xaml.cs               # 主界面代码隐藏
├── MauiProgram.cs                 # 应用程序入口点
├── App.xaml                       # 应用程序资源
├── AppShell.xaml                  # 应用程序壳
└── EpubReader.csproj              # 项目文件
```

## 如何运行

### 前提条件

- .NET 10.0 SDK 或更高版本
- Visual Studio 2022 17.8 或更高版本（推荐）
- 或 Visual Studio Code（配合 C# Dev Kit 扩展）

### 构建步骤

1. 克隆或下载本项目到本地
2. 在终端中导航到项目目录：
   ```bash
   cd EpubReader
   ```

3. 还原 NuGet 包：
   ```bash
   dotnet restore
   ```

4. 构建项目：
   ```bash
   dotnet build
   ```

5. 运行应用：

   **Windows:**
   ```bash
   dotnet build -t:Run -f net10.0-windows10.0.19041.0
   ```

   **Android:**
   ```bash
   dotnet build -t:Run -f net10.0-android
   ```

   **iOS:**
   ```bash
   dotnet build -t:Run -f net10.0-ios
   ```

   **Mac Catalyst:**
   ```bash
   dotnet build -t:Run -f net10.0-maccatalyst
   ```

## 使用说明

1. **打开图书** - 点击顶部的"打开 EPUB"按钮，从文件系统中选择一个 .epub 文件
2. **阅读内容** - 图书内容会在主界面显示
3. **章节导航** - 使用底部的"上一章"和"下一章"按钮在章节间切换
4. **查看进度** - 底部中间会显示当前阅读的章节编号

## 开发说明

### 核心组件

- **EpubReaderViewModel** - 实现 MVVM 模式的视图模型，包含：
  - 图书加载和解析逻辑
  - 章节导航命令
  - 属性变更通知

- **MainPage** - 主视图页面，包含：
  - 顶部工具栏（打开文件按钮）
  - 图书信息显示区域
  - 内容显示区域（WebView）
  - 底部导航栏

### 依赖项

主要依赖项：
- `VersOne.Epub` - EPUB 文件解析
- `Microsoft.Maui.Controls` - UI 框架
- `Microsoft.Maui.Essentials` - 设备功能访问

## 未来改进

可能的改进方向：
- 添加书签功能
- 支持阅读主题切换（日间/夜间模式）
- 字体大小调整
- 目录侧边栏
- 阅读进度保存
- 搜索功能
- 笔记和高亮功能

## 许可证

本项目仅供学习和参考使用。

## 贡献

欢迎提交问题报告和改进建议！

---

**开发工具**: .NET MAUI
**开发语言**: C# + XAML
**EPUB 库**: VersOne.Epub 3.3.4