@bingtang-rn/react-native-orientation-turbo for HarmonyOS

本项目基于 react-native-orientation-turbo 开发，为 React Native 鸿蒙（OpenHarmony）适配版本。如果在使用过程中有任何问题，可以在GitCode提Issue，会及时跟进。issue地址：issues。

版本对应关系

安装

npm install @bingtang-rn/react-native-orientation-turbo

使用

import {
  lockToPortrait,
  lockToLandscape,
  unlockAllOrientations,
  getCurrentOrientation,
  isLocked,
  onOrientationChange,
  onLockOrientationChange,
  startOrientationTracking,
  stopOrientationTracking,
  LandscapeDirection,
} from 'react-native-orientation-turbo';

// 锁定竖屏
lockToPortrait();
lockToPortrait('UPSIDE_DOWN');

// 锁定横屏
lockToLandscape(LandscapeDirection.LEFT);
lockToLandscape(LandscapeDirection.RIGHT);

// 解锁方向（跟随传感器自动旋转）
unlockAllOrientations();

// 获取当前方向
const orientation = getCurrentOrientation(); // 'PORTRAIT' | 'LANDSCAPE_LEFT' | ...

// 查询是否锁定
const locked = isLocked();

// 监听方向变化
startOrientationTracking();
const sub = onOrientationChange((event) => {
  console.log('方向变为:', event.orientation);
});

// 监听锁定状态变化
const lockSub = onLockOrientationChange((event) => {
  console.log('锁定状态:', event.isLocked, '方向:', event.orientation);
});

import 时使用原库名 'react-native-orientation-turbo'，而非鸿蒙包名。

平台差异：

• HarmonyOS 上 getDeviceAutoRotateStatus() 返回 null（鸿蒙无查询系统自动旋转开关的公共 API，与 iOS 行为一致）
• HarmonyOS 不支持 FACE_UP / FACE_DOWN 方向（无设备物理姿态传感器暴露给方向 API，与 Android 行为一致）

权限要求：

• 本模块无需声明额外权限

Link

如使用版本支持 Autolink 且工程已接入，可跳过手动配置。

{
  "overrides": {
    "@rnoh/react-native-openharmony": "./react_native_openharmony"
  }
}

"dependencies": {
  "@bingtang-rn/react-native-orientation-turbo": "file:../../node_modules/@bingtang-rn/react-native-orientation-turbo/harmony/orientation_turbo.har"
}

set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules")

add_subdirectory("${OH_MODULES}/@bingtang-rn/react-native-orientation-turbo/src/main/cpp" ./orientation_turbo)

target_link_libraries(rnoh_app PUBLIC orientation_turbo)

#include "OrientationTurboPackage.h"

std::vector<std::shared_ptr<Package>> PackageProvider::getPackages(Package::Context ctx) {
    return {
        std::make_shared<OrientationTurboPackage>(ctx),
    };
}

import { OrientationTurboPackage } from '@bingtang-rn/react-native-orientation-turbo/ts';

export function createRNPackages(ctx: RNPackageContext): RNPackage[] {
  return [
    new OrientationTurboPackage(ctx),
  ];
}

属性 / API

平台差异

• getDeviceAutoRotateStatus()：HarmonyOS 返回 null（无查询系统自动旋转开关的公共 API），与 iOS 行为一致
• FACE_UP / FACE_DOWN：HarmonyOS 不支持这两个方向值（无设备物理姿态传感器暴露给方向 API），与 Android 行为一致
• PORTRAIT_UPSIDE_DOWN：Android 大多数设备不支持，HarmonyOS 通过 window.Orientation.PORTRAIT_INVERTED 支持

方向映射说明

未实现功能

快速验证（运行 Example）

前置条件

运行步骤

1. 克隆仓库

git clone <仓库地址>
cd <仓库目录>

2. 安装依赖并构建

npm install --legacy-peer-deps
npm pack           # 生成 tgz 包（会自动触发 prepare 构建 JS 产物）

3. 进入 example 目录，安装依赖

cd example
npm install --legacy-peer-deps

4. 生成 JS Bundle

npm run dev

产物：harmony/entry/src/main/resources/rawfile/bundle.harmony.js

5. 用 DevEco Studio 打开鸿蒙工程

• 打开 DevEco Studio
• 选择 example/harmony 目录
• 等待 Sync 完成

6. 编译并运行 HAP

在 DevEco Studio 中点击运行按钮，将 HAP 安装到设备/模拟器。

注意：Example 中已预置插件依赖和 Package 注册，无需手动配置 Link。

约束与限制

兼容性

• RNOH: 0.72+
• HarmonyOS SDK: API 17+
• DevEco Studio: 5.0+

遗留问题

无（或列出已知问题）

开源协议

本项目基于 MIT 协议，详见 LICENSE 文件。