鸿蒙 PC 的 React Native 交接台,应用回前台时怎样收起订单摘要
React Native鸿蒙适配的AtomGit分支 · 订单交接台完整工程与窗口桥接源码
本文使用 RnohHandoverSummary 工程,页面和鸿蒙窗口宿主都在同一工程内。订单为合成数据;这次复核针对鸿蒙电脑本机编译的 1.0.1 包,历史模拟器素材另行标注。
仓库换班讲到一半,交接人打开滨江仓的装车计划,过一会儿又回到鸿蒙 PC 桌面继续交接。React Native 页面的列表原封不动地留着,刚才打开的订单也还摊在那儿。如果只是点了旁边的计划窗口,保留摘要能省掉一次操作。如果交接台已经被最小化,回来时先展示列表更合适,下一班可以从自己的订单开始。这里有两种看起来都像“切出去”的动作,对页面的要求恰好不同。
我做了一个只含三笔演示订单的交接台。每笔都有路线、装车阶段和编号,展开后才出现班组、物料和备注。订单内容全部是合成数据。页面右侧有一栏只用来帮助复现,能让读者分开看应用状态、窗口焦点和窗口可见性。接下来按一次交接的实际操作走,从打开一笔订单开始,到关在任务栏里、再回来重新打开。工程使用 React Native 渲染列表,鸿蒙宿主负责观察本窗口的可见性。
展开:交接现场要找的是订单号
把任意一笔数据藏起来之前,先决定它回到列表后还能用什么认出来。我让每条卡片按订单号、线路、交接阶段排下来。像 S-2807 这种固定编号占第一行,知道编号的人不必先查目的地。负责哪一班、手上有几箱和需要口头确认的事,放在展开区。查看其他笔会直接替换当前摘要,长列表中也只会有一个已展开项。IBM Carbon 数据表的可展开行提供了交互参照,交接台把两个层次简化成订单卡片。 Carbon Data table
展开项用一个 string | null 表示。页面需要补更多订单时,数组里的各项仍由自己唯一的编号标识,点了 S-2807 后改变行序也不会把摘要套到占据旧位置的订单上。它适合这条业务路径还有一个原因。把摘要关掉只需赋回 null,应用状态和宿主回调同时到达时可以重复执行,页面也无需等谁先完成。列表内容、阶段文字、订单数量都从订单数据生成,不参与这次重置。
右侧状态栏把三种状态分别摊开,便于复现时核对。打开第一笔记录后,卡片下方出现班组和物料,右边马上能看见当前编号。窄窗把观察栏放到订单下方,操作入口仍留在各订单行右侧。这里用内容容器 onLayout 量到的宽度决定横排,达到 850 才把列表和观察栏并排。窗口被拉窄时保留打开的那笔,让同一个人缩尺寸以后能接着读,宽度变化和生命周期各自只处理自己的状态。


