欢迎加入开源鸿蒙 PC 社区

欢迎在 PC 社区平台申请新建项目

框架与适配:React Native for OpenHarmony 适配

本文示例与复现材料

一张备件台账可能有几十行。用户进详情复核后,返回列表是为了接着看旁边的记录;在此期间若筛选条件变化,用旧的滚动偏移就未必回到原物料附近。这里给每条物料一个可核对的编号,用邻近行证明 React Native 页面恢复的是谁。

从维修仓接到的任务是找 SP-040,打开详情核对一次,再返回到它附近。我把它做成鸿蒙 PC 上的一次 React Native 台账巡检,给每一步都留了一个邻居。全表里 SP-040 下面是 SP-041,筛掉待入库项以后,下面换成 SP-042。比起盯住滚动条,读这两个编号更容易看出程序是否回到了正确位置。

SP-040 的三次定位

第一次,八十条记录里找第四十条

鸿蒙 PC 模拟器全屏,React Native 台账从 80 条备件定位到 SP-040

鸿蒙 PC 模拟器全屏,React Native 台账从 80 条备件定位到 SP-040

React Native 的 scrollToIndex 可以接收新的下标。这个演示把每行高度固定为 58 个布局单位,分隔线放在行内,getItemLayout 的步长和实际行高度一致。这样从 SP-001 跳到尚未渲染的 SP-040 时,FlatList 可以预先计算偏移量。以后如果把分隔线单独放到 ItemSeparatorComponent,那部分高度也要计入偏移。 React Native FlatList 文档

React Native 的 FlatList 只需要知道目标在当前数组里的位置。八十个编号中每个偶数编号在库,定位按钮第一次会把 SP-040 换算为下标 39。行高固定为 58,分隔线画在行内。这样列表可以在目标还未渲染时计算位置。要把行内分隔线挪到组件外,偏移公式也得随实际高度改;设备的桌面分辨率与这里的布局单位是两套量。

第二次,筛选只留下四十条

鸿蒙 PC 模拟器全屏,切到 40 条在库备件后保留 SP-040

鸿蒙 PC 模拟器全屏,切到 40 条在库备件后保留 SP-040

此时 SP-040 仍要出现,数组下标却变成 19。拿旧的 39 去定位,结果会落到筛选列表尾部。保存的是编号,在新的集合里重新找位置,筛选逻辑便不用猜测删除了多少前面的行。遇到 SP-001 这种已经从结果移除的锚点,代码改用 SP-002。如果窄窗还开着被筛掉的详情,一起收起,避免表和详情各指一件物料。

import React, {useCallback, useLayoutEffect, useRef, useState} from 'react';
import {FlatList, Pressable, StyleSheet, Text, useWindowDimensions, View, type ViewToken} from 'react-native';

const rowHeight = 58;
const stock = Array.from({length: 80}, (_, i) => ({
  id: 'SP-' + String(i + 1).padStart(3, '0'),
  name: ['定位销', '密封圈', '传动皮带', '滚珠轴承'][i % 4],
  available: i % 2 === 1,
}));
type Part = (typeof stock)[number];
const available = stock.filter(row => row.available);

