# 本地漫画阅读器

**Repository Path**: fufan1025/local-comic-reader

## Basic Information

- **Project Name**: 本地漫画阅读器
- **Description**: 一份 all in ai 由原生安卓组件构成的本地漫画阅读器。
- **Primary Language**: Android
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-08
- **Last Updated**: 2026-05-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Android, 阅读器, 漫画

## README



# 本地漫画阅读器 (Local Comic Reader)

一个 Android 平台的本地漫画阅读器应用，支持从 ZIP 文件导入漫画图片，并提供流畅的阅读体验。

## 功能特性

- **漫画导入**：支持从本地选择 ZIP 文件导入漫画，自动提取图片并生成封面；支持批量导入多个 ZIP 文件
- **漫画浏览**：以网格或列表形式展示已导入的漫画，显示封面和标题
- **阅读进度跟踪**：自动记录每本漫画的阅读进度，退出后再次打开可继续阅读；显示阅读进度百分比
- **缩放阅读**：支持多点触控缩放图片，带来更舒适的阅读体验
- **主题切换**：支持深色/浅色主题跟随系统设置切换
- **显示模式切换**：支持网格视图和列表视图两种显示模式
- **批量操作**：支持长按选择多本漫画进行批量删除和重命名

## 技术栈

- **语言**：Java
- **最低 SDK**：21 (Android 5.0)
- **目标 SDK**：30 (Android 11)
- **架构模式**：MVVM + Repository
- **主要依赖**：
  - Room：本地数据库存储
  - AndroidX Lifecycle：ViewModel 和 LiveData
  - RecyclerView：列表展示
  - ViewPager2：图片浏览

## 项目结构

```
app/src/main/java/com/example/myapplication/
├── Comic.java              # 漫画数据实体
├── ComicDao.java           # 数据访问接口
├── ComicDatabase.java      # Room 数据库
├── ComicRepository.java    # 数据仓库
├── ComicViewModel.java     # 漫画 ViewModel
├── ComicAdapter.java       # 漫画列表适配器（支持网格/列表模式）
├── HomeFragment.java       # 主页 Fragment
├── MainActivity.java       # 主界面 Activity
├── ReaderActivity.java    # 阅读器 Activity
├── PageAdapter.java        # 页面适配器
├── ProfileFragment.java    # 设置页面 Fragment
├── RecentReadAdapter.java # 最近阅读适配器
├── ZoomableImageView.java  # 可缩放图片视图
└── Utils.java              # 工具类
```

## 使用说明

### 导入漫画

1. 点击界面底部的"+"按钮
2. 选择手机中的 ZIP 漫画文件
3. 输入漫画名称（如名称已存在将自动检测并提示）
4. 等待导入完成

### 阅读漫画

1. 在主页点击漫画封面
2. 进入阅读界面，左右滑动翻页
3. 点击屏幕中央显示/隐藏控制栏
4. 双指缩放图片查看细节
5. 拖动底部滑块快速跳转页面

### 管理漫画

- **长按漫画**：弹出操作菜单（重命名、删除）
- **多选模式**：长按进入多选模式，可批量删除和重命名多本漫画
- **设置页面**：可清除所有阅读进度

## 编译构建

```bash
# 使用 Gradle 打包 debug 版本
./gradlew assembleDebug

# 打包 release 版本
./gradlew assembleRelease
```

生成的 APK 文件位于 `app/release/` 目录下。

## 许可证

MIT License