Repository navigation
🔴 重要:请务必升级到这个版本
v0.1.15 ~ v0.1.17 的 APK,打开任何 PDF 都会永远卡在「正在打开 PDF…」(v0.1.16 起表现为不报错、无限等待;v0.1.17 起会报「PDF 打开超时」)。
这是打包配置的 bug,不是你的设备、也不是 WebView 太旧。所有旧 APK 都建议直接卸载重装本版。
根因:worker 注入时漏了一个分号(ASI 陷阱)
打包时会把 src/lib/polyfills.js 原样前置进压缩后的 pdf.js worker 产物,而两段代码的衔接处是:
})() ← polyfills IIFE 结尾,没有分号
(function(){"use strict";var zn={... ← worker 产物以 "(" 开头JavaScript 的自动分号插入(ASI)不会在 ( 前补分号,于是两段被粘成一次函数调用:
})(...)(function(){ ... })关键点:这是合法语法,不报语法错误,所以构建、语法检查、代码审查全都发现不了。真正的后果是 worker 一加载就抛出:
TypeError: (intermediate value)(...) is not a function
它只往 console 打一行错误就静默死掉;pdf.js 因此永远等不到 worker 的 ready 握手,getDocument() 既不 resolve 也不 reject —— 页面就永远停在「正在打开 PDF…」,用户看不到任何原因,只能退出去重开。
桌面版走原生 showOpenFilePicker,不经过这条 worker 注入路径,所以只有 APK 中招,也没有在桌面测试里暴露。
修复
- 注入时显式补分号:
${source}\n;\n,不再依赖源文件的结尾写法; polyfills.js自身也以;收尾,作为第二道保险;- 新增 3 组回归护栏(
npm run verify:polyfills):- 真正执行拼接后的代码,断言 worker 能启动 —— 只做语法检查抓不到这个 bug;
- 断言
polyfills.js的代码以分号结尾; - 断言打包注入语句必须带分号。
验证
- 用旧写法可 1:1 复现浏览器控制台里的原始报错原文,修复后 worker 在真实 Worker 环境中正常发出
ready握手; - 从构建产出的 APK 内部解包核对,衔接处已确认为
})();; npm run verify:polyfills与npm run verify:file-cache全部断言通过。
本版仍包含(v0.1.15 ~ v0.1.17 的修复)
Promise.withResolvers等新 API 在旧 WebView 上缺失导致的「PDF 打开失败」——在主线程与 PDF worker 中双重补齐;- 最近文件在 APK 里报「找不到文件」——改为把文件内容缓存进 IndexedDB(元数据与文件实体分表,避免统计/淘汰时读出上百 MB),设置里可查看与清除本地缓存;
- v0.1.16 的回归:缓存改为「文档打开完成后」才写入,不再和打开动作抢同一个
content://源文件;写入串行化; - PDF 打开 25 秒看门狗,卡住时给出明确原因而不是无限转圈;
- 保存/导出改为写入手机的
Download/Note Studio/;返回键先关弹窗再退出;刘海屏安全区与软键盘遮挡;禁用双指缩放与输入框自动放大。
安装
app-debug.apk(56 MB,推荐) —— 可直接安装。
⚠️ 请认准 56 MB 左右这个体积。CI 自动产出的包只有 8 MB(缺少被 gitignore 的 PDF 编辑器运行时,装了必然打不开 PDF),本 Release 的资产已用完整本机构建覆盖,但你若在别处看到 8 MB 的包请不要下载。app-release-unsigned.apk(49 MB)—— 未签名,需自行签名后安装。Note-Studio-0.1.18-Windows.exe(305 MB)—— Windows 便携版,双击即用。