Cordova 应用的渲染性能问题有两面:页面里的(FCP 晚、长任务多、布局抖动)和容器里的(onPageStart 到 onPageEnd 的加载耗时、WebView 创建期配置)。这篇文章把两面都装上探针——javaScriptOnDocumentStart 注入 PerformanceObserver 采页面指标,ArkTS 插件在容器生命周期里计容器耗时,构建期审计器扫 www/ 找渲染反模式——并在一台 OpenHarmony 7.0 模拟器上给出轻页与重页的同条件实测对比。仓库持续维护,欢迎在 AtomGit 提 Issue/PR 或拿示例工程复现。

仓库地址:https://atomgit.com/oh-tpc/cordova-plugin-harmony-renderprobe
版本地址:https://atomgit.com/oh-tpc
三方库框架:https://atomgit.com/CPF-Cordova

0. 环境与实测设备

项版本/型号
DevEco Studio26.0.0.851(HarmonyOS SDK 26.0.0.105 Release / API 26)
Cordova14.0.2
hcordova CLI1.0.7
cordova-plugin-harmony-renderprobe1.0.0(本仓库)
实测设备(模拟器)Mate 90 Pro 档位,OpenHarmony 7.0.0.107,API 26
构建产物entry-default-unsigned.hap(debug,ArkWeb 容器 + 探针插件)
测量工具渲染探针(PerformanceObserver 注入 + 容器 onPageEnd 计时)+ 构建期审计器
测量条件同一容器内先后加载轻页(index.html,52 个 DOM 节点)与重页(heavy.html,1218 个节点 + 400 次布局抖动),各多次导航取容器耗时

模拟器为 API 26,示例的 compatibleSdkVersion 是 5.0.0(12),实际运行在 API 26 上;文中涉及的 ArkWeb API(javaScriptOnDocumentStart、runJavaScript)在该环境均可用,全部数据可在同一环境复现。

1. WebView 应用的性能问题从来不只在一个层

Cordova 应用的渲染性能排查有个天然的坑:问题同时存在于两层,而两层的工具链是割裂的。

页面这一层,Web 开发的老三样都适用:首屏绘制晚(FCP 慢)、主线程被长任务占住(longtask)、循环里读写几何属性造成布局抖动(layout thrashing)。但 Cordova 的页面跑在 ArkWeb 里,Chrome DevTools 不能直接连,chrome://inspect 那套调试链路要额外开 WebView 调试端口,生产环境还必须关掉(安全红线)。结果就是:页面层的性能问题在测试环境能看、生产环境全靠猜。

容器这一层,工具更少。onPageStart 到 onPageEnd 之间发生了什么——HTML 解析、rawfile 读取、JS 线程初始化——全在引擎内部,业务代码插不进手。而 Cordova OHOS 引擎的 Web 组件属性(混合内容、数据库访问这些)在 MainPage.ets 里创建期写死,插件运行时改不了,但第一步同样是拿到数据。

我印象最深的一次排障:一个 Cordova 鸿蒙项目首页白屏 2 秒,前端判断是容器启动慢,鸿蒙侧判断是页面太重,两边都没有数据。最后靠手工打点(onPageStart/End 加 log)才发现容器加载只占 300ms,剩下 1.7 秒是页面里一个同步解析 2MB 配置 JSON 的长任务。这个问题只要有"容器耗时 + 长任务时长"两个数字,五分钟就能定位;没有它们,排查会拖很久。

那次之后复盘,手工加 log 有三个反复出现的问题:一是不可持续——log 代码随着重构被删掉是迟早的事,下一个版本问题回来时工具已经不在了;二是不可复放——log 打在终端里,谁也没存档,两次测量没法 diff;三是覆盖不全——手工打点只打当时怀疑的位置,而性能问题往往出现在没有打点的地方。所以"加 log"只是起点:把打点做成探针,把 log 换成落盘样本,把当时怀疑的几个指标定为常设预算(FCP≤1000ms、容器≤800ms 这些阈值的来源就是那次 300ms + 1700ms 的拆分——容器层的健康线由此定在 800ms)。

