鸿蒙【HarmonyOS 5】 (React Native)的实战教程

一、环境配置

  1. 安装鸿蒙专属模板

    bashCopy Code

    npx react-native@0.72.5 init HarmonyApp --template react-native-template-harmony:ml-citation{ref="4,6" data="citationList"}

  2. 配置 ArkTS 模块路径

    entry/src/main/ets 目录下创建原生模块(下文示例)


二、实战:RN 调用鸿蒙传感器(ArkTS 原生模块)

1. 创建鸿蒙原生模块 SensorManager.ets

typescriptCopy Code

// entry/src/main/ets/sensors/SensorManager.ets import sensor from '@ohos.sensor'; export class SensorManager { // 暴露给 RN 的加速度计监听方法 static startAccelerometer(callback: (data: object) => void): void { sensor.on(sensor.SensorId.ACCELEROMETER, (data) => { callback({ x: data.x, y: data.y, z: data.z }); }); } }

2. RN 侧调用传感器(JS 代码)

javascriptCopy Code

// App.js import { NativeModules } from 'react-native'; const { SensorManager } = NativeModules; // 启动加速度监听 useEffect(() => { SensorManager.startAccelerometer(data => { console.log("加速度数据:", data.x, data.y, data.z); }); }, []);

3. 权限声明(关键步骤)

module.json5 中添加:

jsonCopy Code

{ "module": { "requestPermissions": [ { "name": "ohos.permission.ACCELEROMETER" } ] } }

‌:传感器需真机测试,模拟器无数据返回


三、鸿蒙 UI 组件封装(ArkTS + RN)

1. 创建鸿蒙原生组件 HarmonyButton.ets

typescriptCopy Code

// entry/src/main/ets/components/HarmonyButton.ets @Component export struct HarmonyButton { @State label: string = "Click Me" onClick: () => void = () => {} build() { Button(this.label) .width(150) .height(50) .onClick(() => this.onClick()) } }

2. 桥接到 React Native

javascriptCopy Code

// harmony-bridge.js import { requireNativeComponent } from 'react-native'; export default requireNativeComponent('HarmonyButton');

3. RN 中使用该组件

jsxCopy Code

// App.js import HarmonyButton from './harmony-bridge'; <HarmonyButton label="鸿蒙按钮" style={``{ width: 150, height: 50 }} onClick={() => alert('ArkTS 按钮被点击!')} />


四、调试技巧

  1. 日志查看

  2. bashCopy Code

  3. hdc shell hilog | grep "ReactNativeJS" # 过滤 RN 日志

  4. 性能分析

    • 使用 DevEco Profiler 监控 JS 线程负载(优化后渲染延迟降低 40%)

五、避坑指南

问题 解决方案
RN 无法加载鸿蒙组件 检查 harmony/components 路径无中文命名
传感器返回 null 真机需开启开发者模式的「传感器调试权限」
热更新失效 关闭 DevEco Studio 的 ArkCompiler 优化模式
相关推荐
绿算技术1 小时前
华为昇腾×绿算全闪存缓存释放澎湃潜能
科技·华为
十步杀一人_千里不留行1 小时前
I Built an Offline-Capable App by Myself: React Native Frontend, C# Backend
前端·react native·typescript
nanchen22512 小时前
从混沌到有序:揭秘团购鸿蒙高内聚、可扩展的现代化前端架构
harmonyos
长弓三石2 小时前
鸿蒙网络编程系列59-仓颉版TLS回声服务器示例
harmonyos·鸿蒙·tls·仓颉
烈焰晴天3 小时前
一款基于 ReactNative 最新发布的`Android/iOS` 新架构文档预览开源库
android·react native·ios
米开朗积德5 小时前
React Native原生Android SSL双向认证
react native
yrjw5 小时前
一款基于 ReactNative 最新发布的`Android/iOS` 新架构文档预览开源库
harmonyos
ajassi20005 小时前
开源 Arkts 鸿蒙应用 开发(十三)音频--MP3播放
linux·华为·开源·harmonyos
zhanshuo17 小时前
让鸿蒙应用丝滑如飞:绘图性能优化全攻略(附代码实战)
harmonyos
zhanshuo17 小时前
适配鸿蒙低性能设备的终极优化方案:从启动到渲染全链路实战
harmonyos