查看: 538|回复: 3

鸿蒙PC HAP包体预算治理:hvigor构建门禁与冗余扫描实践

[复制链接]
发表于 7 小时前 | 显示全部楼层 |阅读模式
在鸿蒙PC上做性能优化,很多人先盯帧率、卡顿和P95。但包体问题与帧率问题不同:帧率是运行时才暴露的症状,包体是发布前就埋下的隐患。一个没有预算约束的HAP,会随着每次合入资源、加图、拆动态库而悄悄扩容,直到触及设备或分发渠道硬限制,才在发版前夕被追问“这版怎么又快5MB”。这次工程化改造要解决的,就是把包体审计从个人桌面工具变成团队可持续运行的构建门禁、体积快照、冗余索引和发布红线。需要先说明:原文中6张真机截图上的48.6MB、115.7%预算占用、124个冗余资源均为样本值,代表问题形态,并非配套工程实测结论;实现落在hvigor构建脚本、CI流水线与体积快照的JSON结构上,不依赖系统Kit。

鸿蒙PC场景会放大包体问题。桌面窗口更宽、DPI更高,开发者更倾向放入高清位图、全字库和更多ABI动态库;应用常驻时间更长,多窗口并行时,体积成本会从安装、首屏加载传导到常驻内存。手机场景下“包大一点无所谓”的宽容,在PC上容易变成积重难返。更合理的判断是:包体之于工程像负债之于财务,单版本超一点不致命,可怕的是没有记账、没有预算、没有止损线。改造目标不是写一份“发版前跑一下”的文档,而是让包体问题在发生的时刻被机制拦下,把审计拆成采集、记账、判定、拦截四个持续环节。

第一步是给构建装一台“体积收款机”。用一个独立Node脚本遍历构建产物目录求和、读取预算配置,并把本次体积追加进快照文件。脚本刻意不依赖三方库,node自带fs/path即可在开发机、CI和本地同时跑;它不直接读HAP,而读entry/build/default/outputs/default/这类解好的产物目录,这样既能算总包,也能按子目录拆开,为后续构成分析留数据。
  1. // tools/byte_budget.mjs 核心逻辑(示意)
  2. const bytes = dirBytes(outDir);
  3. const redline = loadBudget();
  4. const ratio = Math.round(bytes / redline * 1000) / 10;
  5. const row = { at: new Date().toISOString(), version, bytes, ratio };
  6. fs.appendFileSync('volume.snapshot.jsonl', JSON.stringify(row));
  7. if (bytes > redline) process.exit(1);
复制代码

预算红线按字节写死,例如volume.budget.json写入redlineBytes: 50331648,约47.95MB。这样“字节进、字节出”,门禁判定是整数比较,避免用浮点MB在边界值上引入取舍误差。快照采用jsonl而不是单个JSON,每次构建追加一行,天生支持追加、免疫脏写入,做趋势图时也不用处理并发覆盖。把脚本挂进构建流程后,本地能看到实时水位,CI能拿到拦截判断,团队日会能翻出任意一次历史记录。

第二步是从“包有多大”走到“被谁吃掉了”。绝对构成图描述存量结构,真正值得管的是相邻两版的边际增量。一次合入可能让动态库目录只占总量一成,但如果目录从6MB涨到9MB,它可能就是越线元凶。做法是取相邻两个版本产物目录,各跑一遍目录级求和,按一级子目录聚合成“类别→字节”的映射,再做减法。跑出来通常能定位真凶:rawfile多塞了完整素材,libs因新增ABI翻倍,或资源目录出现文件名接近、内容不同的高清图。固化后,团队日会里的话从“我猜是XX导致”变成“增量构成表上是XX,涨了YMB”。

第三步是用内容指纹找出被复制两份的库存。目录构成能看到从哪涨,但看不到同一份内容在HAP里躺了两份:封面上线后被复制改名复用,或早期图片既复制又无代码引用。识别内容相同不能靠文件名,重命名是重复库存第一来源。可靠办法是按内容指纹聚类,给资源算摘要,同摘要即重复。工程上把重复资源输出成可被删除脚本直接消费的清单文件redundant.txt,每行一条建议删除的相对路径,直接进删除脚本和MR评审。

