鸿蒙 PC 的 React Native 发运准备单,确认一项怎样正确移组
React Native鸿蒙适配的AtomGit分支 · 发运准备单完整工程与16组合模型检查
发运准备单里有四笔任务,总共十九箱。滨江仓 D-086 是中间的一笔,七箱备货托盘。装车员在鸿蒙 PC 点确认,是告诉下一班“这笔已经核过了”;订单并没有消失,也没有多出七箱。待确认和已确认应当只是同一份清单的两种呈现。只要把这件事想清楚,就不需要维护两份订单,再用两个计数器追着按钮修改数字。
这篇用 React Native 的 SectionList 做一个本地发运页面。工程 RnohDispatchSections 用四笔合成记录说明移组规则,不接真实仓库,也不把点击当成后台发运成功。源码中的每笔订单只保存一次,确认字段决定它在哪一组。先建立这个约束,再看按钮、组头和空态,代码里的状态关系就有了可以核对的依据。
十九箱不随确认动作改变
| 单号 | 去向与物料 | 箱数 | 初始状态 |
| D-071 | 城北站,周转箱 | 4 | 待确认 |
| D-086 | 滨江仓,备货托盘 | 7 | 待确认 |
| D-104 | 河口站,封装配件 | 5 | 待确认 |
| D-117 | 高新仓,检验样箱 | 3 | 已确认 |
页面持有的 shipments 数组是唯一业务清单。两个分组由 checked 值筛出来,单数取分组长度,箱数由该组数据求和,页头的四单十九箱直接来自总清单。初始待确认十六箱、已确认三箱;七箱托盘移组后,应当分别变成九箱和十箱。两边各显示两行仍不足以证明移对,去向、单号与箱数必须一起核对。
function sumCartons(shipments: Shipment[]): number {
return shipments.reduce((total, shipment) => total + shipment.cartons, 0);
}
function groupShipments(shipments: Shipment[]): DispatchSection[] {
const waiting = shipments.filter(shipment => !shipment.checked);
const confirmed = shipments.filter(shipment => shipment.checked);
return [
{key: 'waiting', title: '待确认', cartons: sumCartons(waiting), data: waiting},
{key: 'confirmed', title: '已确认', cartons: sumCartons(confirmed), data: confirmed},
];
}
function updateCheck(id: string, checked: boolean) {
setShipments(current => {
const shipment = current.find(item => item.id === id);
if (!shipment || shipment.checked === checked) {
return current;
}
return current.map(item => item.id === id ? {...item, checked} : item);
});
}
这两个 key 各有职责。分组用 waiting、confirmed,单据用稳定的业务 ID。D-086 从待确认第二行移到已确认第一行时,下标已经改变,它的身份不能跟着下标换掉。确认回调携带单号和目标值,在 React 状态更新函数里读取最近一次清单,再用 map 返回新数组;只替换命中的记录,其他行继续保留。目标已经处于所需状态时直接返回原数组,避免把同一个目标请求又处理成反向操作。
本机还直接取 App.tsx 中的 groupShipments、sumCartons 原函数,核对了四笔记录的十六种确认组合。每一种都应当满足:两组并集恰好四个唯一 ID,未确认与已确认各自符合 checked 条件,两组箱数加起来十九。这个检查没有另写一份分组算法来和自己比较,也不验证鼠标按钮、滚动与宿主是否工作;这些留给实际安装包操作。
SectionList 属于浅比较组件。这里确认后得到新 shipments,useMemo 据它生成新 sections,记录里的 checked 也随新对象传给 renderItem,因此列表可以看到变化。未来如果行的外观还取决于 sections 之外的选中状态,需要把那份依赖一并传入,例如使用 extraData;不能把“加一个强制刷新计数”当成当前数据关系的修复。SectionList 的更新和 key 约定
<SectionList<Shipment, DispatchSection>
style={styles.list}
sections={sections}
keyExtractor={item => item.id}
stickySectionHeadersEnabled={false}
contentContainerStyle={styles.listContent}
renderSectionHeader={({section}) => (
<View style={styles.sectionHeader}>
<Text style={styles.groupTitle}>{section.title}</Text>
<Text style={styles.groupStat}>{section.data.length} 单 · {section.cartons} 箱</Text>
</View>
)}
renderSectionFooter={({section}) => section.data.length === 0 ? (
<View style={styles.empty}>
<Text style={styles.emptyText}>{section.key === 'waiting' ? '本班发运单已全部确认' : '还没有已确认的发运单'}</Text>
</View>
) : null}
renderItem={({item}) => (
<View style={[styles.row, compact && styles.rowCompact]}>
<View style={styles.description}>
<Text style={styles.code}>{item.id}</Text>
<Text style={styles.destination}>{item.destination}</Text>
<Text style={styles.item}>{item.item} · {item.cartons} 箱</Text>
</View>
<Pressable
accessibilityRole="button"
accessibilityLabel={`${item.checked ? '撤销' : '确认'} ${item.id}`}
onPress={() => updateCheck(item.id, !item.checked)}
style={({pressed}) => [styles.button, item.checked && styles.undo, pressed && styles.pressed]}>
<Text style={[styles.buttonText, item.checked && styles.undoText]}>{item.checked ? '撤销确认' : '确认装车'}</Text>
</Pressable>
</View>
)}
/>
两个分组始终在数组中,空的是组内 data,而不是整个列表。最后一单确认后,已确认还有四笔,ListEmptyComponent 不能承担“待确认已经完成”的提示。这里把提示放在 renderSectionFooter,逐组判断长度。空组保留标题和零数量,装车员可以分辨是完成了这班任务,还是页面没加载出数据;本地示例没有把网络失败、今天无任务等状态塞进这句提示。
让这份清单在鸿蒙电脑生成安装包
本轮在 MateBook 14 解包工程,不携带旧 node_modules、离线 bundle 和编译目录。原生 DevEco 打开 harmony,业务页面位于根目录 App.tsx。本机把说明改为“核对每张发运单,确认后仍可撤销。”,随后恢复锁定依赖、生成 Metro bundle、编译原生入口。截图里的说明与本机源码相互对应,不能只看桌面上已经存在一个同名应用。
cd ~/Documents/ugc-native-70/RnohDispatchSections
node --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
cd harmony
ohpm install --all
hvigorw --mode module -p product=default -p module=entry@default -p buildMode=debug assembleHap --no-daemon
本机 Node 24.18.1 运行 Metro 0.83.8,React Native 为 0.84.1,RNOH 为 0.84.4。RNOH 依赖来自官方发行 HAR,其中需要本地构建的 C++ 参与本机编译;工程自己的 ArkTS 宿主和本次 JS bundle 也在这台电脑生成。运行时使用 ResourceJSBundleProvider 读取包内资源,没有再连接外部 Metro 服务来补业务代码。
完整构建完成 35 项任务,用时 8 分 44.841 秒。DevEco 项目结构为 com.aasd23.ugcrndispatch 生成匹配测试设备的调试签名;签名重建完成 34 项任务,用时 55 s 626 ms。目标和兼容 API 为 24,设备类型为 2in1。编译仅选择 ARM64,依赖库打包另用 nativeLib.filter.excludes 排除 x86_64,避免把编译过滤误当成所有依赖都会过滤。
签名包为 40,357,633 字节,SHA-256 前缀 f6182fd1c9d4。包内九份动态库均检查为 ARM64;离线 bundle 2,738,949 字节,与本机本次输出逐字节相同,摘要前缀 82efb5a99e09。安装后读回 1.0.1(1000001),再开始业务操作。不上架的这个项目验收到安装运行,没有编造 AppGallery Connect 上传结果。
cd ~/Documents/ugc-native-70/RnohDispatchSections/harmony
bm install -p entry/build/default/outputs/default/entry-default-signed.hap
aa start -b com.aasd23.ugcrndispatch -a EntryAbility
bm dump -n com.aasd23.ugcrndispatch