所以这个库由三部分组成:

  • 注入脚本:javaScriptOnDocumentStart 在 Web 组件创建期注入 PerformanceObserver 脚本,页面里的 FCP、LCP、longtask 全部落在 window.__rp;
  • 容器计时:插件在 onPageStart/onPageEnd 计时,并主动 runJavaScript 把页面指标收割进跨页历史;
  • 构建期审计:构建期扫 www/,把循环 innerHTML、布局抖动、图片缺宽高这些反模式在 CI 里拦住。

三部分的分工对应三个采集时机:注入脚本和容器计时回答"现在这一版有多慢、慢在哪一层"(运行时,事后可归档复放);构建期审计回答"代码里哪几处埋着下一个慢"(构建期,提交前拦截)。时机不同,消费方式也不同——运行时数据给排查与验收,静态数据给 code review 与 CI 门禁。一个成熟的性能治理流程两样都要:这轮实测里,审计器先命中 heavy.js 的 RP-001/006(提交前就能看到),探针随后用容器耗时 728ms 与 DOM 1218 节点印证了它的运行时影响(合并到主干前就能量化)——同一条坏代码在提交前和运行时各被检出一次,静态数据与运行时数据可以互相印证。

2. 效果展示:一个重页面的实测报告

2.1 运行时:轻页与重页的同容器对比

示例 App 叫"渲染耗时实验室"。首页是轻页(52 个 DOM 节点),一个按钮跳转到重页(heavy.html,故意保留循环 innerHTML、布局抖动、阴影滥用三个反模式)。

首页仪表盘:

渲染耗时实验室首页

重页面(审计目标,滚动可见 400 行阴影卡片):

重页面:循环 innerHTML + 布局抖动

回到首页点"采集并落盘",容器把跨页历史写入沙箱,hdc file recv 拉回,CLI 复放。同一容器内轻页与重页的实测对比(探针自动收割,hilog 可见每次采样):

指标轻页 index.html重页 heavy.html差异
容器加载(onPageStart→End)108ms / 41ms / 65ms577ms / 701ms / 728ms约 5~18 倍
DOM 节点数52121823 倍
页面样本行dom=52dom=1218探针逐页收割

这组数字回答了第 1 节那次争论:容器本身不慢(轻页 108ms),重页的 577ms 来自页面的 DOM 规模与同步布局工作——先确定耗时在哪一层,优化才有方向。测量工具是探针自身的计时(容器侧 Date.now 差值、页面侧 PerformanceObserver),条件是同一容器内多次导航取值,全部可在同一环境复现。

首页仪表盘上还有一个设计:预算列直接印在指标旁边(FCP ≤1000ms、容器 ≤800ms……)。数字旁边的预算让是否超标可以直接判断,不需要打开文档查阈值——这个改动的起因是第一版仪表盘只有数字,每次都要心算"这个数算不算慢"。测量工具展示数字时必须同时展示判据,这是它区别于原始日志的地方。

2.2 构建期审计:反模式在 CI 里现形

对 www/ 跑审计:

node scripts/renderprobe-audit.mjs --root www --format md --fail-on high

输出如下:

