#!/usr/bin/env node /** * 把 pdf.js 的 worker 复制到 public/。 * * ## 为什么要这一步 * * pdf.js 需要 worker 文件从**同源**加载(`/pdf.worker.js`), * 但它只有新版 `.min.mjs`,而开发服务器对 `public/` 下的 `.mjs` 不解析, * 因此复制成 `.js`。 * * ## 为什么不进 git * * 1.3 MB 的构建产物,随 pdfjs 版本变化,没理由占仓库空间。 * 由 `postinstall` 自动生成,克隆后 `npm install` 即得。 */ import { copyFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs'; import { dirname, resolve } from 'node:path'; import { fileURLToPath } from 'node:url'; const here = dirname(fileURLToPath(import.meta.url)); const root = resolve(here, '..'); const src = resolve(root, 'node_modules/pdfjs-dist/build/pdf.worker.min.mjs'); const dest = resolve(root, 'public/pdf.worker.js'); if (!existsSync(src)) { // 未安装 pdfjs-dist(如只装了部分依赖)时静默跳过,不阻塞 npm install console.log('[copy-pdf-worker] 跳过:未找到 pdfjs-dist'); process.exit(0); } mkdirSync(dirname(dest), { recursive: true }); copyFileSync(src, dest); /* * 🔴 复制后**必须校验**(2026-11-15 真机事故后新增) * * ## 为什么 * * 这个坑已经踩了**两次**: * ① 2026-11-13:降级 pdfjs 后没重跑本脚本 → 线上是 6.4 的 worker * ② 2026-11-15:同样的事又从真机 App 上冒出来 —— * 主包 4.10.38,而 APK 里的 worker 是旧版 6.4.299(1,264,342 字节, * 正确值应为 1,375,838),pdfjs 的 fake-worker fallback 失败后 * `getDocument().promise` **既不 resolve 也不 reject**, * 用户看到的是「一直转圈,永远加载不出来」。 * * ## 本脚本只在 postinstall 跑 * * 而 `npm run build` / `npx cap sync` 不会重跑它,只是把 public/ 下的 * **旧文件**一路拷进 APK。所以「文件存在但内容过期」是常态而非意外。 * * 现在:复制完立刻比对大小,不一致就报错退出,把问题挡在构建期, * 而不是等用户装完 App 发现打不开 PDF。 */ const srcSize = statSync(src).size; const destSize = statSync(dest).size; if (srcSize !== destSize) { console.error( `[copy-pdf-worker] 🔴 复制结果不一致:src=${srcSize} dest=${destSize}\n` + ` 这会导致 pdfjs 主包与 worker 版本不匹配,PDF 永远转圈。`, ); process.exit(1); } console.log(`[copy-pdf-worker] 已生成 public/pdf.worker.js(${destSize} 字节,已校验)`); /* * 同时生成 pdfjs 版本常量(2026-11-13)。 * * ## 为什么需要 * * `pdf-preview.ts` 用版本号做 worker 的缓存键。之前是手写常量, * pdfjs 从 6.4 降到 4.10 时忘了改 → 浏览器命中缓存的旧 worker * → 主包与 worker 版本不匹配 → PDF 永远卡在「正在加载」。 * * 现在由本脚本把 `node_modules/pdfjs-dist/package.json` 的 version 写进源码, * 依赖一变缓存键就变,不可能再忘。 */ const versionFile = resolve(root, 'src/app/components/preview/pdf-preview/pdfjs-version.generated.ts'); const pkgPath = resolve(root, 'node_modules/pdfjs-dist/package.json'); if (existsSync(pkgPath)) { const { version } = JSON.parse(readFileSync(pkgPath, 'utf8')); writeFileSync( versionFile, `/* 由 scripts/copy-pdf-worker.mjs 自动生成,请勿手改。 */\n` + `export const PDFJS_VERSION = '${version}';\n`, 'utf8', ); console.log(`[copy-pdf-worker] 已生成 pdfjs 版本常量:${version}`); }