export default function App() {
  const {width} = useWindowDimensions();
  const compact = width < 700;
  const [filtered, setFiltered] = useState(false);
  const [anchor, setAnchor] = useState('SP-001');
  const [detail, setDetail] = useState<Part | null>(null);
  const [position, setPosition] = useState('SP-001');
  const rows = filtered ? available : stock;
  const list = useRef<FlatList<Part>>(null);
  const pending = useRef<{id: string; reason: string} | null>(null);
  const viewability = useRef({itemVisiblePercentThreshold: 95});
  const onVisible = useCallback(({viewableItems}: {viewableItems: ViewToken<Part>[]}) => {
    if (viewableItems[0]?.item) setPosition(viewableItems[0].item.id);
    const id = pending.current?.id;
    if (id && viewableItems.some(token => token.item.id === id)) {
      console.info('UGC_RNOH_ANCHOR visible id=' + id + ' reason=' + pending.current?.reason);
      pending.current = null;
    }
  }, []);

  function go(id: string, data: Part[], reason: string) {
    const index = data.findIndex(row => row.id === id);
    if (index < 0) return;
    pending.current = {id, reason};
    list.current?.scrollToIndex({index, animated: reason === 'jump'});
    console.info('UGC_RNOH_ANCHOR scroll id=' + id + ' index=' + index + ' reason=' + reason);
  }

  useLayoutEffect(() => {
    if (pending.current?.reason !== 'filter') return;
    const id = pending.current.id;
    const frame = requestAnimationFrame(() => go(id, rows, 'filter'));
    return () => cancelAnimationFrame(frame);
  }, [rows]);

  function toggleFilter() {
    const next = !filtered;
    const data = next ? available : stock;
    const target = data.some(row => row.id === anchor) ? anchor : data[0].id;
    pending.current = {id: target, reason: 'filter'};
    setAnchor(target);
    setFiltered(next);
    if (detail && detail.id !== target) setDetail(null);
  }

  function open(item: Part) {
    setAnchor(item.id);
    setDetail(item);
    console.info('UGC_RNOH_ANCHOR detail id=' + item.id);
  }

  function close() {
    if (!detail) return;
    go(detail.id, rows, 'return');
    setDetail(null);
    console.info('UGC_RNOH_ANCHOR return id=' + detail.id);
  }
第三次,窄窗从详情返回

鸿蒙 PC 模拟器窄窗全屏,覆盖式详情显示 SP-040

鸿蒙 PC 模拟器窄窗全屏,覆盖式详情显示 SP-040

缩窗前先打开第一行。宽窗右侧显示当前物料,缩窄后详情占据面板区域,列表仍然挂着。点返回时先用当前筛选后的数据重新定位,再移除详情。若当前可见集合没有改变,未必再出现 visible 日志。此时看新画面首行和返回标记,不能要求每次滚动调用都产生一次新的可见回调。

鸿蒙 PC 模拟器全屏,从详情返回,列表继续显示 SP-040

鸿蒙 PC 模拟器全屏,从详情返回,列表继续显示 SP-040

在真机的窄窗详情里,再找一次 SP-040

React Native 工程先用满足要求的 Node 打包台账入口,宿主用 ARM64 目标重新构建。较长的工程路径让 Windows Ninja 报文件名超过 260 字符;把构建移到较短的工作区路径后,原生模块和自动签名 HAP 都生成了。USB 安装、启动并确认已装版本 1.0.0 后,再开始找备件。

运行环境设备版本定位对照
HUAWEI MateBook 14(MNTXM-24B)HarmonyOS 7.0.0,软件 7.0.0.115(SP11C00E103R12P2patch01),API 26.0.0,aarch64签名安装,定位 39、筛选定位 19,窄窗详情返回后仍是 SP-040
MateBook Pro 2in1 模拟器HarmonyOS 6.1.0,软件 6.1.0.125(SP12DEVC00E47R1P3),API 6.1.1(24),x86_64同一编号的定位流程和演示 GIF

MateBook 14 真机关于本机全屏,显示软件版本和 API

MateBook 14 真机关于本机全屏,显示软件版本和 API

先点定位,随后切到「仅看在库」,日志的下标从 39 变成 19。打开 SP-040 详情再缩窄窗口,详情占据内容区。点「返回列表」以后,首个完整可见项仍是 SP-040,下面是 SP-042。这个邻居和全表时的 SP-041 不同,也能看出筛选条件没有丢。

MateBook 14 真机全屏,窄窗显示 SP-040 详情和返回入口

MateBook 14 真机全屏,窄窗显示 SP-040 详情和返回入口

MateBook 14 真机全屏,返回列表后首个完整可见条目仍为 SP-040

MateBook 14 真机全屏,返回列表后首个完整可见条目仍为 SP-040

MateBook 14 真机全屏录屏。定位 SP-040,再把 80 条备件筛到 40 条在库记录,打开 SP-040 详情。拖窄窗口后返回列表,首个完整可见条目仍是 SP-040。原始 MP4 为 2880 × 1920,整段约 60 fps;拖窗段一秒内有 60 个不同画面。

查看原始 MP4 录屏

install bundle successfully.
start ability successfully.
versionName: 1.0.0
UGC_RNOH_ANCHOR scroll id=SP-040 index=39 reason=jump
UGC_RNOH_ANCHOR scroll id=SP-040 index=19 reason=filter
UGC_RNOH_ANCHOR scroll id=SP-040 index=19 reason=return
UGC_RNOH_ANCHOR return id=SP-040

右侧详情在窄窗覆盖列表,下面的列表仍在。这部分参考了 Thunderbird 桌面阅读面板的分区,用空间变化决定详情放哪儿。窗口够宽时可以一边看列表一边看详情,窗口变窄后还原同一条记录,核对的是列表的位置与编号是否连续。返回动作若没改变可见范围,不需要等一条额外的可见回调。

操作预期本次观察
在全部记录中定位 SP-040以全部列表下标定位请求下标 39,SP-040 进入可见区域
切到仅看在库保持编号,以筛选后下标定位请求下标 19,屏幕显示 SP-040
打开详情并拖窄窗口详情仍为同一物料窄窗覆盖区显示 SP-040
返回列表继续查看同一备件附近的记录日志记录返回 SP-040,列表仍可见 SP-040
scroll id=SP-040 index=39 reason=jump
visible id=SP-040 reason=jump
scroll id=SP-040 index=19 reason=filter
visible id=SP-040 reason=filter
detail id=SP-040
scroll id=SP-040 index=19 reason=return
return id=SP-040

我还在鸿蒙 PC 模拟器上给「请求滚到哪里」和「实际看见什么」留了两种记录。发起滚动时打印编号和下标,列表的可见回调再检查目标是否进入可见范围。界面右上角写的是首个达到可见阈值的编号,便于对着全屏截图读结果。退出详情时列表可能已经停在 SP-040,此时可见集合可以保持不变,截图中的首个完整可见编号和返回事件一起说明当前状态。

  return (
    <View style={s.page}>
      <View style={s.top}>
        <View style={s.mark}><Text style={s.markText}>库</Text></View>
        <View style={s.topLabel}>
          <Text style={s.title}>备件台账</Text>
          <Text style={s.sub}>维修仓 · 按物料编号定位</Text>
        </View>
        {!compact && <Text style={s.count}>{rows.length} 条备件</Text>}
      </View>
      <View style={s.toolbar}>
        <Pressable accessibilityRole="button" style={[s.filter, filtered && s.filterOn]} onPress={toggleFilter}>
          <Text style={filtered ? s.darkText : s.action}>{filtered ? '显示全部' : '仅看在库'}</Text>
        </Pressable>
        <Pressable accessibilityRole="button" style={s.filter} onPress={() => {
          setAnchor('SP-040');
          go('SP-040', rows, 'jump');
        }}><Text style={s.action}>定位 SP-040</Text></Pressable>
      </View>
      <View style={s.panels}>
        <View style={s.listBox} accessibilityElementsHidden={compact && !!detail} importantForAccessibility={compact && detail ? 'no-hide-descendants' : 'auto'}>
          <View style={s.listHeader}>
            <Text style={s.panelTitle}>备件列表</Text>
            <Text style={s.sub}>首个完整可见 {position}</Text>
          </View>
          <FlatList
            ref={list} data={rows} keyExtractor={row => row.id} extraData={anchor}
            getItemLayout={(_, index) => ({length: rowHeight, offset: rowHeight * index, index})}
            onViewableItemsChanged={onVisible} viewabilityConfig={viewability.current}
            renderItem={({item}) => (
              <Pressable accessibilityRole="button" style={[s.row, item.id === anchor && s.selected]} onPress={() => open(item)}>
                <View style={s.rowLabel}><Text style={s.part}>{item.id}</Text><Text numberOfLines={1} style={s.sub}>{item.name}</Text></View>
                <Text style={[s.tag, !item.available && s.tagPending]}>{item.available ? '在库' : '待入库'}</Text>
              </Pressable>
            )}
          />
        </View>
        {(!compact || detail) && (
          <View style={[s.detail, compact && s.overlay]}>
            {detail ? <>
              <Pressable accessibilityRole="button" style={s.back} onPress={close}><Text style={s.action}>‹ 返回列表</Text></Pressable>
              <Text style={s.detailId}>{detail.id}</Text>
              <Text style={s.panelTitle}>{detail.name}</Text>
              <Text style={s.sub}>{detail.available ? '在库 · 维修仓' : '待入库 · 收货区'}</Text>
            </> : <>
              <Text style={s.panelTitle}>物料详情</Text>
              <Text style={s.sub}>在左边选择一件备件。</Text>
            </>}
          </View>
        )}
      </View>
    </View>
  );
}