项值
扫描文件数5
静态命中总数2
high / medium / info1 / 0 / 1
  • [HIGH] RP-001 疑似强制同步布局(1 处):www/js/heavy.js:25 —— var top = items[j].offsetTop; // 读几何:强制布局,读几何紧跟写样式;
  • [INFO] RP-006 innerHTML 大批量拼接(1 处):www/js/heavy.js:17 —— for (var i = 0; i < 400; i++) {。

门禁 --fail-on high 直接退出码 2。与运行时数据对齐看:审计命中 RP-001 的 heavy.js,正是运行时里容器 728ms 与 DOM 1218 节点的那一页——静态审计指出坏在哪,运行时数据给出坏多少。

3. 原理:三层探针各采一段,拼出完整链路

3.1 注入脚本:javaScriptOnDocumentStart 的配置

页面指标(FCP/LCP/longtask)靠 PerformanceObserver。问题是怎么把这段脚本装进每一个页面——往每个 HTML 里手写 <script>?漏一个页面就是盲区,而且业务页面不该被探针污染。ArkWeb 给了标准答案:javaScriptOnDocumentStart,在每个文档开始执行前自动注入,全程生效。

两个必须知道的 API 细节(都踩过):

其一,它是 WebAttribute 的方法,不是 WebviewController 的。 插件拿到的是 CordovaWebView.getWebAttribute(),在 initialize() 时一次性配置:

const items: Array<ScriptItem> = [{ script: script, scriptRules: ['*'] }];
this.webAttribute.javaScriptOnDocumentStart(items);

API 11 起签名从单个字符串变成了 ScriptItem 数组({ script, scriptRules }),scriptRules: ['*'] 表示对所有源生效——Cordova 页面映射在 https://www.example.com/www/ 虚拟主机下,通配规则最省心。

其二,注入时机是"创建期",这正是它的价值。 因为在文档开始前执行,PerformanceObserver 挂上时页面还没开始渲染,buffered: true 能把注入前已经发生的绘制事件补收回来——FCP 这种"错过就没有"的指标靠的就是它。

scriptRules 的语义是按源匹配注入范围,'*' 通配所有源。Cordova 应用的页面都从引擎映射的虚拟主机(https://www.example.com/www/)加载,理论上可以只写这一条规则;但页面里若跳过外部链接,通配能保证探针不丢页。只读采集 + 沙箱落盘的前提下,注入面的扩大没有安全代价——注入脚本里没有任何对外通信。

注入的脚本本体刻意保持小:三个 Observer(paint / largest-contentful-paint / longtask)全部写入 window.__rp,longtask 数组限流 200 条。探针脚本不引第三方库、不发请求,它的全部产出就是 window.__rp 这个对象。

3.2 容器计时:onPageEnd 收割,跨页历史在 ArkTS 侧积累

容器耗时的计算很朴素:onPageStart 记 Date.now(),onPageEnd 求差。设计点在样本的归属:页面每次导航(location.href 跳转)都会销毁整个 JS 环境——window.__rp 归零、JS 门面里的样本数组清空。如果只在 JS 侧积累,测完三页只剩最后一页。

所以插件把"积累"放在 ArkTS 侧:

onPageEnd(): void {
  // ... 计时并 push 进 this.historyLoads
  setTimeout(() => this.harvestSamples(), 1500);   // FCP/LCP 稳定后再收
}

private harvestSamples(): Promise<void> {
  // runJavaScript 读 window.__rp,解析后 mergeSample(同 URL 最新覆盖)
}

harvestSamples 用 controller.runJavaScript 执行一段内联脚本读取 window.__rp,解析后按 URL 并入 historySamples。两个细节:延迟 1.5 秒收割,因为 FCP/LCP 的 Observer 回调在 onPageEnd 之后才触发(实测 onPageEnd 立即收割时 fcpMs 恒为 0);同 URL 最新覆盖,因为帧类指标是滚动窗口,最新一份最完整。用户点"采集并落盘"时,插件先再收割一遍(拿最新值),然后写全量历史进沙箱——一次交互拿到的就是完整会话。

这个"ArkTS 侧积累"的设计还有个隐性收益:它让探针对业务页面零侵入。heavy.html 和 index.html 都没有为探针写任何代码,任何接了这个插件的 Cordova 工程都是"装上即测"。

收割的时机也有个细节。onPageEnd 触发时页面刚解析完,FCP/LCP 的 Observer 回调往往还没到——第一版在 onPageEnd 里立即收割,hilog 里 harvest ... fcp=0 刷屏。改成 setTimeout(1500) 延迟收割后,fcp 开始有值。1.5 秒是权衡:太短收割不到指标,太长则在用户快速连续跳页时丢样本。配合"采集时再收割一遍"(用户点落盘按钮时的 collect 动作会先跑一次最新收割),绝大多数测量场景都能覆盖。

至于 runJavaScript 本身:它是异步的(返回 Promise),且跑在 WebView 的 JS 线程上——收割脚本本身会短暂占用页面主线程。这也是它不能太重的原因:脚本里只做读数和一次 JSON.stringify,微秒级完成。探针的"收割"动作如果反过来拖慢页面,就违背了测量工具的第一原则。

3.3 构建期审计:把"渲染耗时大户"拦在 CI

运行时探针回答"现在多慢",构建期审计回答"代码里哪几处会导致慢"。六条规则:

code级别规则现实对应
RP-001high读几何紧跟写样式(强制同步布局)循环里 offsetTop 后改 style.top,每圈强制重排
RP-002high图片缺显式宽高布局偏移(CLS)的直接来源
RP-003medium单 HTML 静态节点 >1500超大 DOM 首帧解析与样式计算成本
RP-004medium动画使用 top/left/width/height每帧触发重排;应用 transform 走合成层
RP-005info阴影/滤镜声明 >20光栅化负担
RP-006infoinnerHTML 循环拼接一次性插入大量节点,阻塞主线程

RP-001 的判定是"200 字符窗口内读几何 + 写样式成对出现",并带一条重要白名单:写在 requestAnimationFrame / setTimeout 回调里的样式修改豁免——rAF 里改样式是教科书推荐做法(排队到下一帧统一处理),误伤它会毁掉审计器的公信力。示例里的好页面(GOOD_HTML fixture)专门保留了"读几何 + rAF 写样式"的正确写法做回归验证,10 个单测里有一条专门盯这个豁免。

运行时样本(采集落盘的 JSON)也能被 CLI 复放:--runtime samples.json 会按同一份预算(FCP≤1000ms、LCP≤2500ms、longtask≤500ms、DOM≤1500、容器≤800ms)产出 RP-P 系列运行时 findings,与静态 findings 合并进同一份 Markdown。

RP-001 的判定代码是"配对窗口"思路的样板:

const readRe = new RegExp(READ_GEOMETRY.source, 'g');
let m;
while ((m = readRe.exec(text)) !== null) {
  const window = text.slice(m.index, m.index + 200);
  const writeMatch = window.match(new RegExp(WRITE_STYLE.source));
  if (!writeMatch) continue;
  const deferredIndex = window.search(/requestAnimationFrame|setTimeout/);
  if (deferredIndex >= 0 && deferredIndex < writeMatch.index) continue;  // 白名单豁免
  hits.push({ rule: 'RP-001', file: path, line: lineOf(text, m.index), ... });
}

先找"读几何",再看读点之后 200 字符内有没有"写样式",两件事成对出现才算一次布局抖动嫌疑;若读与写之间隔着 requestAnimationFrame 或 setTimeout(写在下一帧的回调里),豁免。示例重页的 heavy.js:25(offsetTop 读取后同帧写 style.marginTop)就是被这个窗口配对抓到的——400 次循环,每次循环强制浏览器失效布局再立即重建,这就是容器耗时 577ms 与滚动掉帧的直接来源之一。

4. 工程怎么搭

cordova-plugin-harmony-renderprobe/
├─ plugin.xml                    # feature 声明 + ArkTS 源注入(ohos platform)
├─ www/
│  └─ renderprobe.js            # JS 门面构建产物:collect / summary(浏览器退化 mirror)
├─ src/                          # TypeScript 源(spatial-glass-cordova 模板布局)
│  ├─ index.ts                  # 公共出口
│  ├─ audit-core.ts             # 审计核心:auditSources / summarizeRuntime / toMarkdown
│  ├─ renderprobe.ts            # JS 门面源(构建进 www/renderprobe.js)
│  └─ types.ts                  # 类型定义
├─ types/                       # 生成的 .d.ts
├─ scripts/
│  ├─ build.mjs                 # tsc 类型检查 + esbuild 打包 www
│  ├─ renderprobe-audit.mjs     # CLI:--root / --runtime / --fail-on
│  └─ setup.ps1                 # hcordova 建工程 + 拷插件 + patch 宿主
├─ ohos/src/main/ets/
│  ├─ RenderProbePlugin.ets      # 注入 + 容器计时 + 收割 + 落盘
│  └─ RenderProbePolicy.ets      # 预算常量(与 CLI 同口径)
├─ demo/
│  └─ index.html                # 独立演示页
├─ example/                     # Cordova 工程骨架
│  ├─ README.md / config.xml
│  └─ www/                      # 轻页 + 重页 + 仪表盘
├─ docs/                        # 文章 + 实测数据
└─ __tests__/                   # vitest 单测

接入方式与 Cordova 插件惯例一致:hcordova plugin add cordova-plugin-harmony-renderprobe,宿主 Index.ets 的 plugs 数组注册 RenderProbePlugin。scripts/setup.ps1 把六步(建工程、加平台、拷 www、拷 ArkTS 插件、patch 宿主 Index、ohpm install)全部脚本化,一条命令得到可构建的完整工程。

JS 门面的降级设计与姊妹库同款:resolveExec() 优先取全局 window.cordova.exec(页面以普通 <script> 加载,没有 CommonJS 的 require——这里踩过坑,见第 6 节),Node 单测与浏览器预览环境退化为纯内存 mirror,UI 永不白屏。

仓库布局里还有一处刻意的复用:scripts/setup.ps1 的六步流程(hcordova create → platform add → 拷 www → 拷 ArkTS 插件 → patch 宿主 Index → ohpm install)把"插件如何进入宿主工程"完整固化成了脚本。第六步的 ohpm install 必须在 harmonyos/ 子目录下执行——工程根目录没有 oh-package.json5,直接跑会报 Missing file "oh-package.json5" in "纯 ASCII 构建目录",这也是脚本化比起文档化更可靠的理由:文档会写"进入 harmonyos 目录",脚本直接 Push-Location 帮人做对。

5. 把代码讲透

5.1 收割脚本:一段内联 JS 的自描述返回

harvestSamples 通过 runJavaScript 执行的脚本返回一个 JSON 字符串:

const script = `(function () {
  var rp = window.__rp || { fcpMs: 0, lcpMs: 0, longtasks: [] };
  var total = 0;
  for (var i = 0; i < rp.longtasks.length; i++) total += rp.longtasks[i].duration;
  return JSON.stringify({
    url: location.pathname,
    fcpMs: rp.fcpMs,
    lcpMs: rp.lcpMs,
    longtaskCount: rp.longtasks.length,
    longtaskTotalMs: total,
    domNodes: document.getElementsByTagName('*').length
  });
})()`;

在 ArkTS 侧解析返回值有个容易忽略的坑:引擎会把字符串返回值再包一层引号——runJavaScript 的 Promise resolve 出来的是 "\"{...}\"" 形态,直接 JSON.parse 得到的是字符串不是对象。处理方式是剥引号后反转义:

const text = raw.length > 1 && raw.startsWith('"') && raw.endsWith('"')
  ? raw.slice(1, -1).replace(/\\"/g, '"').replace(/\\\\/g, '\\')
  : raw;
const row: ESObject = JSON.parse(text) as ESObject;

这类"跨语言边界的字符串再包装"没有文档明说,只有设备日志能暴露——harvested 样本的 hilog 打点(harvest /www/index.html fcp=... dom=...)既是调试工具,也是数据是否可信的现场证据。

5.2 合并历史:同 URL 覆盖,不同 URL 追加

private mergeSample(row: ESObject): void {
  for (let i = 0; i < this.historySamples.length; i++) {
    if (this.historySamples[i].url === row.url) {
      this.historySamples[i] = row;
      return;
    }
  }
  this.historySamples.push(row);
}

设计取舍:帧类指标是滚动窗口,同一 URL 的最新一份最有代表性(FCP 随时间补全、DOM 稳定后不再变),所以覆盖而不是追加;不同 URL 追加,一个测量会话扫过几页报告就有几行。这个语义和静态审计的"文件级命中"对齐——报告里一行就是一个页面(运行时)或一个文件(静态),排查时的心智模型统一。历史数组也做了限流(longtask 明细限 200 条、采集会话按 URL 去重),保证探针在长会话下内存平稳——测量工具如果内存无上限,本身也会成为渲染开销。

5.3 预算常量:一处定义,两端共用

RP-P 系列运行时 findings 的阈值(FCP≤1000ms 等)定义在 ArkTS 的 RenderProbePolicy.ets 里,CLI 侧 summarizeRuntime 用同一组数字。和姊妹库一样,这是"口径单一来源"原则:设备端展示的判定结果和 CI 门禁的退出码必须同源,否则设备端通过、CI 失败的情况迟早出现。

6. 踩坑与经验

坑一:javaScriptOnDocumentStart 不在 controller 上。 第一版写在 this.controller.javaScriptOnDocumentStart(script),编译器直接拒绝:Property 'javaScriptOnDocumentStart' does not exist on type 'WebviewController'。它是 WebAttribute 的方法——组件属性级的配置,通过 cordovaWebView.getWebAttribute() 拿到。同时注意 API 11+ 的签名是 ScriptItem 数组,单个字符串版本已废。写 ArkTS 时对照 SDK 的 declarations/web.d.ts,不要凭记忆。

坑二:callbackContext.success 的参数是 boolean。 传落盘路径字符串给 success(path),编译报 Argument of type 'string' is not assignable to parameter of type 'boolean'——success() 无参(keepCallback 布尔),字符串要走 successByString(path)。Cordova 插件回调有五个变体(success / successByString / successByJson / successByBoolean / successByJsonString),第一次写 ArkTS 插件的人几乎都会在这撞一下。

坑三:页面里没引 cordova.js,exec 永远是 null。 探针门面的第一版用 require('cordova/exec')——页面以普通 <script> 加载,根本没有 CommonJS require,试出来的路径是 window.cordova.exec;改完发现 window.cordova 也不存在——Cordova OHOS 引擎不自动注入 cordova.js,页面必须显式 <script src="cordova.js"></script>(webguard 示例的 154 行就是这么写的)。加上之后 exec 链路立刻通了,仪表盘上"已写入 /data/storage/el2/base/haps/entry/files/render_probe/samples.json"就是它工作的证明。

坑四:JS 环境随导航销毁,样本必须放在 ArkTS 侧。 第一版只在 JS 门面的数组里积累样本,跳转重页再返回后点采集,落盘 JSON 是空的(samples: [], pageLoads: [])——JS 侧的 state 早已随页面销毁。修法即第 3.2 节的"ArkTS 侧积累":onPageEnd 收割 + ArkTS 历史数组 + 落盘全量。在 WebView 应用里做测量,先确认数据存在哪一层:JS 环境只存活一个页面周期。

坑五:onPageEnd 立即收割,FCP 恒为 0。 收割逻辑挂上后,hilog 里 harvest ... fcp=0 反复出现——FCP 的 Observer 回调发生在 onPageEnd 之后,立即收割太早。改成 setTimeout(1500) 后 fcp 才有值。顺带的结论写进了预算表:本模拟器(软渲染)的 paint 回调延迟明显,FCP/LCP 两项在模拟器上只能看趋势,绝对值要真机复测。

坑六:hdc file recv 拉不到沙箱别名路径。 页面上显示的写入路径是 /data/storage/el2/base/haps/entry/files/render_probe/samples.json(应用内别名),hdc file recv 用它会报 no such file——hdc 需要物理路径 /data/app/el2/100/base/<bundleName>/haps/entry/files/...。用 find 确认物理路径再拉。配套的还有 Git Bash 的 MSYS 路径转换问题:远端路径以 / 开头会被翻译成本地路径,必须 export MSYS_NO_PATHCONV=1。两个坑叠加起来曾让我以为落盘失败——其实文件一直在,是拉取姿势不对。

坑七:重页面没有出口,测试卡死在页内。 第一版 heavy.html 只有入口没有返回按钮,uitest uiInput keyEvent Back 在这个容器里也没有把 WebView 导航回退(页面停在重页),整个"重页 → 首页 → 采集"的测量流程走不下去。教训:自动化测量的页面拓扑要在页面里自足——每个页面自己提供导航出口(location.href 回首页),不依赖系统返回键的行为。heavy.html 补上"回到首页"按钮后流程一次跑通。这次踩坑还暴露了一个时序问题:重页面的 400 行卡片渲染 + 布局抖动本身就会让页面短时间"无响应",任何依赖页面响应的测量步骤都要在导航完成后留出稳定窗口(本仓库脚本用 5 秒),否则量到的是页面还没稳定的状态。

坑八:构建副本与模拟器时序。 中文路径让 hvigor 拒绝构建(Invalid project path)是三件套共有的老坑,构建副本放 纯 ASCII 构建目录 解决;覆盖安装正在运行的应用会杀掉旧进程,接着 aa start 偶发起不来(黑屏或回桌面),稳妥顺序是 force-stop → install → 点桌面图标启动。测量脚本把这两条写成固定步骤后,"应用没起来白测一轮"的来回就没有再发生过。

7. 现在怎么用

接入(scripts/setup.ps1 全自动):

hcordova plugin add cordova-plugin-harmony-renderprobe
# 宿主 Index.ets 注册 RenderProbePlugin(setup.ps1 第 5 步自动完成)

页面里零代码即可被测(注入层自动工作);业务想主动读取时:

RenderProbe.collect(function (sample, path) {
  console.log('样本已落盘:', path);   // <filesDir>/render_probe/samples.json
});

构建期审计进 CI:

node scripts/renderprobe-audit.mjs --root www --format md --fail-on high

复放设备样本并合并运行时 findings:

hdc file recv /data/app/el2/100/base/<bundle>/haps/entry/files/render_probe/samples.json samples.json
node scripts/renderprobe-audit.mjs --root www --runtime samples.json --format md

当前版本在 Cordova 14.0.2 + hcordova 1.0.7 + DevEco Studio 26.0.0.851(API 26)模拟器(OpenHarmony 7.0.0.107)上验证:npm test 10 个单测全过;setup.ps1 一键建工程后 hvigorw assembleHap 构建成功;App 在模拟器完成轻页/重页多次导航实测,容器耗时(轻页 41~111ms、重页 577~746ms)与逐页 DOM 样本(52 / 1218 节点)全部来自探针自动收割;静态审计命中 RP-001/RP-006 并输出报告。已知边界:FCP/LCP 在软渲染模拟器上只能看趋势(坑五),绝对值以真机为准;应用内别名路径与物理路径的差异(坑六)已在 README 标注。

三条可直接复用的建议:

  1. 容器耗时和页面指标分开看。 两者慢的原因和修法完全不同(容器慢查启动链路,页面慢查 DOM 与长任务),探针把两组数据分开记录,判断时以数据为准。
  2. 构建期审计先跑起来。 RP-001/002 两条 high 的修复成本极低(rAF 化、补宽高),收益直接落在真实用户的滑动与首屏上——这是性价比最高的一段。
  3. 采集通道选文件不选日志。 日志(console/hilog)在 release 与跨语言边界上都不可靠,沙箱文件 + hdc file recv 是唯一确定性通道。

最后回应两个同事问过的取舍问题。一,Lighthouse 不能用吗? Lighthouse 是桌面 Chrome 生态的工具,跑不了 ArkWeb;而且它模拟的是"设备 + 网络"条件,测不了容器层耗时。本文探针的口径贴合 Cordova 鸿蒙的真实运行环境——javaScriptOnDocumentStart 与容器生命周期都是 ArkWeb 直接提供的 API。二,探针自身会不会拖慢页面? 注入脚本只有三个 Observer 加一个对象写入,创建期一次性执行微秒级;收割每页一次、跑在页面线程上但只做读数;容器计时是两个 Date.now()。整套探针的运行成本远低于任何一条被测预算(FCP 预算的百分之一量级),测量工具自己必须比被测对象轻两个数量级,这是底线。

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