鸿蒙 PC 开发者社区 · AtomGit 鸿蒙 PC 社区 · React Native for OpenHarmony 框架源码

前言

照片上传以后,巡检员和复核员看的虽然是同一张图,找的却是两样东西。巡检员扫附件列表,希望先认出设备。复核员得抄出配电箱的编号,或者确认角落里是不是贴了指定工位标志。把一张正常的竖图放进统一规格的卡片,设备主体依然清楚,底部那块铭牌却可能已经离开取景框。如果把缩略图当成证据看,缺了一块也很难察觉。

这款鸿蒙 PC 的 React Native 巡检照片卡保留了这两个步骤。列表给出统一尺寸的预览和文本编号,点进附件后可以从「填满卡片」切到「完整照片」。本篇用两张随项目提供的样图,一张把文字放在底部,另一张把文字放在右侧。看到哪个编号、从哪个方向看见它,都是可重复查验的结果。

取景框的尺寸先确定,再决定裁哪一边

两张样图都是同一批制作的测试数据。配电箱照片是 520 × 780,目标编号 PF-218 位于底部。工位照片是 780 × 520,右侧标识写 WG-016。在宽窗里,预览图的实际设计上限是 390 × 328。用竖图来算,铺满横向需要原图缩到 0.75 倍,缩完仍有 585 高,高于卡片的 328。上下裁去的部分加起来约 257,底端的铭牌预期不会出现在图里。要完整放进去,约束来自框高,宽度自然收窄,左右看得见深色留边。

换成横图以后要沿另一条边判断。铺满 328 的高度约需保留六成三的原始比例,宽度约 492,超过卡片宽度。即便照片已经解码,最右侧也仍可能位于框外。如果选择完整显示,就转而受 390 的宽度限制,空出来的区域变成顶部和底部。这个推导描述的是满宽取景框。窄窗可用宽度更小时,裁切和留边的具体尺寸会随之改变,复测要看右边标志实际能不能读清。

这里将预览高度写成明确的 328,并限制宽度最多 390。早期版本曾给子图片百分比高度,图像一直延伸到首屏下面。当铭牌看不见时,既可能是 resizeMode 裁掉,也可能是整个取景框还没出现在视口里。现在先让用户看见取景框全边,再切换显示规则,画面的可比性才成立。暗色留边只表示照片没有铺满框,不能仅凭背景颜色判断素材是否缺失。两张样图把标识做成醒目的浅色,便于肉眼和截图核对。

React Native Image 属性说明

文字编号与图中编号各有证据

左侧缩略图保持 cover,文字编号由附件数据提供。右侧每次切换时,传给 Image 的文件仍是同一份,只有预览的 resizeMode 发生变化。复核时要看图里有没有 PF-218 和 WG-016,列表右边的文字只是定位辅助。缩略图标题、文件内容和界面当前展开的预览是三个不同层次,实际项目换成归档照片后仍然要分别查对。

代码把选中附件和显示模式分别存起来。切换附件时,React 将新编号作为 Image 的 key,等它真正完成加载才更新提示。当前模式不随选中项变化,这让复核员在一批照片中持续用全图检查。横竖布局只读 useWindowDimensions 的窗口宽度,宽度达到 750 并排,低于阈值上下排列,页面不会为每个宽度另做一份附件状态。

从代码中可以顺着看出一次操作的路径。选中项找到 specimen,specimen.image 指向打包资源;预览按钮更新 mode,下一次组件渲染把值交给 Image。日志里的 UGC_RNOH_PHOTO 记录附件编号和模式,排查时用它确认按钮走到了哪条路径。口头说「当前选的是完整照片」与从屏幕边缘看见编号,两者要一起核对。

import React, {useState} from 'react';
import {
  Image, ImageSourcePropType, Pressable, ScrollView, StyleSheet, Text, View, useWindowDimensions,
} from 'react-native';

type Mode = 'cover' | 'contain';
type Specimen = {
  id: string;
  name: string;
  note: string;
  ratio: string;
  image: ImageSourcePropType;
};

const specimens: Specimen[] = [
  {id: 'PF-218', name: '配电箱标签', note: '铭牌位于竖图底部', ratio: '2 ∶ 3', image: require('./assets/panel.png')},
  {id: 'WG-016', name: '工位守护标志', note: '标识位于横图右侧', ratio: '3 ∶ 2', image: require('./assets/station.png')},
];

