7de661eb54
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、状态机、内存警告、预加载、位置恢复等
70 lines
1.8 KiB
Swift
70 lines
1.8 KiB
Swift
import Foundation
|
|
|
|
final class RDEPUBChapterOffsetMap {
|
|
|
|
let fragmentOffsets: [String: Int]
|
|
|
|
let pageStartOffsets: [Int]
|
|
|
|
let pageEndOffsets: [Int]
|
|
|
|
private let cfiMapLock = NSLock()
|
|
|
|
private var _cfiMap: RDEPUBCFIMap?
|
|
|
|
var cfiMap: RDEPUBCFIMap? {
|
|
cfiMapLock.lock()
|
|
defer { cfiMapLock.unlock() }
|
|
return _cfiMap
|
|
}
|
|
|
|
let chapterText: String?
|
|
|
|
init(
|
|
fragmentOffsets: [String: Int],
|
|
pageStartOffsets: [Int],
|
|
pageEndOffsets: [Int],
|
|
cfiMap: RDEPUBCFIMap?,
|
|
chapterText: String?
|
|
) {
|
|
self.fragmentOffsets = fragmentOffsets
|
|
self.pageStartOffsets = pageStartOffsets
|
|
self.pageEndOffsets = pageEndOffsets
|
|
self._cfiMap = cfiMap
|
|
self.chapterText = chapterText
|
|
}
|
|
|
|
func updateCFIMap(_ cfiMap: RDEPUBCFIMap) {
|
|
cfiMapLock.lock()
|
|
_cfiMap = cfiMap
|
|
cfiMapLock.unlock()
|
|
}
|
|
|
|
func chapterOffset(forFragmentID fragmentID: String) -> Int? {
|
|
return fragmentOffsets[fragmentID]
|
|
}
|
|
|
|
func chapterOffset(forCFI rawCFI: String?) -> Int? {
|
|
guard let cfi = RDEPUBCFICompatibility.parseLossy(rawCFI) else { return nil }
|
|
let resolved = RDEPUBCFIResolver.resolve(cfi)
|
|
let lastOffset = max((pageEndOffsets.max() ?? 0), 0)
|
|
return RDEPUBCFIRecoveryEngine.recover(
|
|
cfi: cfi,
|
|
cfiMap: cfiMap,
|
|
chapterText: chapterText,
|
|
fragmentOffsets: fragmentOffsets,
|
|
fallbackOffset: resolved.chapterOffset,
|
|
lastOffset: lastOffset
|
|
)?.chapterOffset
|
|
}
|
|
|
|
func pageIndex(forChapterOffset offset: Int) -> Int? {
|
|
for i in 0..<pageStartOffsets.count {
|
|
if offset >= pageStartOffsets[i] && offset <= pageEndOffsets[i] {
|
|
return i
|
|
}
|
|
}
|
|
return nil
|
|
}
|
|
}
|