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、状态机、内存警告、预加载、位置恢复等
171 lines
4.7 KiB
Swift
171 lines
4.7 KiB
Swift
import UIKit
|
|
|
|
final class RDEPUBChapterRuntimeStore {
|
|
|
|
private let chapterDataCache = RDEPUBChapterDataCache()
|
|
|
|
private let pageCountCache = RDEPUBPageCountCache()
|
|
|
|
let imageCache = NSCache<NSString, UIImage>()
|
|
|
|
let chapterLoadQueue = DispatchQueue(label: "com.rdreader.chapterload", qos: .userInitiated)
|
|
|
|
private let chapterLoadQueueKey = DispatchSpecificKey<Void>()
|
|
|
|
private(set) var currentSpineIndex: Int?
|
|
|
|
private(set) var windowSpineIndices: [Int] = []
|
|
|
|
private var pendingNavigationTarget: Int?
|
|
|
|
private let navigationLock = NSLock()
|
|
|
|
private var pendingPrefetchTargets: Set<Int> = []
|
|
|
|
private let prefetchLock = NSLock()
|
|
|
|
private(set) var isBuilding: Bool = false
|
|
|
|
private let buildingLock = NSLock()
|
|
|
|
private var buildingCFIMapSpineIndices: Set<Int> = []
|
|
|
|
private let cfiMapLock = NSLock()
|
|
|
|
init() {
|
|
|
|
imageCache.countLimit = 50
|
|
|
|
chapterLoadQueue.setSpecific(key: chapterLoadQueueKey, value: ())
|
|
}
|
|
|
|
func assertNotOnChapterLoadQueue() {
|
|
dispatchPrecondition(condition: .notOnQueue(chapterLoadQueue))
|
|
}
|
|
|
|
func chapterData(for spineIndex: Int) -> RDEPUBRuntimeChapter? {
|
|
return chapterDataCache[spineIndex]
|
|
}
|
|
|
|
func pageCount(for key: RDEPUBChapterCacheKey) -> RDEPUBRuntimePageCount? {
|
|
return pageCountCache[key]
|
|
}
|
|
|
|
func insertChapter(_ chapter: RDEPUBRuntimeChapter) {
|
|
chapterDataCache[chapter.spineIndex] = chapter
|
|
}
|
|
|
|
func insertPageCount(_ pc: RDEPUBRuntimePageCount, for key: RDEPUBChapterCacheKey) {
|
|
pageCountCache[key] = pc
|
|
}
|
|
|
|
func setCurrentChapter(spineIndex: Int, totalSpineCount: Int, windowRadius: Int = 1) {
|
|
currentSpineIndex = spineIndex
|
|
let radius = max(0, windowRadius)
|
|
let lowerBound = max(0, spineIndex - radius)
|
|
let upperBound = min(totalSpineCount - 1, spineIndex + radius)
|
|
guard lowerBound <= upperBound else {
|
|
windowSpineIndices = [spineIndex]
|
|
return
|
|
}
|
|
windowSpineIndices = Array(lowerBound...upperBound)
|
|
}
|
|
|
|
func evictableSpineIndices() -> [Int] {
|
|
let windowSet = Set(windowSpineIndices)
|
|
return chapterDataCache.storedSpineIndices.filter { !windowSet.contains($0) }
|
|
}
|
|
|
|
func evict(spineIndex: Int) {
|
|
chapterDataCache.remove(spineIndex: spineIndex)
|
|
pageCountCache.remove(forSpineIndex: spineIndex)
|
|
}
|
|
|
|
func evictAllExceptCurrent() {
|
|
guard let current = currentSpineIndex else {
|
|
chapterDataCache.removeAll()
|
|
pageCountCache.removeAll()
|
|
return
|
|
}
|
|
let currentChapter = chapterDataCache[current]
|
|
chapterDataCache.removeAll()
|
|
if let ch = currentChapter {
|
|
chapterDataCache[current] = ch
|
|
}
|
|
|
|
pageCountCache.removeAll()
|
|
}
|
|
|
|
func handleMemoryWarning() {
|
|
evictAllExceptCurrent()
|
|
imageCache.removeAllObjects()
|
|
}
|
|
|
|
func setNavigationTarget(spineIndex: Int) {
|
|
navigationLock.lock()
|
|
pendingNavigationTarget = spineIndex
|
|
navigationLock.unlock()
|
|
}
|
|
|
|
func consumeNavigationTarget() -> Int? {
|
|
navigationLock.lock()
|
|
let target = pendingNavigationTarget
|
|
pendingNavigationTarget = nil
|
|
navigationLock.unlock()
|
|
return target
|
|
}
|
|
|
|
func addPrefetchTarget(_ spineIndex: Int) {
|
|
prefetchLock.lock()
|
|
pendingPrefetchTargets.insert(spineIndex)
|
|
prefetchLock.unlock()
|
|
}
|
|
|
|
func removePrefetchTarget(_ spineIndex: Int) {
|
|
prefetchLock.lock()
|
|
pendingPrefetchTargets.remove(spineIndex)
|
|
prefetchLock.unlock()
|
|
}
|
|
|
|
func clearPrefetchTargets() {
|
|
prefetchLock.lock()
|
|
pendingPrefetchTargets.removeAll()
|
|
prefetchLock.unlock()
|
|
}
|
|
|
|
func hasPrefetchTarget(_ spineIndex: Int) -> Bool {
|
|
prefetchLock.lock()
|
|
let has = pendingPrefetchTargets.contains(spineIndex)
|
|
prefetchLock.unlock()
|
|
return has
|
|
}
|
|
|
|
func markBuilding(_ building: Bool) {
|
|
buildingLock.lock()
|
|
isBuilding = building
|
|
buildingLock.unlock()
|
|
}
|
|
|
|
func beginBuildingCFIMap(for spineIndex: Int) -> Bool {
|
|
cfiMapLock.lock()
|
|
defer { cfiMapLock.unlock() }
|
|
let inserted = buildingCFIMapSpineIndices.insert(spineIndex).inserted
|
|
return inserted
|
|
}
|
|
|
|
func endBuildingCFIMap(for spineIndex: Int) {
|
|
cfiMapLock.lock()
|
|
buildingCFIMapSpineIndices.remove(spineIndex)
|
|
cfiMapLock.unlock()
|
|
}
|
|
|
|
func invalidateAllForSettingsChange() {
|
|
chapterDataCache.removeAll()
|
|
pageCountCache.removeAll()
|
|
imageCache.removeAllObjects()
|
|
cfiMapLock.lock()
|
|
buildingCFIMapSpineIndices.removeAll()
|
|
cfiMapLock.unlock()
|
|
}
|
|
}
|