ReadViewSDK/Doc
shen 7de661eb54 feat: 架构整改 — Context拆分、Runtime拆分、异步章节加载、UI测试覆盖
Phase 1: Context 拆分
- 新增 RDEPUBReaderState/RDEPUBReaderEnvironment/RDEPUBReaderServices
- RDEPUBReaderContext 改为过渡门面,代理到 State/Environment/Services

Phase 2: Runtime 拆分
- 新增 RDEPUBPresentationRuntime 处理分页状态管理
- 新增 RDEPUBChapterWarmupOrchestrator 处理章节预热与加载编排
- RDEPUBReaderRuntime 从 1277 行收缩,公共 API 转发到新 facade

Phase 0.5: 性能优化
- prepareOnDemandChapter 支持异步模式(allowSynchronousLoad: false)
- extendPartialBookPageMapIfNeeded 改为 DispatchGroup 并发加载
- RDEPUBChapterOffsetMap.cfiMap 加 NSLock 保护数据竞争
- CFI Map 构建延迟到后台队列(scheduleDeferredCFIMapBuildIfNeeded)
- RDEPUBTextPageRenderView 引入静态位图缓存
- RDEPUBTextContentView 新增 loadingSpinner 占位页

Phase 3: 状态机
- 新增 RDEPUBNavigationStateMachine(含 DEBUG 合法转换校验)
- 新增 RDEPUBPaginationState 记录分页来源

Review 修复
- makeSummary 重复方法合并
- ensureNavigationTargetAvailable 同步路径加注释标记

UI 测试
- 新增 AsyncChapterLoadingTests(20 个测试,覆盖全部架构整改场景)
- 跨章节翻页、延迟 CFI、状态机、内存警告、预加载、位置恢复等
2026-06-23 08:17:08 +08:00
..
FeatureSolution Reorganize docs and update reader search flows 2026-06-10 08:22:07 +08:00
WXRead docs: 大书优化方案文档与架构分析更新 2026-06-02 21:16:50 +08:00
Android EPUB 阅读器实施方案.md feat: EPUB 阅读器搜索、选中注释、书签 chrome 状态及大量重构优化 2026-06-13 22:48:56 +08:00
API_REFERENCE.md feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化 2026-06-22 20:26:34 +08:00
ARCHITECTURE-CONTEXT.md Reorganize docs and update reader search flows 2026-06-10 08:22:07 +08:00
ARCHITECTURE.md feat: 架构整改 — Context拆分、Runtime拆分、异步章节加载、UI测试覆盖 2026-06-23 08:17:08 +08:00
BUSINESS_LOGIC.md Reorganize docs and update reader search flows 2026-06-10 08:22:07 +08:00
CFI_ISSUES_REVIEW.md feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化 2026-06-22 20:26:34 +08:00
CFI_SUBSYSTEM.md feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化 2026-06-22 20:26:34 +08:00
CHAPTER_RUNTIME.md feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化 2026-06-22 20:26:34 +08:00
CONCERNS.md Reorganize docs and update reader search flows 2026-06-10 08:22:07 +08:00
CONVENTIONS.md Reorganize docs and update reader search flows 2026-06-10 08:22:07 +08:00
EPUBCore_CODE_REFERENCE.md feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化 2026-06-22 20:26:34 +08:00
EPUBTextRendering_CODE_REFERENCE.md feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化 2026-06-22 20:26:34 +08:00
EPUBUI_CODE_REFERENCE.md feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化 2026-06-22 20:26:34 +08:00
index.md feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化 2026-06-22 20:26:34 +08:00
ReaderView_CODE_REFERENCE.md feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化 2026-06-22 20:26:34 +08:00
readoor-vs-readview-feature-gap.md feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化 2026-06-22 20:26:34 +08:00
SDK架构整改路线图.md feat: 架构整改 — Context拆分、Runtime拆分、异步章节加载、UI测试覆盖 2026-06-23 08:17:08 +08:00
TESTING.md feat: 架构整改 — Context拆分、Runtime拆分、异步章节加载、UI测试覆盖 2026-06-23 08:17:08 +08:00
TYPESetter_PIPELINE.md feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化 2026-06-22 20:26:34 +08:00
UML_CLASS_DIAGRAMS.md Reorganize docs and update reader search flows 2026-06-10 08:22:07 +08:00
当前阅读器问题修复开发清单.md feat: EPUB 阅读器搜索、选中注释、书签 chrome 状态及大量重构优化 2026-06-13 22:48:56 +08:00
标准级EPUB定位与兼容能力开发蓝图.md feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化 2026-06-22 20:26:34 +08:00