这里有一个边界要守住:脚本刻意只列重复资源,不列未使用资源。重复是内容层面的事实,两份摘要一样,机器能百分之百确定;未使用是引用层面判定,要靠可靠的“路径→引用入口”索引,做不到时宁可放行、留给人工确认。把机器能确证的和需要辅证的分开,删除清单才站得住脚,不会制造“删错了怎么办”的返工。另外,md5sum不是跨平台的:Windows用certutil-hashfile,macOS用md5,Linux才是md5sum。团队有Windows开发机时,冗余全文扫描用node的createHash('md5')统一实现更省心;find|xargs md5sum在超大目录还会触发ARG_MAX,若想保留第一份,必须先按摘要sort再分组保证确定性。

第四步是给处方一条“体积守恒律”。工具能查出冗余,但删了能省多少、省下来的字节去哪了,要能对账。内部规矩是:优化的验收必须回答“改了X,包体从A变小,减少量Δ与X的估计值B满足|Δ−B|小于某阈值”,否则收益不写进结论。处方分两类:删除替换类的收益可由包体差直接证明,删掉重复后打包体积实在变小的部分才是真实收益;加载转换类如字体子集化、按需加载,不改打包体积、只影响运行时,收益只能靠运行时采样,一律不进体积守恒账。每条处方给三态proposed→applied→verified,只有删除后重新打包、体积差对上账,才能从applied置为verified。半年后回看报告,能分清哪个数字被实践验证过,哪个还停在提案阶段。

最后是把散落动作收拢成发布红线。整条链是构建触发采集、快照记账、增量归因与冗余扫描、处方验证、CI门禁判定、通过才允许发版。CI门禁放在构建产物生成之后、发版打包之前,保证越线时拦下的是将要发布的产物,而不是中间态。超红线是硬门禁、直接失败;增量归因和冗余扫描只打印报告、不拦截,避免误伤正常临时增长。门禁误报比漏报更致命,堵得太狠、假阳性太多,团队会绕开或关闭门禁。每次构建成功后打volume-<版本>标签,等于给产物留一笔体积记录,复盘时可追溯。

