# ios_flutter_reader

**Repository Path**: arongwang_admin/ios_flutter_reader

## Basic Information

- **Project Name**: ios_flutter_reader
- **Description**: 开源阅读ios版
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-16
- **Last Updated**: 2026-04-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# legado_reader

Legado（开源阅读）的 Flutter 实现骨架，已实现 **书源管理、搜索、网络书阅读、本地 TXT 导入与阅读** 与规则引擎对接。

### 已实现

- **书源**：列表、启用开关、滑动删除、JSON 单条/批量导入、编辑保存（`features/source/`）。
- **搜索**：多启用书源分批并发、`AnalyzeUrl` 解析后的 GET/POST、`<n1,n2,…>` 分页、`{{key}}`/`{{page}}`、结果去重、各书源成功/失败明细、页码、加入书架（`upsertBook`）/加入并阅读（`features/search/`）；书源内 `<js>` / WebView 登录仍待接。
- **阅读器**：网络书拉取 `ruleBookInfo` → `ruleToc` → `ruleContent`；本地 TXT 按章节文件阅读；目录底部弹层、章节切换；**阅读设置**（边距、行距、字号、背景色、日间/夜间/跟随系统、上下滚动 / 横向翻章 / 书本式阴影）；**竖屏滚动位置**写入 `durChapterPos` 并在下次打开恢复；底部 **LinearProgressIndicator + 百分比**；顶栏 **当前章节标题**（`features/reader/`，偏好 `data/reader_preferences.dart`）。
- **本地 TXT**：书架页旁小 FAB「导入 TXT」；`core/local_txt/local_txt_chapter_splitter.dart` 按常见「第×章 / Chapter n / 序章…」切章；落盘 `local_books/<uuid>/source.txt` 与 `chapters/*.txt`；`BookRecord.typeLocalTxt` + `origin = __local_`_（`data/bookshelf_store.dart`）。
- **书架**：本地 JSON 存储（`data/bookshelf_store.dart`），`putBook` / `upsertBook`。

### 打包与品牌配置

应用名、图标、Android `applicationId` / iOS Bundle ID、签名与 `apk`/`aab`/`ipa` 构建步骤见：**[docs/APP_PACKAGING_AND_BRANDING.md](docs/APP_PACKAGING_AND_BRANDING.md)**。

### 依赖说明

- 正文展示使用 `flutter_html`。
- 本地文件使用 `file_picker`、`path_provider`。
- 与 Legado Android 完整行为差距见代码注释（JS 书源、`ajax`、WebView、真实 3D 卷页动画等）。

### 规划（后续）

- 更贴近真实的 **3D 卷页** 动画；**EPUB** 等格式。
- 章节规则可配置 / 与 Legado `txtTocRule` 对齐；按 **字符进度** 估算全书百分比（当前为按章）。