把中间一单送过去,再送回来
本轮签名包启动后,先等初始组头和按钮都出现,再操作 D-086。它从待确认第二行进入已确认第一行,去向仍为滨江仓、货名仍为备货托盘;组头对应变为两单九箱和两单十箱。撤销后,D-086 回到 D-071 与 D-104 中间,三单十六箱、一单三箱恢复,页头十九箱一直不变。
接着逐条确认 D-071、D-086、D-104,待确认保留“本班发运单已全部确认”,已确认有四条、十九箱。缩到窄窗后,在已确认里只撤销 D-086,实测待确认一单七箱,已确认三单十二箱。日志同时列出各组 ID、箱数和总量,能够与截图逐项对照。最后结束进程重开,回到初始三单十六箱与一单三箱,核实当前演示状态没有被当成持久化发运记录。
| 本轮操作 | 待确认预期 | 已确认预期 | 需要另外核对 |
| 初次进入 | 3 单、16 箱 | 1 单、3 箱 | 页头 4 单、19 箱 |
| 确认 D-086 | 2 单、9 箱 | 2 单、10 箱 | 滨江仓与七箱随同一 ID 移组 |
| 撤销 D-086 | 3 单、16 箱 | 1 单、3 箱 | 回到 D-071 与 D-104 之间 |
| 确认全部剩余项 | 0 单、0 箱 | 4 单、19 箱 | 空组保留完成提示 |
| 仅撤销 D-086 | 1 单、7 箱 | 3 单、12 箱 | 窄窗也能完成与回查 |