离开:先按两种方式各切一次
从已经展开 S-2807 的桌面出发,先点另一个窗口,再点交接台标题栏回来。日志重点看 blur 和 focus 之间有没有 change background 或实际窗口隐藏。上一批次真机第一轮点到仍露在边缘的设置窗,订单保留;历史模拟器也记录了焦点来回,摘要仍是 S-2807。本轮另对新包重做操作,结果放在后面的验收记录。这个操作检验日常查资料的路径。若把收起逻辑塞进 blur,只要焦点换到旁边就得重新打开,恰好破坏了交接台的使用方式。
第二种动作是点交接台标题栏上的最小化按钮,等桌面显示出来,再点程序坞的交接台图标。这时要核对同一个进程的记录。用系统命令强制停止再打开也会默认收起,但那只能证明初始化做对了。所以我单独给冷启动做记录,最小化测试前后则以日志里的进程号和页面右侧的历史为依据。历史模拟器的首轮工程只用应用状态订阅。最小化确实隐藏了窗口,恢复后同一笔摘要还在,相关日志只有焦点变化。真机这组操作已经收到 background → active,两个设备的首轮表现有区别。
宿主于是补了一条窗口可见性事件。RNApp 建好实例后,再由页面用当前 Ability 上下文取窗口。Index.ets 把窗口布尔值送给这一个 React Native 实例,页退出时卸掉对应回调。事件名只在交接台项目内使用,业务层保持只认“摘要要不要折叠”这个结果。窗口重新显示只更新观察栏,已经清掉的订单号不会从事件里找回来。鸿蒙窗口订阅和 React Native 应用状态有各自的接口定义。React Native 官方将 focus、blur 标为 Android 事件,不能据此直接保证每个鸿蒙版本会怎样回调;本文对 RNOH 的描述来自具体设备日志。 华为窗口接口文档React Native AppState
private onVisibility = (visible: boolean): void => {
console.info(`[HandoverSummary] native visibility ${visible}`);
this.rnInstance?.emitDeviceEvent('handoverWindowVisibility', visible);
};
private bindWindow = async (instance: RNInstance): Promise<void> => {
const context = this.rnohCoreContext?.uiAbilityContext;
if (!context) {
return;
}
const mainWindow = await window.getLastWindow(context);
this.mainWindow?.off('windowVisibilityChange', this.onVisibility);
this.rnInstance = instance;
this.mainWindow = mainWindow;
mainWindow.on('windowVisibilityChange', this.onVisibility);
};
aboutToDisappear(): void {
this.mainWindow?.off('windowVisibilityChange', this.onVisibility);
this.mainWindow = undefined;
this.rnInstance = undefined;
}
回来:消失的是展开项,订单一直在
上一批次补订阅后再做最小化,两端都在同一个进程里记录到应用进入后台、窗口不可见、应用恢复及窗口重新显示,页面回来时写着“全部收起”。第二轮模拟器也出现了应用状态变化,因此不能把首轮漏报解释成所有 API 24 设备的系统特性。能从首轮和复测一起得出的结论是,窗口可见性可以被单独观测,代码对任意一个表示离开的信号都能收起摘要。两条都会来的环境,重复一次清空也得到相同结果。
历史 1.0.0 模拟器包还出现一种中间情况。点程序坞打开全屏设置时,交接台先失焦,随后窗口报告不可见,期间应用状态一直是 active。点回交接台后,摘要已经收起。这次真正起作用的是宿主的可见性回调。两扇窗口并排而交接台仍可见时,单纯失焦不会清空。复现时可以分别操作这两种桌面排布,观察栏里的三项状态可以解释为什么都是点别的窗口,结果却有区别。
在 App.tsx 内,这两个订阅都在页面挂载时建立,卸载时分别注销。焦点订阅在工程中保留来显示和打印事件。假如读者要做的只是暂时停住键盘处理,可以在焦点订阅完成它自己的职责。对于交接台,点一下列表又能展开,并且再次显示熟悉的班组和物料,这一步同时证明原始记录的数据仍在,之前收起的是展开状态。真正处理订单权限、系统任务缩略图或屏幕捕捉需要另做验证,本篇的实验只观察交接台页面。
const lifecycle = AppState.addEventListener('change', next => {
console.info(`[HandoverSummary] change ${next}`);
setState(next);
setChanges(previous => [...previous.slice(-3), next]);
if (next !== 'active') {
setExpandedId(null);
}
});
const windowEvents = DeviceEventEmitter.addListener(
'handoverWindowVisibility', (visible: boolean) => {
console.info(`[HandoverSummary] window ${visible ? 'shown' : 'hidden'}`);
setLastWindowEvent(visible ? '重新显示' : '隐藏');
if (!visible) {
setExpandedId(null);
}
},
);
// 和 focus、blur 的订阅一起在 effect 的清理函数里 remove。
本轮 1.0.1 新包在同一进程 22017 内重做了一次。展开 S-2807,打开系统控制面板,再点回标题栏,日志只有 blur、focus,订单摘要仍显示 S-2807。这个操作保留窗口可见,检验的是临时查资料的同类失焦路径,不把它写成应用进入后台。
接着点交接台最小化,从程序坞恢复,前后进程号仍为 22017。日志实际收到 native visibility false、window hidden,恢复时为 true、shown,页面回到全部收起。值得保留的差别是:本轮观察栏的应用状态始终 active,没有出现 background。因此窗口回调不是用来装饰日志的;如果只照搬“必须等 background”这个条件,本轮这条真实操作就没有得到同样保证。
恢复后再打开 S-2814,班组、物料和备注都还在。缩窄窗口不收起它,订单和观察栏改为上下排列;滚动即可读到下方状态。最后结束进程重开,进程号变为 22483,初始摘要全部收起。冷启动只验证初始化,与前面的同进程恢复分开记录。




