Electron Sparkle 更新器抽库：119 个测试之外的发布边界
内容提要
文章讨论了将electron-sparkle-updater从私有实现抽成公共库时遇到的边界问题。测试无法覆盖发布后的环境差异，如npm隐式构建、依赖解析、rpath路径和清理失败。解决方案包括显式触发构建、固定依赖、调整路径和用trap确保清理，最终需通过真实产物验证打包契约。
延伸解读
测试的盲区：环境即契约
119 个测试全部通过，但关键缺陷都发生在库函数之外：npm 隐式构建、消费者依赖解析、打包后的路径、清理失败等。这些问题的根源在于测试只能验证仓库内的行为，而发布后的包要经过包管理器、依赖图、Electron ABI、打包器和 CI 等环境。抽库时，必须把这些环境行为显式化为契约，否则测试再多也无法覆盖真实场景。
npm 隐式构建的陷阱
当包目录存在 binding.gyp 时，npm 会自动执行 node-gyp rebuild，但使用的是宿主 Node 的 ABI，而非 Electron 的 ABI，导致产物无法加载。解决方案是添加一个 no-op install 脚本覆盖隐式行为，并显式提供 rebuild 命令。这个 no-op 脚本需要保留注释和文档，否则维护者可能误删。
依赖与路径的隐性依赖
将 node-gyp 放在 devDependencies 会导致消费者环境无法解析，npx 会从 registry 下载未固定版本。必须将工具移入 dependencies，并从自己的依赖图解析。此外，从原 app 复制的 rpath 在库的目录结构中失效，但 Electron 主执行文件的 @executable_path 掩盖了问题，需用 otool 检查 LC_RPATH。
清理逻辑必须覆盖所有退出路径
发布脚本启用 set -euo pipefail 后，若 generate_appcast 失败，后续清理命令不会执行，私钥可能残留。使用 trap cleanup EXIT 可以确保清理在任何退出路径执行，且 trap 内部的 || true 避免清理失败覆盖原始错误。用户输入也应通过 env 传递，防止命令注入。
Q&A
electron-sparkle-updater 抽库后，为什么 119 个测试无法发现发布后的 Critical bug？
因为库内测试只能观察仓库里的行为，无法覆盖发布后的环境差异，如 npm 隐式构建、依赖解析、rpath 路径和清理失败等。这些故障发生在包管理器、消费者依赖图、Electron ABI、打包器、dyld 和 CI runner 等外部环境中。
如何解决 npm 在安装时自动执行 node-gyp rebuild 导致的 ABI 不匹配问题？
通过添加一个 no-op install script 覆盖 npm 的隐式行为，将原生构建改为显式触发，例如使用 `electron-sparkle-updater rebuild --electron-version 43.1.0 --arch arm64`，并使用 Electron headers 进行构建。
为什么第一版 CLI 将 node-gyp 放在 devDependencies 会导致问题？如何修复？
因为消费者安装包时不会得到 devDependencies，npx 会从 registry 下载另一个版本，离线 CI 会失败。修复方法是将 node-gyp 移入 dependencies，并使用 createRequire 从自己的依赖图解析入口，确保使用固定版本。
打包后 addon 的 rpath 路径错误是如何被发现的？为什么打包后的 app 仍能加载 Sparkle？
通过检查打包后的 .app 发现 addon 位于更深目录，原有六层上跳的 rpath 无法到达 Contents/ 目录。但 app 仍能加载 Sparkle，是因为 Electron 主执行文件自带 @executable_path/../Frameworks，提供了另一条路径，但这不能证明库声明的 rpath 有效。
在构建 universal 二进制时，为什么 arm64 产物会丢失？如何解决？
因为第二轮 x64 的 node-gyp rebuild 会先执行 `rm -rf build/`，导致 arm64 文件在 lipo 前被删除。解决方法是把中间产物移到 build/ 目录外，并增加路径约束的回归测试。
发布流水线中，为什么 generate_appcast 失败会导致私钥清理不执行？如何修复？
因为脚本启用了 `set -euo pipefail`，generate_appcast 失败时脚本立即退出，后续清理命令不会执行。修复方法是使用 `trap cleanup EXIT` 确保清理覆盖所有退出路径，并在 trap 内部使用 `|| true` 避免清理失败覆盖原始错误。