export default function App() {
  const {width} = useWindowDimensions();
  const [selected, setSelected] = useState(0);
  const [mode, setMode] = useState<Mode>('cover');
  const [loaded, setLoaded] = useState<string>();
  const specimen = specimens[selected];
  const wide = width >= 750;
  const chooseMode = (next: Mode) => {
    console.info('UGC_RNOH_PHOTO', specimen.id, next);
    setMode(next);
  };

  return (
    <ScrollView style={styles.page} contentContainerStyle={styles.scroll}>
      <View style={styles.header}>
        <View><Text style={styles.kicker}>设备巡检 / 图像复核</Text><Text style={styles.title}>巡检照片卡</Text></View>
        <Text style={styles.dataLabel}>测试样图</Text>
      </View>
      <View style={[styles.workspace, wide && styles.wide]}>
        <View style={[styles.rail, wide && styles.wideRail]}>
          <Text style={styles.railTitle}>附件</Text>
          {specimens.map((item, index) => (
            <Pressable key={item.id} accessibilityRole="button" accessibilityState={{selected: index === selected}}
              onPress={() => {setSelected(index); console.info('UGC_RNOH_PHOTO', item.id, mode);}}
              style={[styles.attachment, selected === index && styles.active]}>
              <Image source={item.image} resizeMode="cover" style={styles.thumb} />
              <View style={styles.caption}>
                <Text style={styles.name}>{item.name}</Text>
                <Text style={styles.lightText}>{item.id} · {item.ratio}</Text>
              </View>
            </Pressable>
          ))}
        </View>
        <View style={styles.preview}>
          <View style={styles.previewHead}>
            <View><Text style={styles.name}>{specimen.name}</Text><Text style={styles.lightText}>{specimen.note}</Text></View>
            <View style={styles.switcher} accessibilityLabel="图片显示方式">
              {([['cover', '填满卡片'], ['contain', '完整照片']] as const).map(([value, label]) => (
                <Pressable key={value} accessibilityRole="button" accessibilityState={{selected: mode === value}}
                  onPress={() => chooseMode(value)} style={[styles.choice, mode === value && styles.selectedChoice]}>
                  <Text style={[styles.choiceText, mode === value && styles.selectedText]}>{label}</Text>
                </Pressable>
              ))}
            </View>
          </View>
          <Image key={specimen.id} source={specimen.image} style={styles.image} resizeMode={mode}
            accessibilityLabel={specimen.name} onLoad={() => setLoaded(specimen.id)} />
          <Text style={styles.lightText} accessibilityLiveRegion="polite">
            {loaded === specimen.id ? (mode === 'cover' ? '填满取景框,超出的部分会裁切。' : '完整显示照片,空余区域保留。') : '正在载入本地图像…'}
          </Text>
        </View>
      </View>
    </ScrollView>
  );
}

const styles = StyleSheet.create({
  page: {flex: 1, backgroundColor: '#e8eef4'},
  scroll: {width: '100%', maxWidth: 1190, alignSelf: 'center', padding: 28, paddingBottom: 38},
  header: {flexDirection: 'row', justifyContent: 'space-between', alignItems: 'center', marginBottom: 22},
  kicker: {color: '#435a73', fontSize: 14, fontWeight: '600', letterSpacing: 2},
  title: {color: '#182b3d', fontSize: 39, fontWeight: '800', marginTop: 3},
  dataLabel: {color: '#2b4863', backgroundColor: '#d4e3f0', padding: 8, borderRadius: 10},
  workspace: {gap: 14},
  wide: {flexDirection: 'row', alignItems: 'flex-start'},
  rail: {backgroundColor: '#f7faff', padding: 13, borderRadius: 14, gap: 8},
  wideRail: {width: 224},
  railTitle: {color: '#1b344b', fontSize: 18, fontWeight: '700', marginBottom: 4},
  attachment: {flexDirection: 'row', alignItems: 'center', gap: 8, padding: 7, borderRadius: 8},
  active: {backgroundColor: '#d7e8f5'},
  thumb: {width: 46, height: 46, borderRadius: 5, backgroundColor: '#344359'},
  caption: {flex: 1},
  name: {color: '#1b344b', fontWeight: '700', fontSize: 17},
  lightText: {color: '#4a5f72', fontSize: 13, marginTop: 3},
  preview: {flex: 1, minWidth: 0, backgroundColor: '#f7faff', padding: 16, borderRadius: 14, gap: 12},
  previewHead: {flexDirection: 'row', flexWrap: 'wrap', alignItems: 'center', justifyContent: 'space-between', gap: 9},
  switcher: {flexDirection: 'row', borderRadius: 9, backgroundColor: '#e1e8ef', padding: 3},
  choice: {paddingHorizontal: 10, paddingVertical: 7, borderRadius: 7},
  selectedChoice: {backgroundColor: '#27587c'},
  choiceText: {color: '#244360', fontWeight: '600', fontSize: 13},
  selectedText: {color: '#ffffff'},
  image: {width: '100%', maxWidth: 390, height: 328, alignSelf: 'center', backgroundColor: '#1b354c', borderRadius: 9},
});

