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、状态机、内存警告、预加载、位置恢复等
This commit is contained in:
+20
-1
@@ -1,6 +1,6 @@
|
||||
# 测试说明
|
||||
|
||||
**分析日期:** 2026-06-09(更新)
|
||||
**分析日期:** 2026-06-22(更新)
|
||||
|
||||
## 测试框架与现状
|
||||
|
||||
@@ -102,6 +102,25 @@ xcodebuild test \
|
||||
|
||||
测试报告输出到 `.artifacts/ui-tests/{timestamp}/UI-Test-Report.md`。
|
||||
|
||||
## 架构整改回归重点
|
||||
|
||||
在 2026-06-22 的阅读器架构整改后,以下场景应作为 smoke 回归最小集合:
|
||||
|
||||
- 打开大书后首次进入阅读页
|
||||
- 章节尾页连续翻页,确认跨章节动画无明显卡顿
|
||||
- 目录远跳到未预热章节,再返回当前阅读流
|
||||
- 关闭并重新打开书籍,恢复上次阅读位置
|
||||
- 长按选区、高亮、批注后再次翻页
|
||||
- 打开设置面板调整字号/间距,观察预览与最终全量 repagination
|
||||
|
||||
建议同时记录以下观测项:
|
||||
|
||||
- `prepareOnDemandChapter` 主线程 wall clock
|
||||
- `RDReaderPreloadController` 预加载命中率
|
||||
- `bookPageMap` partial extension / full replacement 次数
|
||||
- 页面静态底图缓存命中率
|
||||
- CFI 延迟构建完成次数与耗时
|
||||
|
||||
## 覆盖率(Coverage)
|
||||
|
||||
- 当前未启用代码覆盖率收集
|
||||
|
||||
Reference in New Issue
Block a user