feat(wxread): align pagination, rendering, and docs

This commit is contained in:
shen
2026-05-24 15:36:01 +08:00
parent a318c0e3d0
commit 2a94921e88
103 changed files with 6124 additions and 4623 deletions
+3 -3
View File
@@ -2,7 +2,7 @@
## 这是什么
`ReadViewSDK` 是一个 iOS 阅读 SDK`RDReaderView`),提供 EPUB/TXT 的打开、分页与阅读器 UI,并包含一个用于演示集成的 Demo 工程(`ReadViewDemo`)。当前项目面向 **brownfield(已有代码)**,目标是对现有 reflowable EPUB 阅读内核做一次直接重构:在旧引擎基础上演进为参考微信读书(WXRead)的原生渲染方案,而不是保留并行的第二套原生引擎。
`ReadViewSDK` 是一个 iOS 阅读 SDK`RDReaderView`),提供 EPUB/TXT 的打开、分页与阅读器 UI,并包含一个用于演示集成的 Demo 工程(`ReadViewDemo`)。当前项目面向 **brownfield(已有代码)**,目标是对现有 reflowable EPUB 阅读内核做一次直接重构:在旧引擎基础上演进为参考读书(WXRead)的原生渲染方案,而不是保留并行的第二套原生引擎。
## 核心价值
@@ -46,14 +46,14 @@
- Fixed Layout EPUB:继续使用 `WKWebView`,不切换到 WXRead 渲染方式
- 交互式 EPUB(含 JS / 音视频 / 表单 / iframe / 外链 / 脚本桥接等):继续使用 `WKWebView`,不切换到 WXRead 渲染方式
- 当前翻页代码(包括 `RDReaderView` 及其现有翻页模式/翻页交互逻辑):不做修改
- 直接拷贝使用微信读书私有 JS/CSS/私有实现代码:不做
- 直接拷贝使用读书私有 JS/CSS/私有实现代码:不做
- 同时保留两套 reflowable 原生引擎:不做
## 背景与上下文
- 仓库形态:iOS SDK + Demo AppDemo 通过 CocoaPods 以本地 `:path` 引入 SDK。
- 当前分层:`EPUBCore`(解析/分页/状态)、`EPUBUI`(阅读器 UX)、`EPUBTextRendering`TXT/TextBook / reflowable 原生文本渲染)、以及 `LegacyRDReaderController`(历史实现并存)。
- WXRead 参考资料位于 `Doc/WXRead/`,包含对微信读书 EPUB 阅读器的逆向分析文档与相关符号/源码片段。
- WXRead 参考资料位于 `Doc/WXRead/`,包含对读书 EPUB 阅读器的逆向分析文档与相关符号/源码片段。
- 当前 `.textReflowable` 主路径已基于 `DTCoreText` / `NSAttributedString` / CoreText 分页,但分页能力、页面语义、自定义属性体系与复杂块元素处理仍远弱于 WXRead。
## 约束