1efb9d172f
- 新增字体选择（系统/宋体/圆体/等宽）与暗色图片柔化配置 - 文本选择改为自定义手势+操作栏（拷贝/高亮/批注） - 添加 accessibilityIdentifier 支持自动化 UI 测试 - 新增 UITests 覆盖阅读器打开/关闭、工具栏、设置面板、批注等 - 添加 Demo 测试用 EPUB 书源（宝山辽墓材料与释读） - 新增文档：UI 自动化测试、功能开发计划、阅读器规划
3.0 KiB
3.0 KiB
ReadViewSDK 文档索引
架构与规范
| 文档 | 说明 |
|---|---|
| ARCHITECTURE.md | 四层架构总览（EPUBCore → EPUBTextRendering → RDReaderView → EPUBUI）、数据流、分页模式、位置模型、已知限制 |
| CODING_STYLE.md | 命名规范（RD/RDEPUB 前缀）、分层规则、UI 布局规范、代码风格细则、extension 拆分、SS→RD 迁移计划 |
| EPUB_MAINTENANCE.md | 文件职责表、DTCoreText 渲染管线、常见排查场景、推荐日志断点、阅读器后续能力规划 |
模块功能实现逻辑
| 文档 | 对应模块 | 说明 |
|---|---|---|
| EPUBCore_功能实现逻辑.md | Sources/RDReaderView/EPUBCore/（31 Swift + 2 资源） |
EPUB 解析全流程（ZIP→container.xml→OPF→spine/TOC）、阅读会话状态机、离屏分页测量、ss-reader:// 资源协议、JS 桥接（6 种消息）、WebView 渲染管线、文本锚点定位、渲染请求模型、缓存策略 |
| EPUBTextRendering_功能实现逻辑.md | Sources/RDReaderView/EPUBTextRendering/（13 文件） |
DTCoreText HTML→NSAttributedString 渲染管线、片段标记注入/提取、CoreText 分页引擎（含语义边界调整）、文本索引表、Location↔PageNumber 双向转换、分页缓存、性能采样、全文搜索引擎、纯文本构建器 |
| RDReaderView_功能实现逻辑.md | Sources/RDReaderView/ReaderView/（5 文件） |
四种显示模式（pageCurl/horizontalScroll/verticalScroll/horizontalCoverScroll）、DataSource/Delegate 协议、点击三区域翻页、工具栏动画、双页配对与哨兵页、横竖屏适配、RTL 支持 |
| EPUBUI_功能实现逻辑.md | Sources/RDReaderView/EPUBUI/（19 文件） |
RDEPUBReaderController 全生命周期、三条渲染路径分发、配置变更检测与响应、工具栏/目录/高亮/书签/搜索/设置面板交互流、阅读位置持久化、主题管理、CoreText 页面交互 |
方案讨论文档
| 文档 | 说明 |
|---|---|
| ReflowableEPUB_WXReadRenderer_Design.md | 基于读书的 CoreText 渲染架构，设计 Reflowable EPUB 的增强文本渲染方案（CSS 分层、类型器升级） |
测试与质量
| 文档 | 说明 |
|---|---|
| UI自动化测试工作文档.md | XCUITest UI 自动化测试完整工作计划：现状分析、accessibilityIdentifier 补充清单、UI Test Target 创建、测试用例设计（书库/阅读器/工具栏/设置/书签/高亮/目录/截图）、CI 集成方案、实施检查清单 |
目录约定
Doc/：项目级文档（架构、规范、维护指南、模块实现逻辑）Doc/FeatureSolution/：方案讨论文档（由discuss-sdk-feature-solutionskill 生成）