React Native 鸿蒙长列表优化实战:用静态审计加运行时探针守住 FlatList 的四条底线
长列表是 React Native 应用里最容易"写的时候没感觉、上线以后被拖垮"的部分:ScrollView 里一把 map 看着省事,400 行数据一上来,首帧、内存、滚动三方面同时承压。这篇文章把长列表的守卫做成两层——构建期的静态审计(7 条反模式规则、可卡 CI 的退出码)和运行时的渲染成本探针(renderItem 采样 + 帧间隔归因),并在一台 OpenHarmony 7.0 模拟器上对"坏列表 vs 好列表"做了同条件实测。仓库持续维护,欢迎在 AtomGit 提 Issue/PR 或拿示例工程复现。
仓库地址:https://atomgit.com/oh-react-native/react-native-list-guard
版本地址:https://atomgit.com/oh-react-native
三方库框架:https://atomgit.com/CPF-rn
0. 环境与实测设备
| 项 | 版本/型号 |
|---|---|
| DevEco Studio | 26.0.0.851(HarmonyOS SDK 26.0.0.105 Release / API 26) |
| React Native | 0.84.1 |
| RNOH | 0.84.5(@react-native-oh/react-native-harmony) |
| react-native-harmony-list-guard | 1.0.0(本仓库) |
| Node.js | 20.19.5(bundle 与 hvigor 均使用此版本) |
| 实测设备(模拟器) | Mate 90 Pro 档位,OpenHarmony 7.0.0.107,API 26,ohos-x64 |
| 构建产物 | entry-default-unsigned.hap,40,542,556 字节(debug) |
| 测量工具 | list-guard 运行时探针(renderItem 采样 + rAF 帧间隔)+ CLI 静态审计 |
| 测量条件 | 400 行订单数据,hdc shell uitest 固定 25 次纵向滑动(200ms/次,间隔约 0.7s),两种列表形态各测一轮 |
模拟器与 RNOH 目标版本一致(API 26);文中全部数据来自这台模拟器上的可复现测量,审计报告与截图都在仓库里。先交代一个贯穿全文的口径决定:这台模拟器是 x86 软渲染,UI 光栅帧率的绝对值偏高失真,所以运行时指标全部采用 JS 线程 rAF 间隔口径并在截图里显式标注(“JS 帧口径(rAF 降级)”)——标注口径是本文所有数字的前提,后面第 2.2 节会看到它如何改变结论。
1. 长列表的三类隐性成本
先说我为什么把"长列表守卫"做成一个库。
一次需求评审里,产品要把订单列表从 50 条改成"加载全部(约 400 条)"。开发说没问题,把 FlatList 换成了 ScrollView 加一把 map——因为原来的 FlatList 有一个"行高跳动"的 bug,ScrollView 一把梭就没有跳动问题了。上线两周,测试开始报:“列表页打开比别的页慢一秒多”“滑到中段手机发热”“来回滚几次之后切到别的页面,返回来要白屏一下”。
这三个症状分别对应三类成本:
- 首帧:
ScrollView+map会一次性创建全部 400 行的组件与原生视图,首帧渲染时间随数据量线性上涨; - 常驻内存:400 行的视图树常驻内存,来回切换页面时反复销毁重建,白屏就是这么来的;
- 光栅化压力:每行带阴影、圆角裁剪,滚动时这部分开销叠加。
更麻烦的是,这三类成本写代码的时候完全看不见。<ScrollView>{data.map(...)}</ScrollView> 比配置 FlatList 的七零八落参数"干净"多了——直到提测。而到了提测才改,等于把最贵的重构放在了最赶工期的阶段。
把这三类成本换算成数字会更直观。以这次实测的 400 行为例:每行是一个带圆角裁剪、阴影、头像和两段文字的卡片,折算 15~20 个原生视图节点,400 行就是 6000~8000 个常驻视图节点;每行的样式对象、事件回调、JS 引擎里的 Fiber 节点再各占一份——一次 mount 的 JS 构造成本(这一轮实测里 mount 400 行让 rAF 间隔 P99 冲到 32~35ms)只是一次性的开销,之后一直占着内存的是这些节点。用户反馈的"滑到中段发热、切页面白屏",在这里都能对上。
还有一项更隐蔽的成本:修改成本。ScrollView+map 的列表没有"行"的概念,所有逻辑摊在页面组件里——想加"下拉刷新"得自己包 RefreshControl,想加"跳转到第 N 单"得用 scrollTo 加手算 y 偏移(还要自己量行高)。FlatList 的 getItemLayout 一个参数就能做的事,在 ScrollView 方案里是一段要维护的几何代码。这些成本不只在运行时,也在后续维护。
所以我给自己定了两条防线:写代码时,让机器盯着那几条已知反模式(静态审计);运行时,把列表的渲染成本变成看得见的数字(探针)。这篇文章的库就是把这两条防线产品化。
2. 效果展示:审计器抓到了什么,探针量到了什么
2.1 静态审计:一行命令命中两处反模式
对示例工程跑一遍审计:
npx tsx scripts/list-audit.mjs --project . --format md
输出如下:
| 项 | 值 |
|---|---|
| 扫描文件数 | 4 |
| 命中总数 | 2 |
| high / medium / info | 1 / 1 / 0 |
| 风险分 | 5 |
命中两处,全部指向示例里的"坏列表"(它就是为了演示故意写坏的):
- [HIGH] LG-001:
App.tsx:48 —— <ScrollView style={styles.flex}>,ScrollView 内联 map 渲染 400 条数据; - [MEDIUM] LG-003:
App.tsx:50 —— <BadItem key={index} index={index} />,用数组下标作 key。
--fail-on high 时存在 high 命中退出码 2——放进 CI 就是"这种代码进不了主干"。
2.2 运行时探针:两种列表形态的同条件实测
示例 App 叫"长列表实验室",一个开关切换两种形态:基线(ScrollView+map 400 行、行内 JSON.parse、阴影裁剪)和优化(FlatList 虚拟化 + 稳定 key + getItemLayout + 轻量行)。顶部仪表盘实时显示探针读数。
基线模式滚动中(已滚到 #106):

优化模式(FlatList 虚拟化)滚动中(已滚到 #110):

两种形态、同一台模拟器、同样的 25 次固定滑动手势,探针读数:
| 指标(JS 线程 rAF 口径) | 基线 ScrollView+map | 优化 FlatList |
|---|---|---|
| 丢帧率(帧间隔 >25ms) | 2.1% | 2.3% |
| 帧间隔 P99 | 35ms | 35ms |
| 视口外视图常驻 | 400 行全量 | 视口窗口约 12~20 行 |
| 静态审计 | LG-001 + LG-003 | 无命中 |
这组数字里最关键的是"丢帧率几乎一样"——它说明了 JS 口径探针的边界:ScrollView+map 的 400 行在 mount 时一次性渲染完,滚动过程中 JS 线程是空闲的(没有 renderItem 在跑),帧间隔自然不差;FlatList 滚动时 JS 也不忙(窗口小、每帧只挂载一两行)。两边的滚动差异发生在 UI 光栅与内存层面——400 行视图常驻带来的内存与切换开销,rAF 间隔量不到。这正是这个库坚持要加 ArkTS displaySync 原生帧探针的原因(见第 3.2 节),也对应一个测量上的问题:口径决定结论,想知道哪一层的数字,就要在哪一层采样。
而静态审计的两处命中、风险分 5→0 的收敛,是这台模拟器上确定的、可复现的优化证据——它不依赖任何运行时环境,规则命中就是命中。
这次修复几乎零成本,顺带记一下:BadList 换成 FlatList(keyExtractor 返回 row-${id}、getItemLayout 按固定 64px 行高直接算 offset、windowSize={11}、initialNumToRender={12}),行组件去掉 build 内的 JSON.parse 和阴影裁剪。改完再跑审计:命中归零,风险分 5→0,门禁转绿。"审计红 → 改 → 审计绿"这个循环跑通,说明门禁的判定和修复动作对得上——开发照着报告干活就行。
3. 原理:两层防线各自怎么工作
3.1 静态审计:正则级规则,零依赖进 CI
七条规则对应七种真实踩过的坑:
| code | 级别 | 规则 | 为什么是它 |
|---|---|---|---|
| LG-001 | high | ScrollView 内联 map 渲染数据集 | 首帧/内存/光栅三类成本的总源头 |
| LG-002 | high | 虚拟化列表嵌套在 ScrollView 里 | 外层 ScrollView 破坏窗口复算,滚到中段整屏掉帧 |
| LG-003 | medium | index 作为 key | 插删重排时复用错行状态 |
| LG-004 | medium | FlatList/SectionList 缺 keyExtractor | 默认 key 策略在重排场景失控 |
| LG-005 | medium | 固定行高缺 getItemLayout | scrollToIndex/jumpTo 要逐行测量,定位卡顿 |
| LG-006 | info | renderItem 内联闭包 | 父组件每次 render 触发全行重渲染 |
| LG-007 | info | windowSize / initialNumToRender 越界 | 预渲染窗口过大,低端机滚动成本线性涨 |
实现上刻意保持"正则级":不引入 AST 解析器,审计器本身零依赖(只有 Node 内置模块),CI 里 npm i 都不用。代价是规则写得要小心——比如 LG-005 判"固定行高"用的是属性块及附近 1200 字符里出现 height: 数字 / rowHeight / ITEM_HEIGHT 这类启发式,宁可少报(漏报比误报危险,误报会让团队关掉门禁)。注释处理用"等长空白替换"而非删除,保证命中行号与源文件严格一致——开发点开报告里的 App.tsx:50 就能落到那一行。
几条规则的阈值也都有出处,不是拍脑袋:LG-007 的 windowSize > 21 来自 FlatList 的默认值——视口前后各 10 屏,这是 RN 团队平衡预渲染成本与滚动体验的取舍,超过它意味着"预渲染预算"失控;RP 风格的"块内嵌套"判定(LG-002)用 <ScrollView ...>(...)(</ScrollView>|/>) 锁块再内查虚拟化组件,避免跨组件误配对。LG-004/005 需要多说一句:keyExtractor 和 getItemLayout 是 FlatList 必须配的两项参数——前者保证行状态跟数据走而不是跟位置走,后者把"这行在哪"从"逐行测量"变成"行高乘下标"。缺了它们列表不会立刻坏,而是在你最不希望的场合(重排、跳转、快速滚动)以最难复现的方式坏掉。审计器把"缺这两项参数"标出来,是为了让坏处发生在 code review 而不是用户手上。
3.2 运行时探针:renderItem 采样 + 帧间隔的两层口径
探针的采样分两层:
renderItem 成本(JS 层):wrapRenderer 把 renderItem 包一层计时器:
const renderItem = useCallback(
wrapRenderer('good_list', (d) => <GoodRow item={d.item} />),
[wrapRenderer],
);
每次行渲染记录耗时,汇总出 P50/P99/max。这个数字直接回答"一行渲染有多贵"——P99 超过 8ms,说明行组件该拆了。
帧间隔(两层口径):
- native 口径:ArkTS 侧 TurboModule(
ListFrameProbe)用displaySync.on('frame')挂在渲染管线上,每帧算一次间隔,500ms 批量推给 JS(ListGuardFrame事件)。这是真实 UI 帧,也是库的推荐口径; - js 口径(降级):原生桥不可用时退化到
requestAnimationFrame回调间隔。它测的是 JS 线程的帧调度,不等于光栅帧率——探针会把自己的口径暴露出来(probe.source()返回native / js / none),示例 App 的状态栏明确标注"JS 帧口径(rAF 降级)"。第 2.2 节的实测就是 js 口径,文章如实标注,不冒充 UI 帧率。
归因规则:renderP99 > 预算 60% 且丢帧率超线 → 判 render(优先优化列表项);丢帧但 JS 不忙 → 判 native(去查光栅与原生侧)。第 2.2 节实测归因是 none——JS 线程在滚动中确实不忙,这正是"应该看原生层"的信号。
computeReport 是探针的纯函数核心(Node 单测与 CLI 复放共用这一份):
const attribution = renderP99 > budget * 0.6 && droppedRate > 5
? 'render'
: (n > 0 && droppedRate > 5 ? 'native' : 'none');
它的产出分三档:指标(丢帧率、分位数、renderP99)、归因(render / native / none 三选一)、findings(LG-P-001 丢帧率超 5%、LG-P-002 冻结间隔超 700ms、LG-P-003 renderP99 超 8ms、LG-P-004 render 归因提示)。"纯函数"这一层设计在这轮开发里救了我两次:一次是 Metro release bundle 下 console 不可靠(坑四),被迫把样本出口换成文件后,CI 侧用同一份 computeReport 复放样本,设备端与 CI 的数字严格一致;另一次是单测——12 个测试里有一半直接喂构造好的 gaps 数组给 computeReport,不用起 RN 环境就能验证归因规则的每个分支。
findings 的分级沿用静态审计的规则:high 才卡 CI,info 只做提示。LG-P-003(renderP99 超 8ms)和 LG-P-004(render 归因)都是 info——它们不说明"现在卡",只说明"往哪看"。一个测量工具最忌讳把所有提示都升级成失败:开发者第一次看到误伤就会给门禁降级,第二次就会拆掉门禁。
4. 工程怎么搭
react-native-list-guard/
├─ src/ # TypeScript 源(spatial-glass-rn 模板布局)
│ ├─ index.ts # 公共出口
│ ├─ static-audit.ts # 静态审计核心:7 条规则 + audit + toStaticMarkdown
│ ├─ probe.ts # 运行时探针:computeReport / createProbe
│ └─ types.ts # 类型定义
├─ index.d.ts # 根类型出口
├─ __tests__/ # vitest 单测(含坏/好列表 fixture)
│ ├─ audit.test.ts
│ └─ fixtures/
├─ scripts/
│ └─ list-audit.mjs # CLI:--project / --runtime / --fail-on
├─ harmony/ # ArkTS(RNOH 库模板布局)
│ ├─ build-profile.json5 / oh-package.json5 / hvigorfile.ts
│ └─ react_native_list_guard/
│ ├─ Index.ets # 导出 ListGuardPackage
│ ├─ oh-package.json5 # 依赖 @rnoh/react-native-openharmony
│ └─ src/main/ets/
│ ├─ ListFrameProbeModule.ets # displaySync 帧采样 + writeSamples
│ └─ ListGuardPackage.ets # RNOHPackage 注册
├─ docs/ # 文章 + 实测报告
└─ example/ # "长列表实验室"
└─ App.tsx # 基线/优化开关 + 实时仪表盘
宿主接线三步(以 init-harmony 生成的工程为例):
- 库的
harmony/react_native_list_guard/目录拷进宿主harmony/下; entry/oh-package.json5加"react_native_list_guard": "file:../react_native_list_guard";PackageProvider.ets把包挂进getRNOHPackages():
import { ListGuardPackage } from 'react_native_list_guard';
export function getRNOHPackages(ctx: RNPackageContext): RNOHPackage[] {
return [
...createRNOHPackagesAutolinking(ctx),
new ListGuardPackage(ctx)
];
}
还有一个必须做的动作:把 react_native_list_guard 注册进 harmony/build-profile.json5 的 modules 数组。漏了这一步,hvigor 会报 Failed to resolve OhmUrl——这是本次踩过最隐蔽的坑,第 6 节细说。
两层防线的接线成本刻意设计成"不对称"的:静态审计零接线(CLI 直接指向任意工程目录就能跑,连依赖都不用装),运行时探针按需接线(不想动宿主工程的团队可以只用 createProbe 的 JS 层,原生帧探针作为可选增强)。这个取舍来自一次内部讨论:把门槛高的那层做成可选,才不会因为"接入麻烦"把整个工具弃用。
5. 把代码讲透
5.1 规则判定:块匹配与窗口配对
静态审计里最麻烦的是 LG-002 的判定:虚拟化列表嵌套在 ScrollView 里的组合往往隔着几十行 JSX,单条正则抓不住。实现用了"先锁定块、再查内容"的两段式:
// LG-002: <ScrollView> 块内出现 FlatList/SectionList/VirtualizedList
const scrollViewBlocks = /<ScrollView\b[\s\S]*?(<\/ScrollView>|\/>)/g;
let block;
while ((block = scrollViewBlocks.exec(withoutComments)) !== null) {
const inner = block[0];
const nested = /<(FlatList|SectionList|VirtualizedList)\b/g;
let n;
while ((n = nested.exec(inner)) !== null) {
out.push({
rule: 'LG-002',
line: lineOf(withoutComments, block.index + n.index),
snippet: snippetAt(block.index + n.index)
});
}
}
作为对照,另一类审计器里的强制同步布局判定(RP-001)用的是"200 字符窗口配对":读几何属性(offsetTop、getBoundingClientRect())出现后,窗口内紧跟写样式即命中。这里有个容易误伤的点——写在 requestAnimationFrame 回调里是正确做法,不该报:
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; // 白名单豁免
规则白名单和规则本身一样重要:一个会误伤正确代码的审计器,上线一周就会被 --fail-on none 静默掉。
5.2 wrapRenderer:一层包装,绝不改变业务
wrapRenderer: function (label, renderItem) {
return function (data) {
const t0 = Date.now();
try {
return renderItem(data);
} finally {
const ms = Date.now() - t0;
items.push({ label: label, index: data && data.index, ms: ms });
while (items.length > config.maxItemSamples) items.shift();
}
};
},
和 Flutter 版的 wrapItems 同构:finally 保证异常路径也记样本,返回值原样透传,环形缓冲限流。探针唯一不能做的事是改变业务行为——这条底线写在两个库的同一处。
5.3 displaySync:把采样挂在渲染管线上
ArkTS 侧的帧采样不用定时器,而是挂在渲染管线的帧回调上:
this.displaySyncInstance = displaySync.create();
this.displaySyncInstance.on('frame', (info: displaySync.IntervalInfo) => {
const ts = info.timestamp;
if (this.lastTimestamp > 0) {
const gap = ts - this.lastTimestamp;
if (gap > 0 && gap < 5000) {
this.gaps.push(gap);
if (this.gaps.length > 1800) {
this.gaps.splice(0, this.gaps.length - 1800);
}
}
}
this.lastTimestamp = ts;
});
this.pushTimerId = setInterval(() => this.pushGaps(), 500);
三个细节:displaySync 在 @kit.ArkGraphics2D 里而不是 @kit.ArkUI(编译器会明确告诉你后者没有这个导出);5000ms 上限是为了把后台挂起恢复的第一帧排除掉,不把"刚回前台"算成"卡了 3 秒";500ms 批量推送而不是每帧推——每帧跨一次 JS 桥本身就是掉帧源,探针不能一边量卡顿一边制造卡顿。
样本落盘走 ctx.uiAbilityContext.filesDir(应用沙箱 <filesDir>/list_guard/list_samples.json),hdc file recv 拉回 CI 复放。所有样本只进沙箱、不联网、不申请任何权限。
落盘的职责边界要看清楚:ArkTS 侧的 writeSamples 是直写——JS 门面传什么就写什么,不做加工。这意味着样本的完整性由调用方保证:探针的环形缓冲(1800 帧、约 60Hz 下 30 秒)是滚动窗口,exportSamples() 导出的是"当前窗口"而不是"从 install 起的全部历史"。这正是第 6 节坑四要把样本出口做成确定性文件的原因——窗口语义 + 确定性出口,CI 复放时拿到的样本和设备上 summarize 用的严格同一份。环形窗口对长会话的代价是旧样本滚出窗口,内存代价每帧约几十字节,9000 帧也不足 1MB,业务想拉长窗口调大 ringSize 即可。
6. 踩坑与经验
坑一:file: 源码库必须注册进 build-profile 的 modules。 把 ArkTS 包用 "react_native_list_guard": "file:../react_native_list_guard" 挂进 entry 依赖后,ohpm install 成功,但 hvigor 编译死在:
Failed to resolve OhmUrl. Failed to get a resolved OhmUrl for
"...\harmony\react_native_list_guard\index.ets" imported by "...\PackageProvider.ets".
伴随一条 WARN:Cannot import files outside of the current module using relative paths。翻配置才明白:源码形态的 file: 依赖不是"npm 包"而是"工程内库模块",必须在 harmony/build-profile.json5 的 modules 数组里注册:
modules: [
{ name: 'react_native_list_guard', srcPath: './react_native_list_guard' },
{ name: 'entry', srcPath: './entry', ... },
]
注册后一次通过。这个知识点 RNOH 生态的教程里很少写,因为它默认你用 npm 发布的 .har 包——自研包走源码引用就会撞上。补一句排查心得:这个报错的文案(“check whether the module … is correctly configured”)指向性很差,信号是它前面那条 Cannot import files outside of the current module using relative paths 的 WARN——它说明编译器没把你的目录当作一个"库模块"看待,而 build-profile 的 modules 注册正是给这个目录建立模块声明的地方。
坑二:Hermes 字节码 “Buffer misaligned”。 用 react-native bundle-harmony --js-engine hermes 打出的 .hbc,装上模拟器就红屏:Compiling JS failed: Buffer misaligned。对比老工程能跑的"同名文件",头 12 字节根本不是字节码 magic,而是 var __BUNDLE... 的纯 JS 文本——老链路实际用的是 plain JS bundle(RNOH 的 ResourceJSBundleProvider 对文本 bundle 直接加载)。RNOH CLI 的 hermesc 字节码版本与引擎内嵌版本存在错位,模拟器阶段最稳的做法是先打 JS bundle:
npx react-native bundle --platform harmony --dev false --entry-file index.js \
--bundle-output harmony/entry/src/main/resources/rawfile/hermes_bundle.hbc \
--assets-dest harmony/entry/src/main/resources/rawfile/assets
文件名保持 hermes_bundle.hbc 不变(宿主的 ResourceJSBundleProvider 按名字找),内容是纯 JS 也能加载。真机化再切回字节码并锁定 hermesc 版本。
坑三:react 与 react-native-renderer 的硬版本检查。 bundle 起来后一点按钮就崩:Incompatible React versions: react 19.3.1 vs react-native-renderer 19.2.3。宿主 node_modules 里的 react 是 19.3.1(semver 满足 RN 声明的 ^19.2.3),但 RN 内部的版本检查是精确相等。npm install react@19.2.3 --no-save 对齐后消失。顺带一个教训:--no-save 会把手工放进 node_modules 的本地包清掉,装完要把 react-native-harmony-list-guard 重新放回去。
坑四:console.log 在 release bundle 里不可靠。 想用 console.log 分片导出探针样本,hilog 里一条都搜不到——release 优化路径下 console 输出行为不可依赖。探针的样本导出最终走 ArkTS 的 writeSamples 落沙箱(hdc file recv 拉取),日志只做辅助。测量数据的出口要选确定性通道(文件、沙箱),不要选日志。
坑五:displaySync 不在 @kit.ArkUI 里。 按"显示相关都在 ArkUI"的直觉写 import { displaySync } from '@kit.ArkUI',编译器回:Module '"@kit.ArkUI"' has no exported member 'displaySync'。正确位置是 @kit.ArkGraphics2D。写 ArkTS 时开着 SDK 的 .d.ts 对照,别凭记忆(同一场编译里它还纠正过我对象字面量必须带显式类型)。
坑六:Metro 缓存里的 react 版本错配。 一次正常构建后突然全屏红:react 19.3.1 vs react-native-renderer 19.2.3(与坑三同文案但根因不同)——Metro 的文件映射缓存还指着降级前的 react。--reset-cache 重打 bundle 解决。凡是被"玄学"构建问题卡住超过十分钟,第一反应应该是清缓存,而不是继续改代码。
坑七:file: 包的源码更新不会自动同步。 本地包 ohpm install 之后,entry 的 oh_modules/react_native_list_guard 是安装时刻的拷贝。改了库的 ArkTS 源码直接重新 build 宿主,改动会静默丢失(编译的是拷贝)。每次改完库源码必须重跑 ohpm install --all 再 build。这轮开发里 ListFrameProbe 的 @kit.ArkGraphics2D 修正第一次没生效,就是因为只 build 了没 reinstall。
坑八:uitest 滑动与 RN 手势系统的配合。 用 hdc shell uitest uiInput swipe 驱动滚动时,RN 的手势系统(Responder/PanResponder)与 ArkUI 的手势识别在事件派发上偶有竞态——示例里出现过一次 onResponderGrant 路径的 JS 异常弹窗,而同样的滑动手势在原生 ArkUI 列表(Flutter 与 Cordova 示例)上从未复现。自动化脚本要给每次手势留出惯性滚动结束的间隔(本仓库用 200ms 滑动 + 0.7s 间隔),并把"异常弹窗截图"作为测量流程的检查点——弹窗一出现,本轮数据作废重测,不能带着红屏读仪表盘。
坑九:模拟器上安装覆盖后应用会退到桌面。 hdc install 覆盖安装已运行的应用,旧进程被杀但桌面不会自动回栈,接着 aa start 有时因 Ability 状态残留而起不来(表现为黑屏或直接回桌面)。稳妥顺序是 aa force-stop → hdc install → 点桌面图标启动(uitest uiInput click),而不是依赖 aa start。测量脚本里这条要写成固定步骤,省掉"应用没起来白测一轮"的来回。
7. 现在怎么用
npm 安装(或 path 依赖):
npm install react-native-harmony-list-guard --save
静态审计进 CI(零运行时依赖):
node scripts/list-audit.mjs --project . --format md --fail-on high
运行时探针进关键列表页:
import { createProbe } from 'react-native-harmony-list-guard';
const probe = createProbe({});
probe.install(); // 有原生桥走 displaySync,没有自动降级 rAF 并标注口径
const renderItem = probe.wrapRenderer('feed', ({ item }) => <Row item={item} />);
<FlatList data={data} renderItem={renderItem} keyExtractor={item => item.id}
getItemLayout={...} windowSize={11} initialNumToRender={12} />
probe.summarize(); // 丢帧率 / P99 / renderP99 / 归因(render 或 native)
probe.exportSamples(); // 样本 JSON,可经 writeSamples 落沙箱
当前版本在 React Native 0.84.1 + RNOH 0.84.5 + DevEco Studio 26.0.0.851(API 26)模拟器(OpenHarmony 7.0.0.107,ohos-x64)上验证:npm test 12 个 vitest 单测全过;hvigorw assembleHap 产出 40,542,556 字节 HAP;App 在模拟器上完成基线/优化两种形态的滚动实测;静态审计对示例工程命中 LG-001/LG-003 并输出 Markdown 报告。已知边界如实说明:ArkTS displaySync 原生帧通道在当前 RNOH TurboModule 注册链上待进一步验证,示例以 JS 口径(rAF 降级)运行并在 UI 明确标注口径——这正是第 2.2 节数据口径为"JS 线程"的原因。
三条可直接复用的建议:
- 先把静态审计挂进 CI,再加探针。 规则命中的收益是确定的(LG-001 一条就能拦住最贵的错误),探针是增量。反过来做,团队会在"数字怎么读"上消耗耐心。
- 写明帧口径。 JS 线程间隔与 UI 光栅帧率是两回事,探针
source()的值要跟着报告走。本文第 2.2 节"两模式丢帧率几乎一样"就是一个靠口径解释清楚的结论——不标注口径,它会被误读成"优化没用"。 - 静态报告的行号必须能点。 等长空白替换保留注释与行号的小设计,让
App.tsx:50直接落行——审计工具除了判得准,还要让人愿意点开看。
最后是三个被同事问过最多的取舍问题,一并写在这里。一,为什么不直接用 React Native DevTools 的 Profiler? DevTools 是交互式排查工具,回答"此刻哪个组件在渲染";这个库回答的是"这个列表合不合格"——后者要的是可归档、可 diff、可卡流水线的门禁数字,两者是互补而非替代。二,为什么不用 FlashList 这类第三方高性能列表? 能用当然好,但 RNOH 生态里第三方列表组件的鸿蒙适配成熟度参差,而 FlatList 的 keyExtractor / getItemLayout / windowSize 三项参数在绝大多数业务里够用——审计器的作用是先把这三项用对,再考虑换列表组件。**三,模拟器数据能外推到真机吗?**不能直接外推:这台模拟器是软渲染,UI 层差异(第 2.2 节里量不到的那部分)在真机上会放大;但静态审计的规则命中、renderItem 成本的相对变化,在两种环境里的方向是一致的。给业务的"达标证明"请用真机重跑同一组手势。
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐

所有评论(0)