把两处容易丢的编号找回来

在本机签名安装的 1.0.1 上,默认打开配电箱标签,预览模式是「填满卡片」。窗口里只看到箱体中部的指示灯和边缘,图里看不到底下的编号。左边条目上的 PF-218 依然可见,这正好说明附件文本和照片证据不能互相替代。切到「完整照片」后,箱体底端出现黄色铭牌,从图中直接读到 PF-218,日志也留下 PF-218、contain。

接下来点第二条附件,原来的完整模式仍然选中,右侧黄色工位标识里能读出 WG-016。按「填满卡片」以后,同一编号在图里只剩 WG-01。切回完整再次读到最后一位。这组动作验证了三个独立事实,切附件后仍然能找到本地图,完整模式会保留到下一条附件,裁切只影响可见区域。日志记录了 WG-016 的 contain、cover、contain,与截图中按钮高亮和文字变化一致。

窗口缩窄后,列表在上,预览卡片向下排。这时候再按一次「填满卡片」,然后回到「完整照片」,向下滚动到整个深色取景框,图中的 WG-016 仍在右侧。窄窗会改变预览区能用的宽度,也会让用户需要先滚动,但两种模式操作仍可完成。相邻两张图最好检查完整的标志与模式按钮,避免把窗口滚动误当成裁切差异。

旧版 1.0.0 的真机和模拟器录屏随文保留,两段均为无声采集。下面的录屏和 GIF 记录了当时两种模式的变化,本次本机重建和安装使用上面的 1.0.1 截图及日志作证。

真机上的两张图和两种预览方式。MateBook 14 无声实录。整段平均 2.95 帧每秒,2.5 至 6 秒操作段每秒 1.71 个不同画面。

模拟器上的同一组预览操作。MateBook Pro 模拟器无声实录。整段平均 3.06 帧每秒,3 至 13 秒操作段每秒 3.10 个不同画面。

没有 Metro 服务,照片怎样进入安装包

要让复核人员到了设备间仍然能打开样图,先把界面脚本和图片做成包内资源。源码目录里的 assets 保留两张原图,harmony 是鸿蒙工程。将项目源码归档放在 MateBook 14,本机解压后在 DevEco Studio 终端执行构建。先在含 package-lock.json 的目录恢复锁定的依赖,再执行 bundle-harmony。使用 Node 直接调用项目内的 React Native CLI,这个命令只运行到生成资源,不会起 Metro 服务,也不依赖另一台电脑提供一个调试地址。

tar -xzf rnoh-inspection-image-source.tar.gz
cd RnohInspectionImage
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
p=harmony/entry/src/main/resources/rawfile
ls -l "$p/bundle.harmony.js" "$p/assets/assets/panel.png" "$p/assets/assets/station.png"
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

Metro 生成的文件进到 harmony/entry/src/main/resources/rawfile。这里可以先看三项产物。bundle.harmony.js 是页面脚本,本机这次生成了 2,737,908 字节。panel.png 和 station.png 是它引用的实际素材,文件为 15,635 和 13,854 字节。再打开宿主的 Index.ets,看 ResourceJSBundleProvider 是否从应用资源管理器读取同名文件。先确认资源已生成,再看入口是否读取它,能把打包漏资源和入口配置不对区分开。Metro 日志里的「Copied 2 assets」要同项目里的两张图对应,不能拿缩略图的文字当作图片已经进包的证据。

import {
  RNApp,
  RNOHErrorDialog,
  ResourceJSBundleProvider,
  RNOHCoreContext
} from '@rnoh/react-native-openharmony';
import { getRNOHPackages } from '../PackageProvider';

@Entry
@Component
struct Index {
  @StorageLink('RNOHCoreContext') private rnohCoreContext: RNOHCoreContext | undefined = undefined

  build() {
    Column() {
      if (this.rnohCoreContext) {
        if (this.rnohCoreContext?.isDebugModeEnabled) {
          RNOHErrorDialog({ ctx: this.rnohCoreContext })
        }
        RNApp({
          rnInstanceConfig: {
            name: "AwesomeProject",
            createRNPackages: getRNOHPackages,
            fontResourceByFontFamily: {},
            enableDebugger: this.rnohCoreContext?.isDebugModeEnabled,
          },
          appKey: "AwesomeProject",
          jsBundleProvider: new ResourceJSBundleProvider(
            this.rnohCoreContext.uiAbilityContext.resourceManager, 'bundle.harmony.js'
          ),
        })
      }
    }
    .height('100%')
    .width('100%')
  }
}

