React Native for OpenHarmony设备信息获取：DeviceInfo安装、权限与API实战

做 React Native for OpenHarmony 也有一段时间了，最近在好几个项目里都绕不开设备信息获取这件事。很多从 Android 转过来的同学会习惯性找 Build.MODEL、Build.SERIAL，但到了鸿蒙的 RN 环境里，这些老方法基本都不可用。老老实实用 DeviceInfo 模块，反而能省掉一堆烦心事。这篇文章我就以 DeviceInfo 为主题，把自己在 RK3568、RK3588 真机上跑通的完整经验整理出来，涉及安装、权限、API 拆解、白屏排查和硬件判断。

初看标题可能觉得这事太窄：设备信息不就 getDeviceId() 拿一下？真到了实际项目里，你会发现问题多得让人头疼。比如拿到一个空字符串，拿到一个不断变化的匿名 ID，或者不同版本的系统返回的字段格式不一样。更别提在开发阶段经常遇到的启动白屏，很多人排查半天，最后发现是 bundle 加载路径配置的问题。这些坑我不希望你再去踩一遍，所以尽量写得具体一点，能直接抄的代码和命令都会给出来。

1. 为什么在鸿蒙的 RN 应用中要单独聊 DeviceInfo

1.1 设备信息模块被很多人低估了

在移动端开发里，设备信息模块最容易被人当成“工具人”：需要上传日志时拿来用一下，出现 bug 问一下机型，然后就没然后了。但实际在 React Native for OpenHarmony 项目里，DeviceInfo 承担的角色比想象中重。

首先是兼容性适配。OpenHarmony 的硬件生态不像主流手机那么统一，既有 RK3568、RK3588 这类开发板，也有商业平板和带屏设备。不同芯片产商对系统 UI、性能调度、相机指令的实现差异很大。产品团队在做灰度策略时，经常需要根据芯片型号、系统版本、设备类型下发不同的页面形态。没有 DeviceInfo 这一层，JS 端想判断“当前是不是平板”“当前跑在哪个芯片上”就只能靠猜。

其次是运营数据上报。做版本升级、崩溃聚合、行为埋点的时候，设备型号是绕不开的维度。崩溃日志里如果只记录包名和报错堆栈，排查起来效率非常低。把 deviceId、deviceModel、systemVersion 一起上报，后端才能快速圈出“某型号设备崩溃率偏高”这样的结论。

最后是安全风控和调试辅助。我在调试真机的时候，经常要快速确认手里的板子当前到底加载了哪套固件。以前的做法是重新编译一个测试包，把 Build.PRODUCT 打印出来，后来直接用 DeviceInfo 在 JS 层取 SoC 型号和系统版本，20 秒就能确认。

1.2 从“能跑”到“跑得稳”：设备信息决定了不少分支逻辑

很多团队的 RN 适配到 OpenHarmony 之后，第一版只是让界面能跑起来，但“能跑”和“跑得稳”之间差着大量分支逻辑。

举个实际例子：OpenHarmony 上某些 API 只在 3.2 Release 以后的版本可用，老版本设备上调用会直接抛异常。如果不在 JS 层读取 getSystemVersion() 做判断，等用户反馈闪退再处理就被动了。还有一种情况是屏幕形态差异。RN 在手机和平板上的布局逻辑经常不一样，DeviceInfo.getDeviceType() 能直接告诉你当前是手机、平板还是桌面设备，省得用 Dimensions.get('window') 去猜。

因为我平时在 RK3568 和 RK3588 两类板子上切换开发，对“同代码不同表现”的感受特别深。RK3568 跑 4K 解码时 CPU 明显更吃力，RK3588 负载则小很多。如果项目里有分辨率渲染的适配逻辑，最好根据 SoC 型号提前分流。这些都是 DeviceInfo 能直接解决的需求。

还有一个容易被忽略的点：原生模块的桥接方式会影响调用时机。在 React Native for OpenHarmony 里，DeviceInfo 通常以 TurboModule 的形式存在，JS 侧初次调用时要完成原生模块的初始化。如果首次调用发生在启动渲染的关键路径上，可能会让首帧变慢。所以不要把所有设备信息读取都堆在页面构造函数里，而是放到异步流程中，避免阻塞首屏。

2. 环境准备：搭好 react-native-ohos 开发环境的关键几步

2.1 开发环境到底需要哪些组件

要跑 React Native for OpenHarmony，第一步不是写代码，而是把环境磨顺。我试过在 Windows 和 Ubuntu 上分别搭，建议有条件优先用 Ubuntu 18.04 以上版本，文件路径和编译工具链都会省心一些。整套环境大致包含：

Node.js 的版本别贪新，RN 的工具链通常对某个大版本验证得最充分。我之前用过 Node 21 踩过 Metro 的兼容问题，退回 20 L