夜雨聆风学习资料网

ARTICLE · 1383370

排版插件开发手记7:零依赖是怎么练成的:打包、确定性、可复现白名单打包、密钥不入包、逐字节回验

排版插件开发手记7:零依赖是怎么练成的:打包、确定性、可复现白名单打包、密钥不入包、逐字节回验
功能写完了,还要能交到用户手里。打包这件「无聊」的事,藏着三个最容易翻车的坑:漏文件、泄密钥、不可复现。这一篇讲我怎么把这三个坑全堵上。

一 · 白名单反推文件集:排除法会漏

第 6 篇说取证要随时可点。但「随时可点」的前提是:包里真的有这个文件。

我一开始用「整目录打包,再排除不需要的」。结果翻过车:manifest 没声明某个弹窗脚本,我打包时也没带上它,包「看着装好了」,弹窗三个按钮全哑。

修法是白名单反推:文件集从 manifest 反推,不靠排除。而且不止 manifest——入口 HTML / CSS 里的 <script src> / <link href> / @import / url() 也是运行必需,必须做引用闭包,循环到不动点。

判据跟着加一条:「包内 HTML 引用的资源必须在包内」。这样漏文件当场红,而不是装完才发现。

二 · 密钥铁律:私钥绝不入包

打包器要打包,但有些东西绝不能进包。

签名私钥所在目录 [项目代号]——这里用占位符,因为它指向一个内部工程代号,不对外暴露——绝不参与打包。打包器带一个 secret 扫描断言:命中 .pem / .key / .p12 即删包。

为什么这么硬?因为私钥一旦进包泄露,别人就能签出同 ID 的假升级包。泄露的代价不是「这个包坏了」,是「所有用户都会被假升级骗」。所以命中即删包,不留「看起来成功」的假包。

(全文不出现任何真实密钥,仅表述工程原则。)

三 · 确定性打包与归档:按指纹触发

打包要确定性,否则无法复现、无法回退。

我做两件事:

  1. 按内容指纹触发归档。
     同样字节的产物不重复归档。否则一次会话能堆十来份同样的包,白白占空间。
  2. keep-N 修剪。
     归档目录只留最近 N 份,旧的自动清。

更重要的是:旧包指纹不匹配时,必须删除并提示重出。为什么?因为「签名验得过、装得上、功能是旧的」这种包,比没有包更危险——它让你以为更新了,其实没更新。

四 · 可复现:逐字节回验

交付前,我跑一个三件套:白名单打包 → 解包回验 → SHA256 比对。

具体是:对包内文件与源码做 SHA256 逐一比对,一致才算合格。排版工坊的运行包是 34 个文件 / 374 KB(自有数据,可公开)。不合格的包当场删掉,不留「看起来成功」的假包。

这一步的意义,是「同一份源码,无论谁在哪台机器打包,产物字节一致」。可复现,才谈得上可信交付。

五 · 衔接:包稳了,但有些验证跑不起来

这一篇,把交付侧讲完了:白名单、密钥不入包、确定性、可复现。包稳了。

但有一类验证,本机跑不起来。第 8 篇老实说这件事——边界在哪,以及下一步去哪。

最后

打包最无聊,也最致命。漏一个文件,包「看着装好」却功能全哑;泄一把私钥,所有用户都可能被假升级骗;不可复现,你连「我交付了什么」都说不清。

白名单反推、密钥不入包、逐字节回验。这三道,让「能跑」变成「可信地交到用户手里」。

下一篇,说说我没能验过的边界——以及下一步。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料