Readest FireOS 导入失效问题#1217源码剖析Android Activity 重建与文件选择器结果丢失的根因与修复【免费下载链接】readestReadest is a modern, feature-rich ebook reader designed for avid readers offering seamless cross-platform access, powerful tools, and an intuitive interface to elevate your reading experience.项目地址: https://gitcode.com/gh_mirrors/re/readest导读本文基于 Readest 仓库中的调试记忆文档fireos-import-activity-recreation-1217.md完整还原了Import Books 点了没反应#1217这一典型 Android 疑难问题的根因链、复现路径与最终修复方案。读完本文你将理解低内存设备上系统文件选择器前台运行时 Activity/进程被销毁的机制、TauriActivityResultLauncher绑定已销毁 Activity 导致选择结果被静默丢弃的原理以及 Readest 通过自研原生文件选择器 待发事件重放队列彻底解决该问题的源码级实现并掌握一套可迁移到其他 Tauri/Android 应用的通用排查方法论。背景Tauri 应用中文件选择器的两条路径Readest 的导入入口位于图书库页面点击 Import Books 会调用handleImportBooksFromFiles。在此之前Android 平台上文件选择走的是tauri-plugin-dialog插件调用链为page.tsx handleImportBooksFromFiles → useFileSelector.ts selectFileTauri → nativeAppService.selectFiles → openDialog()tauri-plugin-dialogACTION_GET_CONTENT对应实现分别在 useFileSelector.ts、nativeAppService.ts。这条路径的本质是打开系统选择器 → 等待一个 JS Promise 被 resolve。桌面端、常规手机端没有问题但在低内存设备上这个跨 Activity 往返的 Promise恰恰是致命弱点。根因链FireOS 上导入没反应的三个环节环节一低内存导致 MainActivity 在选择器前台时被销毁Fire 7 等低内存设备logcat 证据来自 tauri-apps/plugins-workspace#2745在系统文件选择器位于前台时会销毁后台的 MainActivity。当用户完成选择返回时Android在同一进程内重建MainActivity。环节二Tauri 重新初始化 Builder 触发 SIGABRTActivity 重建后Tauri 会重新执行tauri::Builder初始化此时日志系统已被初始化过再次注册会触发 panicPluginInitialization(log, attempted to set a logger after the logging system was already initialized)随即 SIGABRT应用静默重启已选中的 URI 全部丢失——这正好对应报告者观察到的 DevTools 断连与WM_RESTART_ACTIVITYlogcat 记录。这一半的问题在上游 tao PR #1148 中已被部分修复tao 0.35.02025 年 10 月。Readest 在 commit58d4661b72026-07-13将 tao 从 0.34.8 升级到 0.35.3首个携带该修复的版本是 v0.11.18所有 #1217 的 issue 报告都早于该版本。环节三修复后仍然失效——结果被静默丢弃即使没有崩溃修复后的 Tauri 仍然存在另一半 bug重建后挂在 WebView 上的待决 JS Promise 随 WebView 一起死亡Tauri 的PluginManager.onActivityCreate会提前返回if (::activity.isInitialized) return因此其ActivityResultLauncher仍绑定在已销毁的 Activity 上选择器返回时结果没有任何回调可投递被直接丢弃——表现为不崩溃、但导入静默无效no-op。无 FireOS 硬件时的复现方法论方案 A开发者选项 Dont keep activities在开发者选项开启Dont keep activitiesalways_finish_activities再点 Import Books 即可触发 Activity 销毁路径。方案 B小米/澎湃 OS 上的验证与陷阱实测关键结论文档明确指出该方案在小米 13v0.11.202026-08-06上不生效原因是双重的MIUI 的 GET_CONTENT 选择器com.android.fileexplorer/.picker.PickMainNavigatorActivity是一个半透明 sheet调用方 MainActivity 只进入 PAUSED 而不会 STOPPED因此 Dont keep activities 永远不会触发销毁HyperOS 直接忽略always_finish_activities按 Home 后 Activity 停留在 STOPPED 而非 DESTROYEDdumpsys 中也没有mAlwaysFinishActivities。文档给出了一个在小米上实测可复现结果丢失的流程打开文件选择器按 Home 回到桌面执行adb shell am kill com.bilingify.readest杀掉进程通过最近任务recents恢复任务——半透明选择器会迫使 MainActivity 在后台冷重建v0.11.20 上不会崩溃选择文件并点 OK返回图书馆页面书静默地没有被导入同样的文件在无干扰的往返中可正常导入。这验证了 bug 中结果丢失的一半发生在进程死亡场景而进程内 Activity 重建那一半仍需真正会销毁 Activity 的设备如 FireOS来验证。复现时的关键提醒当用 adb 驱动选择器时务必先确认界面上的 (1/100) 计数再点 OK——一次漏掉的选中点击其表现和这个 bug 一模一样。最终修复方案PR #5531自研选择器 待发事件重放设计思想放弃 Promise改用事件 队列原修复方向文档中记录的设计思路是像已有的文件夹选择器select_directoryrequest code 1002一样在tauri-plugin-native-bridge中自建文件选择器使用ACTION_OPEN_DOCUMENTEXTRA_ALLOW_MULTIPLE在MainActivity.onActivityResult→handleActivityResult中处理takePersistableUriPermission获取持久权限并通过已有的emitOrQueue待发事件队列本为冷启动 VIEW/SEND 场景设计天然能跨越 WebView 重载存活投递结果。PR #55312026-08-06squash commit5b3f3e888最终落地方案如下层关键变更Kotlin 原生show_file_picker命令ACTION_OPEN_DOCUMENTrequest code1003companion 对象中的deliverActivityResult存根在load()时排空事件file-picker-result事件通过emitOrQueue投递JSuseAndroidPickedBooks在图书馆页面常驻监听把事件转成importBooks调用Kotlin 侧show_file_picker 命令核心实现在 NativeBridgePlugin.ktCommand fun show_file_picker(invoke: Invoke) { try { val intent Intent(Intent.ACTION_OPEN_DOCUMENT).apply { addCategory(Intent.CATEGORY_OPENABLE) // Book extensions have no reliable MIME mapping in SAF; the // JS side re-applies the extension whitelist on the result. type */* putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true) } activity.startActivityForResult(intent, FILE_PICKER_REQUEST_CODE) invoke.resolve() // 立即 resolve不持有跨选择器的 Promise } catch (e: Exception) { invoke.reject(Failed to open file picker: ${e.message}) } }关键设计invoke.resolve()立即返回不把 invoke 挂起等待选择结果结果通过事件异步投递。选择结果解析在emitFilePickerResult中先从clipData收集多个 URI空则回退到data.data随后对每个 URI 调用tryTakePersistableReadPermissionACTION_OPEN_DOCUMENT授予的权限可持久化保证进程重启后仍能读取并复制进书库最后emitOrQueue(file-picker-result, payload)。Kotlin 侧跨 Activity 重建的存根与排空FILE_PICKER_REQUEST_CODE 1003定义于 companion 对象NativeBridgePlugin.kt// A file-picker result can be delivered to a MainActivity that was // recreated after the process died behind the system picker (#1217). // onActivityResult then fires before Tauri has instantiated this // plugin, so the raw Intent is stashed here and drained in load(). private var pendingFilePickerData: Intent? null fun deliverActivityResult(requestCode: Int, resultCode: Int, data: Intent?) { val plugin instance if (plugin ! null) { plugin.handleActivityResult(requestCode, resultCode, data) } else if (requestCode FILE_PICKER_REQUEST_CODE resultCode Activity.RESULT_OK data ! null) { pendingFilePickerData data } }当结果到达时插件实例尚未创建正是进程死亡后 Activity 重建场景原始 Intent 被暂存在load(webView)中NativeBridgePlugin.kt排空并重放pendingFilePickerData?.let { data - pendingFilePickerData null emitFilePickerResult(data) }MainActivity.onActivityResult统一转发到 companion 的deliverActivityResultMainActivity.kt注释明确说明了结果早于插件实例化 → 存根 → load() 重放的用途。Kotlin 侧emitOrQueue 待发事件队列emitOrQueueNativeBridgePlugin.kt复用自冷启动 VIEW/SEND 场景当事件名尚无监听者时入队registerListener重写中L496-L528在监听器注册后批量重放。这就是即使 WebView 重载、JS 监听器晚注册结果也不丢失的底层保证。Rust 侧命令桥接Rust 侧命令在 commands.rs 注册#[command] pub(crate) async fn show_file_pickerR: Runtime(app: AppHandleR) - Result() { app.native_bridge().show_file_picker() }移动端实现 通过run_mobile_plugin(show_file_picker, ())调用 Kotlin 侧命令注释同样标注了 #1217 的动机。JS 侧useAndroidPickedBooks 常驻监听JS 侧核心是 useAndroidFilePicker.ts 中的useAndroidPickedBookshook仅在appService.isAndroidApp时注册addPluginListener(native-bridge, file-picker-result, ...)收到uris后先用resolveTauriFileName解析真实显示名应对 SAF 不透明 document id见 #4489 注释再按FILE_SELECTION_PRESETS.books.extensions白名单过滤被白名单过滤掉的文件会弹 toast 指名道姓地提示对应 issue #5959避免全被过滤时看起来像按钮失灵用useRef保持最新回调而不反复重注册监听器防止 unregister/register 之间丢失队列事件。在图书馆页面中Android 分支改为 fire-and-forget 调用showFilePicker()bridge.ts 中invoke(plugin:native-bridge|show_file_picker)结果由常驻的useAndroidPickedBooks(appService, files importBooks(files, getImportTargetGroupId()))消费。测试覆盖JS 半边的行为有完整测试useAndroidFilePicker.test.tsx。测试断言Android 上注册file-picker-result监听器、非 Android 不注册、仅转发扩展名匹配的书籍文件、basename()抛错时不会炸掉整批处理回退到 raw-URI 解析。修复验证与已知坑小米 13 设备实测通过kill-behind-picker 场景0.11.20 上会丢结果现在能正常导入正常往返同样验证通过。HyperOS 会把ACTION_OPEN_DOCUMENT改写成hyper.intent.action.OPEN_DOCUMENT仍是 fileexplorer 选择器属于厂商自定义动作行为需按设备实测。FireOS 硬件验证仍待完成进程内 Activity 重建那一半变体只有真正会销毁 Activity 的设备才能覆盖。adb 驱动选择器验证时务必以 (1/100) 计数确认已选中再点 OK。关联但独立的问题文档附带发现排查过程中还发现三个独立问题值得单独跟进Samsung 选 100 MOBI 只导入 3 本2025 年 11 月同一线程useFileSelector.ts在basename()解析后按扩展名二次过滤解析失败的路径回退到 raw-URI 解析后被静默丢弃且对每个文件发起一个无界的Promise.allbasename IPC。代码中的过滤逻辑在 useFileSelector.ts含 #5959 的 toast 补偿。eink.rs 的EINK_MANUFACTURERS包含 amazon导致所有 Fire LCD 平板被当作墨水屏对比度主题、无过渡动画、EPD 刷新路径。这是外观性问题但判断错误值得单独修复。NativeBridgePlugin.handleActivityResult只处理FOLDER_PICKER_REQUEST_CODE1002REQUEST_MANAGE_STORAGE1001的结果被丢弃。相关代码在 NativeBridgePlugin.kt。方法论总结从 #1217 可以提炼出 Tauri/Android 混合应用系统选择器类功能的三条通用原则绝不让 JS Promise 跨越系统选择器的生命周期低内存设备上 Activity/进程随时可能被回收跨 Activity 的异步结果必须走事件 可重放队列而不是调用方持有的 Promise原生结果先落存根、后按需排空onActivityResult可能早于插件实例化到达companion 静态存根 load()排空是可靠的桥接模式复现必须贴合设备真实行为Dont keep activities 在 MIUI/HyperOS 上不生效因为厂商选择器形态半透明 sheet与系统策略忽略always_finish_activities都会改变触发条件——没有目标硬件时用adb shell am kill模拟进程死亡是验证结果丢失半边最有效的手段。【免费下载链接】readestReadest is a modern, feature-rich ebook reader designed for avid readers offering seamless cross-platform access, powerful tools, and an intuitive interface to elevate your reading experience.项目地址: https://gitcode.com/gh_mirrors/re/readest创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考