落地时有几个坑值得提前写进README:先定字节口径,是解好的产物目录字节和还是最终HAP文件大小,预算分母不能混用;预算红线只存字节不存MB;hvigor自定义任务API随版本漂移,不同DevEco/hvigor注册任务差异大,先用独立node scripts/*.mjs保住逻辑正确,再谈塞进哪一层;volume.snapshot.jsonl不要提交进Git当普通源码,应进CI artifact或对象存储;JSONL在Windows CI上注意CRLF,写入用utf8,解析时trim或统一转LF;守恒律阈值别写死,后期包体基数变小,用相对百分比并随预算复核;处方状态别用布尔承载,三态加验证证据才有意义;机制不要写成“一个人会”的文档,要收敛成闭环图和三个脚本,让新同学也说得出“超红线会被拦、增量要查表、重复要删清单”。

可复现步骤是:在tools/下新建byte_budget.mjs、classify.mjs、find_dups.sh;建volume.budget.json,第一版先打比当前产物大20%的宽松值;手动跑一次node tools/byte_budget.mjs <产物目录> v1.0,确认输出JSON并生成快照;再跑构成增量与冗余清单,核对是否符合预期;在CI“构建完成之后、打包之前”插入门禁,超红线exit1,先旁路观察一两周再真正拦下发版;最后把脚本、预算配置、快照时间戳规则和闭环图托管,README写清界面样本值如何对应工程数字。对鸿蒙PC这种常驻时间长、版本迭代多的桌面应用,这套机制的价值在于让包体从“会咬人的问题”变成可复算、可查表、可拦截的数字。
回复

使用道具 举报

发表于 7 小时前 | 显示全部楼层

Re: 鸿蒙PC HAP包体预算治理:hvigor构建门禁与冗余扫描实践

这套做法挺工程化,我比较认同把包体当“负债”来记账的思路。很多团队确实只在发版前跑一次分析,结果每次合入都悄悄涨一点,最后很难归因。首帖里几个点很实在:字节口径先定死、预算只存字节、快照用 jsonl 追加、增量按一级目录做减法归因,这比单纯看总包大小有用得多。 冗余扫描只列内容重复、不列未使用资源这个边界守得很好。重复是机器能确证的事实,未使用一旦索引不可靠就容易误删,先把能确证的清单跑顺,比一上来做“大而全”的清理更稳。处方三态和体积守恒律也值得坚持,尤其是只有删除后重新打包、体积差对上账才置为 verified,这样半年后回看不会把提案当成已验证收益。 落地时我会特别关注两点:一是 CI 门禁先只硬卡总字节红线,增量和冗余先出报告观察一段时间,避免假阳性把大家逼到绕开门禁;二是 hvigor 任务注册别急着深塞,先用独立 node 脚本把采集、记账、判定逻辑跑稳,后面再考虑挂到哪一层。README 里把字节口径、Windows 换行、快照不进 Git、阈值随预算复核这些坑写清楚,新同学接手会省很多事。整体看,这条链覆盖了采集、记账、归因、扫描、验证和拦截,闭环思路是对的。
回复 支持 反对

使用道具 举报

发表于 7 小时前 | 显示全部楼层

Re: 鸿蒙PC HAP包体预算治理:hvigor构建门禁与冗余扫描实践

这篇写得很实在,把包体治理从“发版前跑一下”变成构建链路上的持续机制,这个思路很值得借鉴。尤其是字节进字节出、jsonl 追加快照、只列重复不列未使用,以及处方三态加体积守恒对账,这几条都抓住了落地时容易糊掉的地方。门禁误报比漏报更致命的提醒也很关键,硬门禁只卡总红线,归因和冗余先出报告,确实更容易让团队接受。 有个小建议:门禁失败时除了退出码,最好在日志里直接打出总字节、红线字节、超线字节,再附上一级目录增量 Top3 和 redundant.txt 的位置,这样开发者不用再翻快照就能判断是资源、ABI 还是某类图片涨了。另外预算口径最好在脚本参数和 README 里同时写死,明确是产物目录字节还是最终 HAP 大小,避免后面换人维护时把分母混掉。整体上这套闭环图和三个脚本的收敛方向很对,比写一份“某人会”的文档可靠得多。
回复 支持 反对

使用道具 举报

发表于 7 小时前 | 显示全部楼层

Re: 鸿蒙PC HAP包体预算治理:hvigor构建门禁与冗余扫描实践

这篇把包体治理从“发版前跑一下”拉到构建门禁,思路很完整,尤其是把审计拆成采集、记账、判定、拦截四个持续环节,比单纯做一次体积报告更可持续。几个点印象很深:预算红线按字节写死、快照用 jsonl 追加、增量归因看相邻版本目录级差值、冗余只列内容重复不列未使用,这些都把机器能确证和需要人工辅证的边界分得很清楚。处方三态和体积守恒律也很实用,能避免“优化了但账对不上”的情况。落地提醒里关于字节口径要先定死、预算分母不能混用、快照别当普通源码提交、Windows 下用 Node 统一 hash、JSONL 注意 CRLF,都是容易踩的坑。个人感觉最值得坚持的是“门禁误报比漏报更致命”这个判断,硬门禁只卡红线,归因和冗余先打报告,这样团队才不容易绕开门禁。感谢分享,这套闭环图和三个脚本的思路很有参考价值。
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

指导单位

江苏省公安厅

江苏省通信管理局

浙江省台州刑侦支队

DEFCON GROUP 86025

Hacking Group 021A

旗下站点

态势感知中心

应急响应中心

红盟安全

联系我们

官方QQ群:112851260

官方邮箱:security#ihonker.org(#改成@)

官方核心成员

关注微信公众号

Archiver|手机版|小黑屋| ( 沪ICP备2021026908号 )

GMT+8, 2026-11-17 07:46 , Processed in 0.022959 second(s), 17 queries , Gzip On, Redis On.

Powered by ihonker.com

Copyright © 2015-现在.

  • 返回顶部