下方旧1.0.0双端视频仍作历史对照;新增1.0.1真机GIF展示本轮移组和守恒检查。模拟器已经启动,但当前只编译打包ARM64,旧x86视频不算本轮新包验收。
新GIF先确认D-086,七箱托盘从待确认移到已确认,箱数由16/3变成9/10;撤销后回到16/3。再逐笔确认剩余任务,待确认组保留完成提示,已确认汇总19箱。最后只撤销D-086,变成7/12。每个停点都同时检查四个唯一单号和页头19箱,移动后没有复制出第五条,也没有把别的七箱记录误移过去。

原片平均60.03 fps,GIF保留1359帧、22.64秒,平均60.03 fps,静音实录,无插帧或额外复制帧。页面只演示本地状态移组,没有把点击记录成真实仓库发运事务。
MateBook Pro 2in1 模拟器静音录屏。从 3 单待确认到 0 单,观察总量与分组同步更新。

旧录像记录的动作段帧率为真机约 8.81 fps、模拟器约 4.27 fps,属于低帧率实录。GIF 另按帧延时核对,保留确认、撤销和空组出现的实际画面,没有通过重复帧把旧采样写成高帧率。原视频重新解码后仅有视频轨。
| 复现对象 | 型号与完整版本 | 对应证据范围 |
| 鸿蒙本机开发和运行 | MateBook 14 MNTXM-24B;HarmonyOS 7.0.0,7.0.0.115(SP11C00E103R12P2patch01);API 26.0.0;aarch64 | 获取工程、编辑页面、本机编译、签名、安装和确认/撤销复测 |
| 本机 IDE 与构建目标 | DevEco Studio 26.0.0 Beta,构建 26.0.0.220;Node 24.18.1;React Native 0.84.1;RNOH 0.84.4 | 2in1,目标和兼容 API 24,arm64-v8a;依赖打包排除 x86_64 |
| 历史模拟器 | MateBook Pro 2in1;配置6.1.1(API24),实际6.1.0.125(SP12DEVC00E47R1P3),API24,x86_64。模拟器已启动;当前1.0.1仅ARM64,旧发运移组录像按历史范围保留。 | 本轮验证范围见新增实测记录,历史视频仍按原批次说明区分。 |



FAQ 与使用边界
本机签名重建曾返回 00303300,具体日志是在 glog 的 CMakeTmp 里找不到 build.ninja,发生在 CMake 探测阶段。完整首次构建已通过,本轮保留这份失败日志,在 IDE 初始化稳定后从同一目录重跑;业务分组函数未为绕过错误而改写。复现时先定位报错阶段,再区分临时生成目录、原生编译和页面逻辑,不能只凭最后一行 BUILD FAILED 判断七箱移组代码有问题。
“启动成功”后立即截图为什么可能只有白窗?旧模拟器首轮已经遇到:系统返回 start ability successfully 时,React 页面尚未完成挂载。本轮从初始 DispatchSections 日志和同屏按钮都出现后才开始确认。启动命令能证明 Ability 接到了启动请求,不能证明业务数据已经画完,也不能拿那一帧白窗当列表渲染失败的最终证据。
确认后要不要另改组头数字?本例没有独立计数器,组头由分组数据派生。若行移过去而组头没变,先查是否原地修改数组、是否给 SectionList 传了旧引用,再核对真正提交的状态日志。这个方向比先加一个计数器更容易找到数据关系的问题。本次只用四笔样本验证状态一致,没有据此宣称长列表性能。
连续两次点击能否当重复请求测试?不能直接等同。界面第一次确认后按钮已经变成撤销,第二次点击可能是一个有意义的反向命令。代码对同一 ID、同一目标 checked 值做幂等保护;若后面接网络接口,还需要请求标识、服务端版本冲突和响应时序等验证,不能靠本地按钮回调保证远端事务只发生一次。
重开后为什么回到最初三条待确认?本篇只维护当前进程内的演示状态,没有持久化或真实发运接口。本轮单独结束进程再开,重新载入初始清单,和“撤销后读回”是不同的操作。需要跨重启保留时,应先决定存储与服务端谁是数据来源,再补异常恢复,不能把当前示例包装成生产出库系统。
七箱托盘去哪一组、撤销后回到哪里、两边各剩多少,是这张准备单真正需要说明的结果。让一份清单驱动分组、组头和页头,四单十九箱便可以贯穿每次操作核对。以后扩展后台同步时,也应先守住这份状态关系,再处理网络、权限与真实装车流程,而不是让几个互相独立的数字替读者制造另一张账。
更多推荐

所有评论(0)