const s = StyleSheet.create({
  page: {flex: 1, padding: 22, backgroundColor: '#f1f5fa'},
  top: {flexDirection: 'row', alignItems: 'center', gap: 13, marginBottom: 15},
  mark: {width: 48, height: 48, borderRadius: 14, backgroundColor: '#243c70', alignItems: 'center', justifyContent: 'center'},
  markText: {fontSize: 21, color: 'white', fontWeight: '700'},
  topLabel: {flex: 1},
  title: {fontSize: 28, fontWeight: '700', color: '#172546'},
  sub: {fontSize: 13, color: '#526481', marginTop: 3},
  count: {fontSize: 14, color: '#425b88'},
  toolbar: {flexDirection: 'row', flexWrap: 'wrap', gap: 8, marginBottom: 14},
  filter: {paddingVertical: 8, paddingHorizontal: 13, backgroundColor: '#e5edfd', borderRadius: 8},
  filterOn: {backgroundColor: '#243c70'},
  action: {fontSize: 14, fontWeight: '600', color: '#243c70'},
  darkText: {fontSize: 14, fontWeight: '600', color: 'white'},
  panels: {flex: 1, flexDirection: 'row', gap: 13, position: 'relative'},
  listBox: {flex: 1, minWidth: 0, overflow: 'hidden', borderRadius: 14, backgroundColor: 'white', borderWidth: 1, borderColor: '#dbe3f0'},
  listHeader: {flexDirection: 'row', justifyContent: 'space-between', alignItems: 'center', flexWrap: 'wrap', padding: 13, gap: 6, borderBottomWidth: 1, borderColor: '#e5ebf5'},
  panelTitle: {fontSize: 17, color: '#1d2d53', fontWeight: '700'},
  row: {height: rowHeight, flexDirection: 'row', alignItems: 'center', justifyContent: 'space-between', paddingHorizontal: 14, borderBottomWidth: 1, borderColor: '#e7edf6'},
  selected: {backgroundColor: '#edf2ff'},
  rowLabel: {flex: 1, minWidth: 0},
  part: {fontSize: 15, fontWeight: '700', color: '#253d6a'},
  tag: {fontSize: 12, color: '#236340', backgroundColor: '#e6f4eb', borderRadius: 9, paddingHorizontal: 8, paddingVertical: 4},
  tagPending: {color: '#795017', backgroundColor: '#fbefda'},
  detail: {flex: 0.72, gap: 9, padding: 20, borderRadius: 14, backgroundColor: 'white', borderWidth: 1, borderColor: '#dbe3f0'},
  overlay: {position: 'absolute', top: 0, left: 0, right: 0, bottom: 0},
  back: {alignSelf: 'flex-start', marginBottom: 14, paddingVertical: 5},
  detailId: {fontSize: 30, fontWeight: '700', color: '#1d2d53'},
});