以下保留历史 1.0.0 真机和模拟器无声实录:展开订单、最小化、通过程序坞恢复,再次展开。新包的复测以本轮截图和日志为据。
补录换用旁边的自有打包测试窗口做普通失焦对照,返回后S-2807摘要仍在。接着真正最小化交接台,等隐藏动画完成再恢复,摘要变成全部收起;右栏仍可能是active,但可见性显示重新显示。之后打开S-2814,再结束进程冷启动,回到全部收起。不同离开方式在同一段里分别发生,没有用窗口被另一页盖住来冒充已经最小化。

原片平均60.01 fps,GIF保留1474帧、24.56秒,平均60.02 fps,无插帧或额外复制帧。此处窗口隐藏本身就是本篇被验证的业务条件,没有拖边框片段。
MateBook Pro 2in1 模拟器无声录屏。从摘要打开到隐藏、恢复和查看另一笔订单。

两段历史视频均只有视频轨,重新解码没有发现音频。原批次按业务动作记录的帧率为真机约 23.04 fps、模拟器约 3.99 fps;成片容器报告的平均帧率约 18.15 和 3.79 fps,计算口径与只取动作时间不同。GIF 播放帧率另外核对,不能把低帧率的旧素材写成新采集的 60 fps。它们适合核对展开、隐藏、恢复这些离散状态。
鸿蒙电脑上生成能离线启动的交接台
这次从源码归档解包到 MateBook 14 的 Documents/ugc-native-69/RnohHandoverSummary,不带旧 node_modules、业务库和离线 bundle。原生 DevEco 打开 harmony 工程,页面源文件在上一层 App.tsx,窗口桥接在 entry/src/main/ets/pages/Index.ets。本机将页面说明改为“先核对订单,再展开班组与物料摘要。”,重新生成 bundle 后才打包。运行截图里可以对照这句话,避免拿已经装着的旧包代替本次工程。
cd ~/Documents/ugc-native-69/RnohHandoverSummary
node --version
npm --version
npm ci --ignore-scripts --no-audit --no-fund
node node_modules/react-native/cli.js bundle-harmony --dev false --minify false
ls -l harmony/entry/src/main/resources/rawfile/bundle.harmony.js
test -s node_modules/@react-native-oh/react-native-harmony/react_native_openharmony.har
cd harmony
ohpm install --all
hvigorw --mode module -p product=default -p module=entry@default -p buildMode=debug assembleHap --no-daemon
npm ci 按锁文件恢复依赖,Metro 根据本工程入口生成 bundle.harmony.js。宿主使用 ResourceJSBundleProvider 从包内资源读取,不依赖外部 Metro 服务保持在线。框架原生依赖采用 RNOH 0.84.4 官方 HAR,HAR 内需要编译的 RNOH C++、本应用入口和 JS bundle 在鸿蒙电脑编译与生成;不会把框架发行包说成本次从全部框架源码重建。
首次完整构建 35 项任务,用时 8 分 43.144 秒;修正打包过滤后的签名构建 34 项任务,用时 54.400 秒。DevEco 项目结构为当前包名生成调试签名,安装读回 1.0.1(1000001)。签名 HAP 40,347,791 字节,SHA-256 前缀 2bb1763a4b1c。解包后有九份 ARM64 动态库,离线 bundle 2,740,336 字节,与本机生成文件逐字节相同,摘要前缀 99337c7114d0。
cd ~/Documents/ugc-native-69/RnohHandoverSummary/harmony
bm install -p entry/build/default/outputs/default/entry-default-signed.hap
aa start -b com.aasd23.ugcrnhandover -a EntryAbility
bm dump -n com.aasd23.ugcrnhandover


