65 lines
3.7 KiB
Markdown
65 lines
3.7 KiB
Markdown
# 路线图：ReadViewSDK
|
||
|
||
## 概述
|
||
|
||
本次路线图以“**在不扩大范围的前提下**，将 reflowable EPUB 渲染路径替换为参考 `Doc/WXRead/` 的微信读书（WXRead）原生渲染方式”为主线。Fixed Layout 与交互式 EPUB 保持 `WKWebView` 路径不变；除渲染替换所必需的最小改动外，其它能力暂不主动调整。每个 Phase 都以“可验证的稳定性”为完成标准。
|
||
|
||
## Phases
|
||
|
||
- [ ] **Phase 1：对齐现状与改造边界** - 明确 reflowable/Fixed/交互式 的判定与现有路径，锁定不做范围
|
||
- [ ] **Phase 2：WXRead 渲染管线方案落地（reflowable）** - 依据 `Doc/WXRead/` 设计并落地原生渲染入口与最小可用链路
|
||
- [ ] **Phase 3：集成与稳定性回归** - 集成到现有 reader 入口，确保主流程与常见内容稳定可用
|
||
|
||
## Phase Details
|
||
|
||
### Phase 1：对齐现状与改造边界
|
||
**Goal**：明确 reflowable EPUB 当前渲染/分页路径与切换点，制定替换策略与不做边界，确保 `WKWebView` 场景不被误伤。
|
||
**Depends on**：Nothing (first phase)
|
||
**Requirements**：REND-02
|
||
**Success Criteria**（必须为 TRUE）：
|
||
1. 能明确判定一本 EPUB 属于 reflowable / Fixed Layout / 交互式（以工程实现为准）
|
||
2. 固定版式与交互式 EPUB 仍走 `WKWebView`，并形成清晰的“保持不改”约束
|
||
3. 输出一份可执行的实现策略：将 reflowable EPUB 切换到 WXRead 风格原生渲染
|
||
**Plans**：2 plans
|
||
|
||
Plans:
|
||
- [ ] 01-01：阅读 `Doc/WXRead/analysis/*` 与关键 decompiled 符号，提炼“原生渲染”最小管线与可替换点
|
||
- [ ] 01-02：审计现有 `Sources/RDReaderView/EPUBCore` reflowable 渲染/分页路径，确定切入点与迁移策略
|
||
|
||
### Phase 2：WXRead 渲染管线方案落地（reflowable）
|
||
**Goal**：在 SDK 内为 reflowable EPUB 引入 WXRead 风格的原生渲染入口，跑通最小可用链路（可在 Demo 中验证）。
|
||
**Depends on**：Phase 1
|
||
**Requirements**：REND-01, REND-03
|
||
**Success Criteria**（必须为 TRUE）：
|
||
1. reflowable EPUB 可不依赖现有 `WKWebView` 渲染路径完成排版/分页/展示
|
||
2. 渲染结果在 Demo 中可稳定展示（最小支持：段落/标题/基础样式/图片）
|
||
3. 切换判定逻辑清晰、可测，且 Fixed/交互式路径未被影响
|
||
**Plans**：3 plans
|
||
|
||
Plans:
|
||
- [ ] 02-01：定义并实现 reflowable EPUB 的“原生渲染”模块边界（typesetter/layouter/page model 等）
|
||
- [ ] 02-02：对接现有解析与资源加载（manifest/spine/资源寻址），保证图片/CSS/字体等基础资源可用
|
||
- [ ] 02-03：在现有 reader 入口处接入新渲染路径（保持对外 API 尽量不变）
|
||
|
||
### Phase 3：集成与稳定性回归
|
||
**Goal**：把新 reflowable 渲染路径完整集成到阅读器体验中，保证主流程稳定可用，并建立最小回归保障。
|
||
**Depends on**：Phase 2
|
||
**Requirements**：STAB-01, STAB-02
|
||
**Success Criteria**（必须为 TRUE）：
|
||
1. `RDURLReaderController` 打开 `.epub`/`.txt` 的主流程不回归
|
||
2. reflowable EPUB 在常见内容下不出现崩溃/白屏/卡死等关键稳定性问题
|
||
3. Demo 可用于复现与回归验证（至少包含 2-3 本典型 reflowable EPUB 用例）
|
||
**Plans**：2 plans
|
||
|
||
Plans:
|
||
- [ ] 03-01：补齐关键回归用例与诊断手段（日志/开关/快速回退策略）
|
||
- [ ] 03-02：对 reflowable 渲染在真实内容上的问题做收敛与修复，形成可持续迭代基线
|
||
|
||
## Progress
|
||
|
||
| Phase | Plans Complete | Status | Completed |
|
||
|---|---:|---|---|
|
||
| 1. 对齐现状与改造边界 | 0/2 | Not started | - |
|
||
| 2. WXRead 渲染管线方案落地（reflowable） | 0/3 | Not started | - |
|
||
| 3. 集成与稳定性回归 | 0/2 | Not started | - |
|