鸿蒙工程同时用 OhPM 处理 HAR 依赖。项目的 oh-package.json5 从 node_modules 读取 React Native for OpenHarmony 的 HAR;Hvigor 配置也引用项目内的适配插件。原生部分需要 CMake、Ninja 和 DevEco SDK 内的 Clang。本机日志先完成 ArkTS 构建,再继续编译 RNOH 的原生源码。本次首轮 Hvigor 执行 35 项任务,耗时 8 分 3.272 秒,其中 Ninja 阶段耗时 7 分 2.257 秒,最终未签名 HAP 为 71,085,493 字节。终端暂时没刷新不等于失败,可以查 Hvigor 和 Ninja 是否仍有运行中的编译、目标输出是否仍在增长,等实际出现 BUILD SUCCESSFUL 与 HAP 后再进入签名。

第一次运行未签名包时,系统给出 9568320 和 no signature file。生成签名后,IDE 重同步和构建日志中同时出现 CMakeTmp 下 build.ninja 缺失。等 IDE 内任务全部结束,再用终端执行单次 assembleHap,54.988 秒完成并生成 71,747,859 字节的签名包。安装由本机调试服务读取这份 HAP,返回 install bundle successfully,随后启动 EntryAbility 并查回版本。这里把同步、构建、安装逐个执行,可以用首条错误定位到是哪一步失败。

签名时在 DevEco Studio 打开 harmony 工程,确认入口模块是 entry、设备是「此电脑」。在项目结构的签名配置中用已登录账号生成匹配应用包名和此设备的调试签名。生成后重新构建或运行,检查安装使用的是 entry-default-signed.hap,核对包名 com.aasd23.ugcrnohinspectionimage 和版本 1.0.1(1000001)。打开应用以后逐个点开附件,等到图片加载完成再去检查图中编号。应用可以启动只表明能接受安装,是否能在离线 bundle 里找到两张图仍需靠实际界面验证。

环境和对象

核对内容

本机开发与实测

HUAWEI MateBook 14(MNTXM-24B),HarmonyOS 7.0.0,软件 7.0.0.115(SP11C00E103R12P2patch01),API 26.0.0,aarch64

工具

本机 DevEco Studio Beta,Node.js 24.18.1,npm 11.16.0,Metro 0.83.8

框架版本

React Native 0.84.1,React Native for OpenHarmony 0.84.4

HAP 工程

兼容及编译目标 HarmonyOS 6.1.1(API 24),2in1,调试包 1.0.1(1000001)

早期模拟器记录

MateBook Pro 2in1,HarmonyOS 6.1.1(API 24)配置,OpenHarmony-6.1.1.125 运行镜像,x86_64;原媒体对应 1.0.0

想在自己的项目复现,可以先把小图放进 assets,用 require 引用,等流程跑通后换成待核对的高分辨率照片。这里的两个例子是本地静态资源。现场若用异步下载,先区分文件下载、解码和界面裁切,看见加载状态之后,再用同一张原图比较显示模式。网络加载的等待不需要混在裁切演示里。

FAQ

列表上明明写了 PF-218,为什么复核还得切到完整照片? 列表文字来自附件元数据,照片上的铭牌才是图像里的证据。如果附件分配错了设备,列表仍可能显示原来的编号。用完整照片核对铭牌,就能把列表标签和图里内容交叉检查。

换了样图,运行结果却还是旧的,先查哪一层? 先看 bundle-harmony 的产物时间和 rawfile 下的图片是否跟着更新,再核对当前设备实际安装的包名与版本。调试入口通过 ResourceJSBundleProvider 读打包资源,改完 assets 以后要重新生成 bundle、重新打包并安装。改文件后只把窗口关掉再打开,仍然会读取已经安装的资源。

切到完整模式后,局部文字仍然很小怎么办? 完整显示只能保证原图的边缘进入视口,文字能否读清和素材分辨率、窗口宽度有关。巡检归档若经常需要读微小字样,可以加一个独立放大入口,并保留原文件。显示模式切换没有写盘逻辑,也不会替用户把原图裁成当前卡片的形状。

总结

如果附件列表是为了定位,缩略图可以维持统一裁切。到了实际复核,需要在原图上检查文字或边缘的标志,就保持同一资源、把显示方式切换到完整。复现时从源码里的图、Metro 产物、HAP 到屏幕上的编号依次核对。这样当图看不见时,可以先问图有没有随包进来,再判断是否被当前取景框挡住。

Logo

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

更多推荐