| 对象 | 型号、完整版本与工具 | 这次核对的范围 |
| 鸿蒙本机开发与运行 | MateBook 14 MNTXM-24B;HarmonyOS 7.0.0,7.0.0.115(SP11C00E103R12P2patch01);API 26.0.0;aarch64 | 源码恢复、编辑、离线 bundle、原生编译、签名安装和窗口行为 |
| 本机工具 | DevEco Studio 26.0.0 Beta,构建 26.0.0.220;Node 24.18.1;React Native 0.84.1;RNOH 0.84.4;Metro 0.83.8 | 目标/兼容 API 24;2in1;本次只生成 arm64-v8a |
| 历史模拟器 | MateBook Pro 2in1;配置6.1.1(API24),实际6.1.0.125(SP12DEVC00E47R1P3),API24,x86_64。模拟器已启动;当前1.0.1仅ARM64,旧版摘要生命周期视频不算本轮新包验证。 | 本轮验证范围见新增实测记录,历史视频仍按原批次说明区分。 |



FAQ:别把重启和回到窗口混在一起
只设 abiFilters,为什么验包还能找到 x86_64?这次原生编译目标已经是 ARM64,但依赖的 HAR 又带入 x86_64 的 libc++ 和 ffrt 两份运行库。编译过滤与依赖打包过滤是两个位置。我在本机 harmony/entry/build-profile.json5 的 buildOption.nativeLib.filter.excludes 加入 **/x86_64/*.so 后重建,并对签名 HAP 再逐库核对 ELF 架构,才进入安装测试。配置含义可对照华为原生库打包说明。
签名重建还遇到过 00303300,日志指向 glog 的 CMakeTmp/uctfield.c 缺失。首次完整编译已经通过,不能因此认定业务算法有错。本轮保留失败日志,等 IDE 初始化结束后在同一目录重跑,CMake 与 HAP 构建恢复。这里记录的是本次恢复过程,没有把一次临时文件错误归纳成所有 RNOH 项目的固定故障。
第一次出现 window shown,只能说明窗口可见。首次挂载也可能收到这个事件,不能据它判断发生过最小化恢复。本轮先记进程号,在同一进程里展开、最小化、恢复,再另外结束进程做冷启动。两条路径都能看到全部收起,但后者验证初始化,前者才验证离开后的状态清理。
如果两个通知都到了,会不会把订单清掉两次?清理目标是 expandedId,赋值 null 可以重复执行,订单数组并未被删除。宿主监听要在页面退出时卸掉,React effect 同样移除订阅;否则页面重新挂载可能留下旧监听,观察栏会出现重复事件,后续定位会误判系统发了两次。
为什么不直接遇到 blur 就收起?桌面操作中,去旁边资料窗口看一眼很常见,窗口仍可见并不意味着交接结束。本篇选择隐藏或离开 active 时收起,是当前交接台的交互规则,不是对所有业务的统一要求。若真实订单有隐私要求,还需另外验证系统缩略图、锁屏和截图能力,折叠一段文字不能承担这些安全效果。
回到交接台时,下一班仍能认出三笔订单,却不会被上一班留下的展开项带着走;暂时切到旁边核对资料,则可以继续看原来的那笔。这个区别要靠真实桌面操作和事件记录一起解释。后面接真实数据时,数据层继续保管订单,页面只管理“现在展开谁”和“什么时候收起来”,两者各自承担清楚的责任。
更多推荐


所有评论(0)