鸿蒙 PC 模拟器实录,跳转、筛选、打开详情、缩窗与返回

鸿蒙 PC 模拟器实录,跳转、筛选、打开详情、缩窗与返回

录屏保留 80 个不同画面,共 12.43 秒。缩窄和拉宽窗口的连续变化段约为 18.8 和 18.1 帧/秒。

复测前把 bundle 做对

项目本次环境
开发机Windows,DevEco Studio 6.1.1.300,前端 Node.js 24.19.0
运行端MateBook Pro 2in1 模拟器,HarmonyOS 6.1.0,软件 6.1.0.125 (SP12DEVC00E47R1P3),API 24,x86_64
框架与目标React Native 0.84.1,RNOH 0.84.4,HarmonyOS SDK 6.1.1(24)
产物未签名调试 HAP,使用模拟器验证离线启动、列表和详情交互

开发机原生 DevEco Studio 关于窗口

开发机原生 DevEco Studio 关于窗口

MateBook Pro 模拟器原生关于本机,保留系统栏和完整软件版本

MateBook Pro 模拟器原生关于本机,保留系统栏和完整软件版本

为什么换回 DevEco 自带的 Node 后,连 Metro 配置都打不开? 本机自带的是 Node 18.20.1,这个 React Native 工程声明需要 22.11.0 或以上。我第一次误把 DevEco 的 Node 放到前面,Metro 配置在调用 configs.toReversed 时抛出错误。前端打包改用本机 Node 24.19.0 后生成了新 bundle。鸿蒙侧继续用 DevEco 现有工具构建 HAP。

