深入Fulguris会话持久化机制Parcelable与Bundle背后的设计权衡【免费下载链接】Fulguris⚡Web Browser项目地址: https://gitcode.com/gh_mirrors/fu/FulgurisFulguris 是一款开源的 Android 网页浏览器⚡Web Browser它的一项核心体验是会话持久化关闭 App 甚至 App 被系统杀掉后重新打开你的标签页、阅读进度、暗色模式、查找词都会原样恢复。这套体验的背后是 Android 两大序列化机制——Bundle与Parcelable的巧妙组合以及一系列值得新手学习的设计权衡。本文带你从Session、TabModel到落盘写入完整拆解 Fulguris 会话持久化的实现思路。为什么浏览器需要会话持久化浏览器是重状态应用用户可能同时开着十几个标签页每个页面都有自己的加载位置。而 Android 的进程随时可能被系统回收——低内存时、切到后台久了、甚至 App 崩溃时。如果状态只活在内存里用户就会遇到经典痛点重新打开一切归零。Fulguris 为此做了三件事多会话管理可以把一组标签页存成命名会话session随时切换、重命名、删除崩溃恢复检测到异常退出时从备份的恢复会话recovery session找回标签页WebView 级恢复不只保存 URL还保存每个 WebView 自身的滚动位置与页面栈。下面按元数据 → 标签页状态 → 落盘三层来看它的实现。第一层Session 元数据——一个手写 Parcelable会话的元数据由Session这个数据类承载源码位于 app/src/main/java/fulguris/browser/sessions/Session.ktname: String—— 会话名称tabCount: Int—— 会话内标签页数量isCurrent: Boolean—— 是否为当前会话它手写了writeToParcel/describeContents/CREATOR这套标准 Parcelable 实现源码注释中也提到可以用Parcelize注解一键生成。选择 Parcelable 的理由很直白与 Android 系统组件Activity、Service、跨进程传递天然兼容序列化开销小适合频繁存取的轻量元数据。但这里藏着一个新手极易踩坑的设计权衡。仔细看文件的包声明——// We kept this package otherwise it fails to load persisted bundles package acr.browser.lightning.browser.sessions类文件放在fulguris/browser/sessions/目录下包名却刻意保留为旧项目acr.browser.lightning的名字。原因写在注释里Bundle 反序列化时会记录类的完整名称一旦改包名磁盘上旧的持久化文件就再也读不回来作者还提到试过自定义 ClassLoader 也解决不了。 这是全文第一个核心权衡Parcelable 用系统类名寻址换来的是重构枷锁。文件头部的 TODO 也坦承了这一点Dont use Parcelable as it saves the class name in the Bundle and you cant refactor. Instead do it like we did with TabModel.——即下一层的做法。第二层TabModel——把标签页状态装进普通 Bundle每个标签页的完整状态由TabModel描述源码位于 app/src/main/java/fulguris/browser/TabModel.kt。它不是 Parcelable而是一个普通类 一套自定义 Key 的 Bundle 读写Key 常量内容备注URL页面地址基础字符串TITLE页面标题基础字符串DESKTOP_MODE/DARK_MODE桌面模式 / 暗色模式开关布尔值SEARCH_QUERY/SEARCH_ACTIVE页内查找词及是否激活布尔值FAVICON网站图标位图压缩成PNG 字节数组WEB_VIEWWebView 自身的状态 Bundle嵌套 BundletoBundle()与配套的TabModelFromBundle类完成双向转换。这个设计里有几个值得品味的细节favicon 存 PNG 而不是 WEBP。注释里解释得很清楚WEBP 有损压缩反复保存后画质会一轮轮下降PNG 无损反复存盘图标不会糊掉。作者还提到压缩前要先检查isRecycled否则可能抛IllegalStateException此前被崩溃监控真实捕获过。恢复时做了防御性兜底。TabModelFromBundle在 favicon 字节为空时会回退到默认图标——这是从旧版本favicon 可为 null平滑迁移过来的兼容代码。不依赖类名。Bundle 里的数据全部按字符串 Key 存取即使以后重命名TabModel类、挪包旧文件依然可读。这就是第一层 TODO 里说的正解跨版本要长期存活的复杂状态用 Key 化的 Bundle 比 Parcelable 更稳。第三层落盘——Bundle 序列化与原子写文件内存里的 Bundle 最终要写到磁盘。工具类 app/src/main/java/fulguris/utils/FileUtils.java 提供了writeBundleToStorage/readBundleFromStorage写入时用Parcel.obtain()把 Bundle marshal 成字节流写进filesDir读取时用系统 ClassLoader反序列化Bundle(ClassLoader.getSystemClassLoader())保证自定义类能被正确找回。真正的主菜在TabsManager.saveCurrentSession()源码位于 app/src/main/java/fulguris/browser/TabsManager.kt。三个亮点① 零填充索引保证恢复顺序outState.putBundle(TAB_KEY_PREFIX String.format(%05d, index), tab.saveState())标签页用TAB_00000、TAB_00001……这样的 Key 存入 Bundle。注释里的理由很务实零填充让字符串排序即索引排序最多支持 99999 个标签页的有序恢复绰绰有余 :)。最近标签列表则存为一组索引的Int数组。② 临时文件 重命名的原子写写入流程是写临时文件 → 删旧备份 → 旧会话改名为备份 → 临时文件改名为正式会话 → 删备份。全程用 rename 而非原地覆盖任何一步崩溃磁盘上要么有完整旧版本、要么有完整新版本绝不会出现写了一半的坏文件。saveState()还带一道保险——isInitialized为 false 时直接跳过避免空会话覆盖掉全部标签页修复过所有标签页丢失的真实 Bug。③ 写盘放后台线程saveCurrentSession是阻塞操作被丢进iScopeThreadPool协程池执行不卡主线程。源码中留有一段被注释掉的调试循环和作者对连续两次关闭 App 时两个写盘任务并发的困惑记录——这类进程退出时机不可控正是持久化最难的部分也是这段代码最有价值的经验。恢复流程App 启动时发生了什么入口在 app/src/main/java/fulguris/activity/WebBrowserActivity.kt 的initialize(savedInstanceState)与onRestoreInstanceState。恢复路径大致是正常启动读默认会话文件取出各标签页 Bundle崩溃场景走loadRecoverySession()从恢复会话文件找回标签页逐页重建每个标签页经TabModelFromBundle还原 URL、模式、图标WebView 用嵌套 Bundle 走saveState/restoreState恢复页面本身标签创建封装在FreezableBundleInitializer中Freezable意在延迟、冻结 Bundle 的解冻时机多会话操作会话列表、重命名、删除分别由SessionsAdapter、SessionViewHolder、SessionsPopupWindow均在app/src/main/java/fulguris/browser/sessions/目录负责 UI 呈现与交互。核心设计权衡一张表权衡点选择为什么会话元数据序列化Parcelable轻量、系统兼容好配合 UI 快速渲染会话列表标签页复杂状态普通类 Key 化 Bundle不绑定类名可自由重构、跨版本兼容favicon 压缩格式PNG无损反复存盘不降质文件写入策略临时文件 rename 原子替换崩溃安全杜绝半截文件写盘线程后台协程池持久化是阻塞 IO不能卡 UI标签页顺序零填充索引 Key字典序即顺序简单可靠新手可以带走的 5 条 Android 持久化经验Parcelable 类一旦落盘包名和类名就别轻易动——这是 Fulguris 用一整行注释换来的教训跨 App 版本长期存活的数据优先考虑自定义 Key Bundle而非深层嵌套 Parcelable重要文件写入用临时文件 rename永远不要原地覆盖需要有序恢复的集合用零填充编号 Key%05d恢复路径必须做防御性兜底null 回退默认值因为磁盘上的数据可能来自任意旧版本。核心文件索引会话元数据 Parcelableapp/src/main/java/fulguris/browser/sessions/Session.kt标签页状态模型app/src/main/java/fulguris/browser/TabModel.kt会话保存/恢复/多会话管理app/src/main/java/fulguris/browser/TabsManager.ktBundle 读写磁盘工具app/src/main/java/fulguris/utils/FileUtils.java启动与状态恢复入口app/src/main/java/fulguris/activity/WebBrowserActivity.kt会话列表 UIapp/src/main/java/fulguris/browser/sessions/SessionsAdapter.kt、SessionViewHolder.kt、SessionsPopupWindow.ktFulguris 的会话持久化没有引入任何重量级框架靠 Bundle、Parcelable 与文件原子操作就把关 App 不丢页做扎实了——对想理解 Android 底层状态管理的开发者来说这是一份难得的、带真实 Bug 修复痕迹的实战范本。【免费下载链接】Fulguris⚡Web Browser项目地址: https://gitcode.com/gh_mirrors/fu/Fulguris创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 深入Fulguris会话持久化机制：Parcelable与Bundle背后的设计权衡
深入Fulguris会话持久化机制Parcelable与Bundle背后的设计权衡【免费下载链接】Fulguris⚡Web Browser项目地址: https://gitcode.com/gh_mirrors/fu/FulgurisFulguris 是一款开源的 Android 网页浏览器⚡Web Browser它的一项核心体验是会话持久化关闭 App 甚至 App 被系统杀掉后重新打开你的标签页、阅读进度、暗色模式、查找词都会原样恢复。这套体验的背后是 Android 两大序列化机制——Bundle与Parcelable的巧妙组合以及一系列值得新手学习的设计权衡。本文带你从Session、TabModel到落盘写入完整拆解 Fulguris 会话持久化的实现思路。为什么浏览器需要会话持久化浏览器是重状态应用用户可能同时开着十几个标签页每个页面都有自己的加载位置。而 Android 的进程随时可能被系统回收——低内存时、切到后台久了、甚至 App 崩溃时。如果状态只活在内存里用户就会遇到经典痛点重新打开一切归零。Fulguris 为此做了三件事多会话管理可以把一组标签页存成命名会话session随时切换、重命名、删除崩溃恢复检测到异常退出时从备份的恢复会话recovery session找回标签页WebView 级恢复不只保存 URL还保存每个 WebView 自身的滚动位置与页面栈。下面按元数据 → 标签页状态 → 落盘三层来看它的实现。第一层Session 元数据——一个手写 Parcelable会话的元数据由Session这个数据类承载源码位于 app/src/main/java/fulguris/browser/sessions/Session.ktname: String—— 会话名称tabCount: Int—— 会话内标签页数量isCurrent: Boolean—— 是否为当前会话它手写了writeToParcel/describeContents/CREATOR这套标准 Parcelable 实现源码注释中也提到可以用Parcelize注解一键生成。选择 Parcelable 的理由很直白与 Android 系统组件Activity、Service、跨进程传递天然兼容序列化开销小适合频繁存取的轻量元数据。但这里藏着一个新手极易踩坑的设计权衡。仔细看文件的包声明——// We kept this package otherwise it fails to load persisted bundles package acr.browser.lightning.browser.sessions类文件放在fulguris/browser/sessions/目录下包名却刻意保留为旧项目acr.browser.lightning的名字。原因写在注释里Bundle 反序列化时会记录类的完整名称一旦改包名磁盘上旧的持久化文件就再也读不回来作者还提到试过自定义 ClassLoader 也解决不了。 这是全文第一个核心权衡Parcelable 用系统类名寻址换来的是重构枷锁。文件头部的 TODO 也坦承了这一点Dont use Parcelable as it saves the class name in the Bundle and you cant refactor. Instead do it like we did with TabModel.——即下一层的做法。第二层TabModel——把标签页状态装进普通 Bundle每个标签页的完整状态由TabModel描述源码位于 app/src/main/java/fulguris/browser/TabModel.kt。它不是 Parcelable而是一个普通类 一套自定义 Key 的 Bundle 读写Key 常量内容备注URL页面地址基础字符串TITLE页面标题基础字符串DESKTOP_MODE/DARK_MODE桌面模式 / 暗色模式开关布尔值SEARCH_QUERY/SEARCH_ACTIVE页内查找词及是否激活布尔值FAVICON网站图标位图压缩成PNG 字节数组WEB_VIEWWebView 自身的状态 Bundle嵌套 BundletoBundle()与配套的TabModelFromBundle类完成双向转换。这个设计里有几个值得品味的细节favicon 存 PNG 而不是 WEBP。注释里解释得很清楚WEBP 有损压缩反复保存后画质会一轮轮下降PNG 无损反复存盘图标不会糊掉。作者还提到压缩前要先检查isRecycled否则可能抛IllegalStateException此前被崩溃监控真实捕获过。恢复时做了防御性兜底。TabModelFromBundle在 favicon 字节为空时会回退到默认图标——这是从旧版本favicon 可为 null平滑迁移过来的兼容代码。不依赖类名。Bundle 里的数据全部按字符串 Key 存取即使以后重命名TabModel类、挪包旧文件依然可读。这就是第一层 TODO 里说的正解跨版本要长期存活的复杂状态用 Key 化的 Bundle 比 Parcelable 更稳。第三层落盘——Bundle 序列化与原子写文件内存里的 Bundle 最终要写到磁盘。工具类 app/src/main/java/fulguris/utils/FileUtils.java 提供了writeBundleToStorage/readBundleFromStorage写入时用Parcel.obtain()把 Bundle marshal 成字节流写进filesDir读取时用系统 ClassLoader反序列化Bundle(ClassLoader.getSystemClassLoader())保证自定义类能被正确找回。真正的主菜在TabsManager.saveCurrentSession()源码位于 app/src/main/java/fulguris/browser/TabsManager.kt。三个亮点① 零填充索引保证恢复顺序outState.putBundle(TAB_KEY_PREFIX String.format(%05d, index), tab.saveState())标签页用TAB_00000、TAB_00001……这样的 Key 存入 Bundle。注释里的理由很务实零填充让字符串排序即索引排序最多支持 99999 个标签页的有序恢复绰绰有余 :)。最近标签列表则存为一组索引的Int数组。② 临时文件 重命名的原子写写入流程是写临时文件 → 删旧备份 → 旧会话改名为备份 → 临时文件改名为正式会话 → 删备份。全程用 rename 而非原地覆盖任何一步崩溃磁盘上要么有完整旧版本、要么有完整新版本绝不会出现写了一半的坏文件。saveState()还带一道保险——isInitialized为 false 时直接跳过避免空会话覆盖掉全部标签页修复过所有标签页丢失的真实 Bug。③ 写盘放后台线程saveCurrentSession是阻塞操作被丢进iScopeThreadPool协程池执行不卡主线程。源码中留有一段被注释掉的调试循环和作者对连续两次关闭 App 时两个写盘任务并发的困惑记录——这类进程退出时机不可控正是持久化最难的部分也是这段代码最有价值的经验。恢复流程App 启动时发生了什么入口在 app/src/main/java/fulguris/activity/WebBrowserActivity.kt 的initialize(savedInstanceState)与onRestoreInstanceState。恢复路径大致是正常启动读默认会话文件取出各标签页 Bundle崩溃场景走loadRecoverySession()从恢复会话文件找回标签页逐页重建每个标签页经TabModelFromBundle还原 URL、模式、图标WebView 用嵌套 Bundle 走saveState/restoreState恢复页面本身标签创建封装在FreezableBundleInitializer中Freezable意在延迟、冻结 Bundle 的解冻时机多会话操作会话列表、重命名、删除分别由SessionsAdapter、SessionViewHolder、SessionsPopupWindow均在app/src/main/java/fulguris/browser/sessions/目录负责 UI 呈现与交互。核心设计权衡一张表权衡点选择为什么会话元数据序列化Parcelable轻量、系统兼容好配合 UI 快速渲染会话列表标签页复杂状态普通类 Key 化 Bundle不绑定类名可自由重构、跨版本兼容favicon 压缩格式PNG无损反复存盘不降质文件写入策略临时文件 rename 原子替换崩溃安全杜绝半截文件写盘线程后台协程池持久化是阻塞 IO不能卡 UI标签页顺序零填充索引 Key字典序即顺序简单可靠新手可以带走的 5 条 Android 持久化经验Parcelable 类一旦落盘包名和类名就别轻易动——这是 Fulguris 用一整行注释换来的教训跨 App 版本长期存活的数据优先考虑自定义 Key Bundle而非深层嵌套 Parcelable重要文件写入用临时文件 rename永远不要原地覆盖需要有序恢复的集合用零填充编号 Key%05d恢复路径必须做防御性兜底null 回退默认值因为磁盘上的数据可能来自任意旧版本。核心文件索引会话元数据 Parcelableapp/src/main/java/fulguris/browser/sessions/Session.kt标签页状态模型app/src/main/java/fulguris/browser/TabModel.kt会话保存/恢复/多会话管理app/src/main/java/fulguris/browser/TabsManager.ktBundle 读写磁盘工具app/src/main/java/fulguris/utils/FileUtils.java启动与状态恢复入口app/src/main/java/fulguris/activity/WebBrowserActivity.kt会话列表 UIapp/src/main/java/fulguris/browser/sessions/SessionsAdapter.kt、SessionViewHolder.kt、SessionsPopupWindow.ktFulguris 的会话持久化没有引入任何重量级框架靠 Bundle、Parcelable 与文件原子操作就把关 App 不丢页做扎实了——对想理解 Android 底层状态管理的开发者来说这是一份难得的、带真实 Bug 修复痕迹的实战范本。【免费下载链接】Fulguris⚡Web Browser项目地址: https://gitcode.com/gh_mirrors/fu/Fulguris创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考