Metro 报错时先读实际用于打包的 Node 版本。这个问题发生在 Windows 开发机上,还没进入鸿蒙 PC 的运行阶段。资源版切回 DevEco 打 HAP,安装以后从包内读 bundle,运行这套台账时不需要一直启动 Metro。若启动后显示的是别的页面,先比前端资源和 HAP 的更新时间,再核对入口指向的文件。

在项目根目录把演示入口放到 App.tsx,使用满足项目版本要求的 Node 打出 bundle.harmony.js,检查文件确实进入鸿蒙模块的 resources/rawfile。鸿蒙 PC 这次让页面入口从资源加载 bundle,安装前再核对 HAP 的目标架构和目标设备。运行时可以用 hilog 搜索 UGC_RNOH_ANCHOR 对照下标和可见记录。

node ./node_modules/react-native/cli.js bundle-harmony --dev false --minify false
./harmony/build.ps1

DevEco Studio 原生编辑区,React Native 鸿蒙入口包含 2in1 声明

DevEco Studio 原生编辑区,React Native 鸿蒙入口包含 2in1 声明

后台编辑区的同步提示与本次命令行出包是两条记录。前端用 Node 24 生成 JS 资源,宿主用 DevEco 的工具打 HAP;资源版从 rawfile 加载,不需要打开 Metro。实际复测到的窗口和日志均来自这份离线包。

node ./node_modules/react-native/cli.js bundle-harmony --dev false --minify false
./harmony/build.ps1
& $hdc -t $target install $hap
& $hdc -t $target shell 'aa start -b com.nutpi.myapplication -a EntryAbility'
& $hdc -t $target shell 'hilog -x'

其中 hdc 使用 DevEco SDK 工具,target 选已启动的模拟器,hap 指向 harmony 下本次 assembleHap 产物。初次运行如果显示另一个页面,先查资源文件的更新时间,再检查包内文件和宿主入口,避免拿旧版台账复测。

行名换行之后,为什么刚好总差一条? 排查时先看请求日志里的 ID 和下标。两者正确的话,再量实际行高和分隔线占用。固定 58 的前提是每一行都一样长,鸿蒙 PC 窄窗里的长物料名也只能占一行。多行名称可移到详情,或另行设计测量。后一个方案没有在这次台账中运行。

全表的下标 39 和在库表的下标 19,在 MateBook 14 与模拟器上都对应 SP-040。真机窄窗退出详情以后,也回到这个编号。这里保住的是一次工作中的位置,关进程后能否恢复筛选和锚点,取决于另行设计的存储规则。

Logo

开源鸿蒙跨平台开发社区汇聚开发者与厂商,共建“一次开发,多端部署”的开源生态,致力于降低跨端开发门槛,推动万物智联创新。

更多推荐