@react-native-ohos/react-native-reanimated 3.18.3-beta.2 → 3.18.3

package/README.md

@@ -1,10 +1,406 @@
-# @react-native-ohos/react-native-reanimated
-This project is based on [react-native-reanimated@v3.18.0](https://github.com/software-mansion/react-native-reanimated/tree/3.18.0)
+> 文档模板：v0.4.2
 
-## Documentation
-[中文](https://gitcode.com/OpenHarmony-RN/usage-docs/blob/master/zh-cn/react-native-reanimated.md)
+<p align="center">
+  <h1 align="center"> <code>react-native-reanimated</code> </h1>
+</p>
 
-[English](https://gitcode.com/OpenHarmony-RN/usage-docs/blob/master/en/react-native-reanimated.md)
+本项目基于 [react-native-reanimated](https://github.com/software-mansion/react-native-reanimated) 开发。
 
-## License
-This library is licensed under [The MIT License (MIT)](https://github.com/react-native-oh-library/react-native-harmony-reanimated/blob/sig/LICENSE).
+该第三方库的仓库已迁移至 Gitcode，且支持直接从 npm 下载，新的包名为：`@react-native-ohos/react-native-reanimated` 版本所属关系如下：
+
+| 三方库名称    | 三方库版本（npm地址）    | 发布信息     | 支持RN版本    | Autolink     | 编译API版本     | 社区基线版本    | 源码地址   |
+| ------------ | ------------ | ------------------------------ | ------------- | ------------- |------------------------ | ------------- | ------------- |
+| @react-native-ohos/react-native-reanimated | [~ 3.18.1](https://www.npmjs.com/package/@react-native-ohos/react-native-reanimated)    | [Gitcode Releases](https://gitcode.com/CPF-RN/rntpc_react-native-reanimated/releases) |  0.77.* | 否 | API12+ | 3.18.0 | [br_rnoh0.77](https://gitcode.com/CPF-RN/rntpc_react-native-reanimated/tree/br_rnoh0.77) |
+
+## 简介
+
+react-native-reanimated 是面向 React Native 生态的第三方原生库，重构实现跨平台动画底层能力，提供声明式 JS 动画 API，实现运行在 UI 线程的高性能流畅动画交互。
+
+## 下载安装
+
+进入到工程目录并输入以下命令：
+
+**npm**
+
+```bash
+npm install react-native-reanimated@3.18.0
+npm install @react-native-ohos/react-native-reanimated
+```
+
+**yarn**
+
+```bash
+yarn add react-native-reanimated@3.18.0
+yarn add @react-native-ohos/react-native-reanimated
+```
+
+#### 插件配置
+
+添加插件到 `babel.config.js`:
+
+> [!TIP] 为什么需要添加这个？Reanimated Babel 插件会自动转换特殊的 JavaScript 函数（称为 worklet），以便它们可以被传递并在 UI 线程上运行。
+
+```js
+  module.exports = {
+    presets: [
+      ... // don't add it here :)
+    ],
+    plugins: [
+      ...
+      'react-native-reanimated/plugin',
+    ],
+  };
+```
+
+清除 Metro 的缓存（推荐）:
+
+**npm**
+
+```bash
+npm start --reset-cache
+```
+
+**yarn**
+
+```bash
+yarn start --reset-cache
+```
+
+## Link
+
+|                                      | 是否支持autolink | RN框架版本 |
+|--------------------------------------|----------------|-----------|
+| ~ 3.18.1                             | No             |  0.77     |
+
+首先需要使用 DevEco Studio 打开项目里的 HarmonyOS 工程 `harmony`。
+
+### 1. Overrides RN SDK
+
+为了让工程依赖同一个版本的 RN SDK，需要在工程根目录的 `oh-package.json5` 添加 overrides 字段，指向工程需要使用的 RN SDK 版本。替换的版本既可以是一个具体的版本号，也可以是一个模糊版本，还可以是本地存在的 HAR 包或源码目录。
+
+关于该字段的作用请阅读[官方说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-oh-package-json5-V5#zh-cn_topic_0000001792256137_overrides)
+
+```json
+{
+  ...
+  "overrides": {
+    "@rnoh/react-native-openharmony" : "./react_native_openharmony"
+  }
+}
+```
+
+### 2. 引入原生端代码
+
+目前有两种方法：
+
+- 通过 har 包引入；
+- 直接链接源码。
+
+方法一：通过 har 包引入（推荐）
+
+> [!TIP] har 包位于三方库安装路径的 `harmony` 文件夹下。
+
+打开 `entry/oh-package.json5`，添加以下依赖
+
+```json
+"dependencies": {
+    "@rnoh/react-native-openharmony": "file:../react_native_openharmony",
+    "@react-native-ohos/react-native-reanimated": "file:../../node_modules/@react-native-ohos/react-native-reanimated/harmony/reanimated.har",
+  }
+```
+
+点击右上角的 `sync` 按钮
+
+或者在命令行终端执行：
+
+```bash
+cd entry
+ohpm install
+```
+
+方法二：直接链接源码
+
+> [!TIP] 如需使用直接链接源码，请参考[直接链接源码说明](https://gitcode.com/CPF-RN/usage-docs/blob/master/zh-cn/link-source-code.md)
+
+### 3. 配置 CMakeLists 和引入 ReanimatedPackage
+
+打开 `entry/src/main/cpp/CMakeLists.txt`，添加：
+
+```diff
+project(rnapp)
+cmake_minimum_required(VERSION 3.4.1)
+set(RNOH_APP_DIR "${CMAKE_CURRENT_SOURCE_DIR}")
++ set(NODE_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../node_modules")
++ set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules")
+set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-harmony/harmony/cpp")
+
+add_subdirectory("${RNOH_CPP_DIR}" ./rn)
+
+# RNOH_BEGIN: manual_package_linking_1
+add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package)
+
++ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-reanimated/src/main/cpp" ./reanimated)
+
+# RNOH_END: manual_package_linking_1
+
+add_library(rnoh_app SHARED
+    "./PackageProvider.cpp"
+    "${RNOH_CPP_DIR}/RNOHAppNapiBridge.cpp"
+)
+
+target_link_libraries(rnoh_app PUBLIC rnoh)
+
+# RNOH_BEGIN: manual_package_linking_2
+target_link_libraries(rnoh_app PUBLIC rnoh_sample_package)
++ target_link_libraries(rnoh_app PUBLIC rnoh_reanimated)
+
+# RNOH_END: manual_package_linking_2
+```
+> [!Tip] 注意：上面 NODE_MODULES 定义，为源库的安装路径，用户可以根据安装源库的路径定义 NODE_MODULES。
+
+打开 `entry/src/main/cpp/PackageProvider.cpp`，添加：
+
+```diff
+#include "RNOH/PackageProvider.h"
+#include "SamplePackage.h"
++ #include "ReanimatedPackage.h"
+using namespace rnoh;
+
+std::vector<std::shared_ptr<Package>> PackageProvider::getPackages(Package::Context ctx) {
+    return {
+      std::make_shared<SamplePackage>(ctx),
++     std::make_shared<ReanimatedPackage>(ctx)
+    };
+}
+```
+
+### 4. 在 ArkTs 侧引入 ReanimatedPackage
+
+打开 `entry/src/main/ets/RNPackagesFactory.ts`，添加：
+
+```diff
+  ...
++ import { ReanimatedPackage} from '@react-native-ohos/react-native-reanimated/ts';
+
+export function createRNPackages(ctx: RNPackageContext): RNPackage[] {
+  return [
+    new SamplePackage(ctx),
++   new ReanimatedPackage(ctx),
+  ];
+}
+```
+
+### 运行
+
+点击右上角的 `sync` 按钮
+
+或者在命令行终端执行：
+
+```bash
+cd entry
+ohpm install
+```
+
+然后编译、运行即可。
+
+## 约束与限制
+
+### 兼容性
+
+本文档内容基于以下版本验证通过：
+
+1. RNOH: 0.77.18;  SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112 SP15;
+
+### 权限要求
+
+> [!Tip] 使用传感器的功能，需要使用 >=3.18.3 的版本，如需使用传感器（如加速度传感器、陀螺仪），需要添加对应的传感器权限。
+
+在 `entry` 目录下的 `module.json5` 中添加权限
+
+```
+"requestPermissions": [
++  {
++    "name": "ohos.permission.ACCELEROMETER",  // 加速传感器权限名称
++    "reason": "$string:accele_reason",
++    "usedScene": {
++      "abilities": [
++        "EntryAbility"
++      ],
++      "when":"inuse"
++    }
++  },
++  {
++    "name": "ohos.permission.GYROSCOPE", // 陀螺仪传感器权限名称
++    "reason": "$string:gyr_reason",
++    "usedScene": {
++      "abilities": [
++        "EntryAbility"
++      ],
++      "when":"inuse"
++    }
++  },
+]
+
+```
+在 entry 目录下添加申请以上权限的原因
+打开 `entry/src/main/resources/base/element/string.json`，添加：
+```
+{
+  "string": [
++    {
++      "name": "accele_reason",
++      "value": "使用加速度传感器"
++    },
++    {
++      "name": "gyr_reason",
++      "value": "使用陀螺仪传感器"
++    },
+  ]
+}
+```
+
+### 编译运行API要求
+
+> [!TIP] 当前三方库所有版本均已实现版本隔离，支持在 `API12+` 工程编译，及 `API12+` ROM 运行。
+
+> [!TIP] 以下功能依赖特定版本的API，使用 `低于指定API版本的工程编译` 或 `低于指定API版本的ROM运行` 均可能导致部分功能受限。
+1. `3.18.3+` 版本新增支持`useReducedMotion` API。该能力依托系统提供的 `isAnimationReduceEnabledSync` API 实现，用于检测设备是否开启减弱动效（reduced motion）辅助功能；该接口仅在 `API23 及以上版本` 的 ROM 环境中生效
+
+## 使用示例
+
+下面的代码展示了这个库的基本使用场景：
+
+> [!WARNING] 使用时 import 的库名不变。
+
+```js
+import { Button, View } from "react-native";
+import Animated, { useSharedValue, withSpring } from "react-native-reanimated";
+
+export default function App() {
+  const width = useSharedValue(100);
+
+  const handlePress = () => {
+    width.value = withSpring(width.value + 50);
+  };
+
+  return (
+    <View style={{ flex: 1, alignItems: "center" }}>
+      <Animated.View
+        style={{
+          width,
+          height: 100,
+          backgroundColor: "violet",
+        }}
+      />
+      <Button onPress={handlePress} title="Click me" />
+    </View>
+  );
+}
+```
+
+## 接口说明
+
+> [!TIP] "平台"列表示该属性在原三方库上支持的平台。
+
+> [!TIP] "HarmonyOS平台支持"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。
+
+### API
+
+| 名称               | 类型     | 参数类型 | 返回值 | 必填 | 平台 | HarmonyOS平台支持 | 描述 |
+| ------------------ |----------| -------- | ------ | -------- | -------- | ----------------- | ---- |
+| `withTiming`       | function | `(toValue: T, userConfig?: TimingConfig, callback?: AnimationCallback)` | `T` | No       | All      | yes | withTiming 可基于时长和缓动函数创建动画。 |
+| `withSpring`       | function | `(toValue: T, userConfig?: SpringConfig, callback?: AnimationCallback)` | `T` | No       | All      | yes | withSpring 可创建基于弹簧物理的动画。 |
+| `withDecay`        | function | `(userConfig: DecayConfig, callback?: AnimationCallback)` | `number` | No       | All      | yes | withDecay 可创建模拟带有摩擦力的运动物体的动画。动画将以给定的初速度开始，并根据给定的减速率随时间逐渐减速，直至停止。 |
+| `withRepeat`       | function | `(_animation: T, numberOfRepeats?: number, reverse?: boolean, callback?: AnimationCallback)` | `T` | No       | All      | yes | withRepeat 是一个动画修饰器，可将动画重复指定次数，或无限循环运行。 |
+| `useSharedValue`   | function | `(initialValue: Value)` | `SharedValue<Value>` | No       | All      | yes | useSharedValue 可在组件中定义共享值。 |
+| `useAnimatedStyle` | function | `(updater: () => Style, dependencies?: DependencyList)` | `Style` | No       | All      | yes | useAnimatedStyle 可创建一个样式对象（类似于 StyleSheet 样式），并可通过共享值对其进行动画处理。 |
+| `useAnimatedRef`   | function | `/` | `AnimatedRef<T>` | No       | All      | yes | useAnimatedRef 可获取视图的引用。可与 measure、scrollTo 和 useScrollViewOffset 函数配合使用。 |
+| `useDerivedValue`  | function | `(updater: () => Value, dependencies?: DependencyList)` | `DerivedValue<Value>` | No       | All      | yes | useDerivedValue 可基于已有的共享值创建新的共享值，并保持其响应性。 |
+| `cancelAnimation`  | function | `(sharedValue: SharedValue<TValue>)` | `void` | No       | All      | yes | cancelAnimation 可取消与某个共享值关联的正在运行的动画。 |
+| `runOnJS`          | function | `(fn: Function)` | `(...args: any[]) => void` | No       | All      | yes | runOnJS 可异步运行未被 worklet 化的函数（这些函数通常无法在 UI 线程上运行）。这适用于大多数外部库，因为它们的函数未标记 "worklet" 指令。 |
+| `runOnUI`          | function | `(fn: Function)` | `(...args: any[]) => void` | No       | All      | yes | runOnUI 可在 UI 线程上异步运行被 worklet 化的函数。 |
+| `measure`          | function | `(animatedRef: AnimatedRef<TRef>)` | `MeasuredDimensions \| null` | No       | All      | yes | measure 可在 UI 线程上同步获取屏幕上视图的尺寸和位置。 |
+| `Easing`           | object | `/` | `/` | No       | All      | yes | 缓动函数，用于设置运动的轨迹。 |
+| `useAnimatedKeyboard`           | function | `(options?: AnimatedKeyboardOptions)` | `AnimatedKeyboardInfo` | No       | All      | yes | useAnimatedKeyboard 可基于虚拟键盘的状态和高度创建动画。 |
+| `useComposedEventHandler`| function | `(handlers: (EventHandlerProcessed \| null)[])` | `ComposedHandlerProcessed` | No       | All      | yes | 这是一个 Hook，可将基于 useEvent 的事件处理器（如 useAnimatedScrollHandler 或自定义事件处理器）组合为一个单一的事件处理器。 |
+| `makeMutable` | function | `(initial: Value)` | `Mutable<Value>` | No       | All      | yes | makeMutable 是 useSharedValue Hook 内部用于创建共享值的函数。 |
+| `ReducedMotionConfig` | function | `(config: ReducedMotionConfig)` | `null` | No       | All      | yes | 根据设备的减弱动效辅助功能设置改变行为。 |
+| `useAnimatedGestureHandler`<sup>deprecated</sup> | function | `(handlers: GestureHandlers, config?: Config)` | `OnGestureEvent` | No | All | No | 可基于手势处理器创建动画。 |
+| `useScrollViewOffset`<sup>deprecated</sup> | function | `(animatedRef: AnimatedRef<AnimatedScrollView>, providedOffset?: SharedValue<number>)` | `SharedValue<number>` | No | All | yes | 可基于 ScrollView 的偏移量创建动画。 |
+| `useReducedMotion`<sup>API>=23</sup> | function | `/` | `boolean` | No | All | yes | React Native Reanimated 库中的一个 Hook，用于检测设备是否启用了减弱动效（reduced motion）辅助功能设置。 |
+
+### 属性
+
+**WithSpringConfig**
+
+| 名称                    | 参数类型                                                  | 默认值 | 必填 | 平台        | HarmonyOS平台支持 | 描述 |
+| ----------------------- | ------------------------------------------------------------ | ---------------- | -------- | --------------- | ------------------ | ---- |
+| clamp | `{ min?: number; max?: number }` | None | No       | Android and iOS | yes | 限制运动范围。如果弹簧动画会超出此限制，则会降低 `dampingRatio`（使弹簧的弹性减弱） |
+
+**SharedValue**
+
+| 名称                  | 参数类型                                                  | 默认值 | 必填 | 平台        | HarmonyOS平台支持 | 描述 |
+| --------------------- | ------------------------------------------------------------ | -------- | -------- | --------------- | ------------------ | ---- |
+| get | `() => Value` | None | No       | Android and iOS | yes | 返回当前值 |
+| set | `(value: Value \| ((value: Value) => Value)) => void` | None | No       | Android and iOS | yes | 更新存储的值（支持直接赋值或更新函数） |
+| addListener           | `(listenerID: number, listener: (value: Value) => void) => void` | None | No       | Android and iOS | yes | 注册值变化监听器 |
+| modify                | `(modifier?: (value: Value) => Value, forceUpdate?: boolean) => void` | None | No       | Android and iOS | yes | 对当前值应用变换 |
+
+**DerivedValue**
+
+| 名称                                 | 参数类型                 | 默认值 | 必填 | 平台        | HarmonyOS平台支持 | 描述 |
+| ------------------------------------ | --------------------------- | -------- | -------- | --------------- | ------------------ | ---- |
+| set<sup>deprecated</sup> | None | None | No       | Android and iOS | No | 派生值为只读 |
+
+**CurrentLayoutAnimationsValues**
+
+| 名称                                  | 参数类型           | 默认值 | 必填 | 平台        | HarmonyOS平台支持 | 描述 |
+| ------------------------------------- | --------------------- | ------ | -------- | --------------- | ------------------ | ---- |
+| currentBorderRadius | number | 0 | No       | Android and iOS | No | 视图的圆角半径 |
+
+**EntryAnimationsValues**
+
+| 名称                                 | 参数类型           | 默认值 | 必填 | 平台        | HarmonyOS平台支持 | 描述 |
+| ------------------------------------ | --------------------- | ------ | -------- | --------------- | ------------------ | ---- |
+| targetBorderRadius | number | 0 | No       | Android and iOS | No | 视图的圆角半径 |
+
+**itemLayoutAnimation**
+
+| 名称                                  | 参数类型                               | 默认值 | 必填 | 平台        | HarmonyOS平台支持 | 描述 |
+| ------------------------------------- | ----------------------------------------- | --------------- | -------- | --------------- | ------------------ | ---- |
+| itemLayoutAnimation | `ILayoutAnimationBuilder` | None | No       | Android and iOS | yes | 定义列表项的布局过渡动画 |
+
+## 遗留问题
+
+## 其他
+- [React Native中LayoutAnimation与react-native-reanimated存在不兼容，推荐使用react-native-reanimated](https://github.com/software-mansion/react-native-reanimated/issues/6751)
+
+## 目录结构
+````
+/rntpc_react-native-reanimated          # 项目根目录
+├── harmony                              # 鸿蒙适配代码
+│   ├── reanimated.har                   # har 包
+│   └── reanimated                       # 鸿蒙适配核心代码
+│       ├── index.ets                    # 鸿蒙适配代码入口
+│       └── src/main
+│           ├── cpp                      # C++ 原生层（ReanimatedPackage、ReanimatedModule 等）
+│           ├── ets                      # ArkTS 层
+│           ├── resources                # 资源文件
+│           └── module.json5
+├── src                                  # RN / TS 代码
+│   └── index.ts                         # 入口文件
+├── example                              # 示例工程
+├── package.json
+├── README.md                            # 中文安装使用方法
+├── README_en.md                         # 英文安装使用方法
+├── CHANGELOG.md                         # 更新日志
+└── OAT.xml                              # 开源合规
+````
+
+## 贡献代码
+
+使用过程中发现任何问题都可以提交 [Issue](https://gitcode.com/CPF-RN/rntpc_react-native-reanimated/issues)，当然，也非常欢迎提交 [PR](https://gitcode.com/CPF-RN/rntpc_react-native-reanimated/pulls) 。
+
+## 开源协议
+
+本项目基于 [The MIT License (MIT)](https://github.com/software-mansion/react-native-reanimated/blob/main/LICENSE) ，请自由地享受和参与开源。

package/harmony/reanimated/BuildProfile.ets

@@ -1,7 +1,7 @@
 /**
  * Use these variables when you tailor your ArkTS code. They must be of the const type.
  */
-export const HAR_VERSION = '3.18.3-beta.2';
+export const HAR_VERSION = '3.18.3';
 export const BUILD_MODE_NAME = 'debug';
 export const DEBUG = true;
 export const TARGET_NAME = 'default';

package/harmony/reanimated/oh-package.json5

@@ -1,6 +1,6 @@
 {
   name: '@react-native-ohos/react-native-reanimated',
-  version: '3.18.3-beta.2',
+  version: '3.18.3',
   description: "",
   type: 'module',
   main: 'index.ets',

package/harmony/reanimated/src/main/cpp/CMakeLists.txt

@@ -69,4 +69,6 @@ target_sources(rnoh_reanimated
 
 target_include_directories(rnoh_reanimated PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})
 target_link_libraries(rnoh_reanimated PUBLIC rnoh)
+target_link_libraries(rnoh_reanimated PUBLIC libohsensor.so)
+target_link_libraries(rnoh_reanimated PUBLIC libnative_display_manager.so)
 

package/harmony/reanimated/src/main/cpp/ReanimatedModule.cpp

@@ -5,6 +5,7 @@
 #include "RNOH/ArkTSTurboModule.h"
 #include "RNOH/RNInstance.h"
 #include "ReanimatedModule.h"
+#include "ReanimatedSensorContainer.h"
 #include "ReanimatedUIScheduler.h"
 #include "PlatformDepMethodsHolder.h"
 #include "WorkletRuntimeCollector.h"
@@ -54,12 +55,12 @@ ReanimatedModule::~ReanimatedModule()
 
 void ReanimatedModule::installTurboModule(facebook::jsi::Runtime &rt)
 {
-    auto nodesManager = std::make_shared<ReanimatedNodesManager>(
-        [weakExecutor = std::weak_ptr(m_ctx.taskExecutor)](TaskExecutor::Task &&task) {
-            if (auto taskExecutor = weakExecutor.lock()) {
-                taskExecutor->runTask(TaskThread::MAIN, std::move(task));
-            }
-        });
+    auto runMainThreadFuc = [weakExecutor = std::weak_ptr(m_ctx.taskExecutor)](TaskExecutor::Task &&task) {
+        if (auto taskExecutor = weakExecutor.lock()) {
+            taskExecutor->runTask(TaskThread::MAIN, std::move(task));
+        }
+    };
+    auto nodesManager = std::make_shared<ReanimatedNodesManager>(runMainThreadFuc);
 
     auto maybeFlushUIUpdatesQueueFunction = [nodesManager]() { nodesManager->maybeFlushUIUpdatesQueue(); };
     auto requestRender = [weakSelf = weak_from_this(), nodesManager](std::function<void(double)> onRender) {
@@ -87,14 +88,13 @@ void ReanimatedModule::installTurboModule(facebook::jsi::Runtime &rt)
 
     auto getAnimationTimestamp = getMillisSinceEpoch;
 
-    auto registerSensorFunction = [](int sensorType, int interval, int iosReferenceFrame,
+    auto sensorContainer = std::make_shared<ReanimatedSensorContainer>();
+    auto registerSensorFunction = [sensorContainer,
+                                   runMainThreadFuc](int sensorType, int interval, int iosReferenceFrame,
         std::function<void(double[], int)> setter) -> int {
-        // TODO
-        return -1;
-    };
-    auto unregisterSensorFunction = [](int sensorId) {
-        // TODO
+        return sensorContainer->registerSensor(sensorType, interval, iosReferenceFrame, setter, runMainThreadFuc);
     };
+    auto unregisterSensorFunction = [sensorContainer](int sensorId) { sensorContainer->unregisterSensor(sensorId); };
     auto subscribeForKeyboardEventsFunction =
         [weakSelf = weak_from_this()](std::function<void(int keyboardState, int height)> keyboardEventDataUpdater,
         bool isStatusBarTranslucent, bool isNavigationBarTranslucent) {
@@ -153,7 +153,19 @@ void ReanimatedModule::installTurboModule(facebook::jsi::Runtime &rt)
         unsubscribeFromKeyboardEventsFunction,
         maybeFlushUIUpdatesQueueFunction,
     };
-    auto isReducedMotion = false;
+    bool isReducedMotion = false;
+    m_ctx.taskExecutor->runSyncTask(TaskThread::MAIN,
+    [ctx = m_ctx, &isReducedMotion]() {
+        if (!ctx.arkTSTurboModuleInstanceRef) {
+            return;
+        }
+        ArkJS arkJs(ctx.env);
+        auto napiTurboModuleObject =
+            arkJs.getObject(ctx.arkTSTurboModuleInstanceRef);
+        auto napiResult =
+            napiTurboModuleObject.call("isReducedMotionEnabled", {});
+        isReducedMotion = arkJs.getBoolean(napiResult);
+    });
     auto isBridgeless = true;
     auto workletsModule = [weakSelf = weak_from_this()]() -> std::shared_ptr<WorkletsModule> {
         auto self = weakSelf.lock();

package/harmony/reanimated/src/main/cpp/ReanimatedSensor.cpp

@@ -0,0 +1,248 @@
+// Copyright (c) 2025 Huawei Device Co., Ltd. All rights reserved
+// Use of this source code is governed by a MIT license that can be
+// found in the LICENSE file.
+
+#include "ReanimatedSensor.h"
+#include "glog/logging.h"
+#include <memory>
+#include <vector>
+#include <sensors/oh_sensor.h>
+#include <window_manager/oh_display_info.h>
+#include <window_manager/oh_display_manager.h>
+namespace rnoh {
+static std::unordered_map<Sensor_Type, ReanimatedSensor *> g_sensorSubscriberMap_;
+static std::mutex g_subscriberMapMutex_; // 保护映射表的互斥锁
+
+void SensorDataCallbackImpl(Sensor_Event *event) {
+    if (event == nullptr) {
+        return;
+    }
+    int64_t timestamp = -1;
+    // 获取传感器数据的时间戳。
+    int32_t ret = OH_SensorEvent_GetTimestamp(event, &timestamp);
+    if (ret != SENSOR_SUCCESS) {
+        return;
+    }
+    Sensor_Type sensorType;
+    // 获取传感器类型。
+    ret = OH_SensorEvent_GetType(event, &sensorType);
+    if (ret != SENSOR_SUCCESS) {
+        return;
+    }
+    Sensor_Accuracy accuracy = SENSOR_ACCURACY_UNRELIABLE;
+    // 获取传感器数据的精度。
+    ret = OH_SensorEvent_GetAccuracy(event, &accuracy);
+    if (ret != SENSOR_SUCCESS) {
+        return;
+    }
+    float *data = nullptr;
+    uint32_t length = 0;
+    // 获取传感器数据。
+    ret = OH_SensorEvent_GetData(event, &data, &length);
+    if (ret != SENSOR_SUCCESS || data == nullptr) {
+        return;
+    }
+
+    std::lock_guard<std::mutex> lock(g_subscriberMapMutex_);
+    auto it = g_sensorSubscriberMap_.find(sensorType);
+    if (it == g_sensorSubscriberMap_.end()) {
+        return;
+    }
+    ReanimatedSensor *sensorInstance = it->second;
+    if (sensorInstance == nullptr) {
+        return;
+    }
+
+    switch (sensorType) {
+    case SENSOR_TYPE_ACCELEROMETER:
+    case SENSOR_TYPE_GYROSCOPE:
+    case SENSOR_TYPE_GRAVITY:
+    case SENSOR_TYPE_MAGNETIC_FIELD: {
+        double sendData[] = {
+            data[0],
+            data[1],
+            data[2],
+        };
+        // 传入 count，由 runSensor 拷贝到堆，避免跨线程 use-after-free
+        sensorInstance->runSensor(sendData, 3);
+        return;
+    }
+    case SENSOR_TYPE_ROTATION_VECTOR: {
+        double sendData[] = {
+            data[0], // x
+            data[1], // y
+            data[2], // z
+            data[3], // w
+            // ios
+            0, // yaw
+            0, // pitch
+            0  // roll
+        };
+        sensorInstance->runSensor(sendData, 7);
+        return;
+    }
+    default:
+        return;
+    }
+}
+
+
+rnoh::ReanimatedSensor::ReanimatedSensor(int sensorType, int interval, int iosReferenceFrame,
+                                         std::function<void(double *, int)> setter,
+                                         std::function<void(TaskExecutor::Task &&)> runOnTheMainThread)
+    : iosReferenceFrame_(iosReferenceFrame), setter_(std::move(setter)),
+      runOnTheMainThread_(std::move(runOnTheMainThread)) {
+    if (interval == -1) {
+        uint32_t refreshRate = 0;
+        OH_NativeDisplayManager_GetDefaultDisplayRefreshRate(&refreshRate);
+        if (refreshRate > 0) {
+            interval_ = refreshRate * 1000000; // 120hz;
+        } else {
+            interval_ = 200000000;
+        }
+    } else {
+        // js unit is milliseconds
+        interval_ = interval * 1000000;
+    }
+    castSensorType(sensorType);
+}
+
+
+void rnoh::ReanimatedSensor::castSensorType(int sensorType) {
+    if (sensorType == 1) {
+        sensorType_ = SENSOR_TYPE_ACCELEROMETER;
+    } else if (sensorType == 2) {
+        sensorType_ = SENSOR_TYPE_GYROSCOPE;
+    } else if (sensorType == 3) {
+        sensorType_ = SENSOR_TYPE_GRAVITY;
+    } else if (sensorType == 4) {
+        sensorType_ = SENSOR_TYPE_MAGNETIC_FIELD;
+    } else if (sensorType == 5) {
+        sensorType_ = SENSOR_TYPE_ROTATION_VECTOR;
+    } else {
+        throw std::invalid_argument("[ReanimatedSensor] Unknown sensorType: " + sensorType);
+    }
+}
+
+bool rnoh::ReanimatedSensor::initialize() {
+    if (!isSupportSensor()) {
+        LOG(ERROR) << "[ReanimatedSensor] is not support, sensorType:" << sensorType_;
+        return false;
+    }
+    id_ = OH_Sensor_CreateSubscriptionId();
+    if (id_ == nullptr) {
+        LOG(ERROR) << "[ReanimatedSensor] create sensor id failed";
+        return false;
+    }
+    int32_t res = OH_SensorSubscriptionId_SetType(id_, sensorType_);
+    if (res != SENSOR_SUCCESS) {
+        LOG(ERROR) << "[ReanimatedSensor] set sensor type failed ,sensorType:" << sensorType_;
+        return false;
+    }
+    auto attr = OH_Sensor_CreateSubscriptionAttribute();
+    if (attr == nullptr) {
+        LOG(ERROR) << "[ReanimatedSensor] create sensor attribute failed";
+        return false;
+    }
+
+    res = OH_SensorSubscriptionAttribute_SetSamplingInterval(attr, interval_);
+    if (res != SENSOR_SUCCESS) {
+        LOG(ERROR) << "[ReanimatedSensor] set sensor Interval failed, interval_:" << interval_;
+        return false;
+    }
+
+    subSensor_ = OH_Sensor_CreateSubscriber();
+
+    {
+        std::lock_guard<std::mutex> lock(g_subscriberMapMutex_);
+        g_sensorSubscriberMap_[sensorType_] = this;
+    }
+
+    int32_t ret = OH_SensorSubscriber_SetCallback(subSensor_, SensorDataCallbackImpl);
+    if (ret != SENSOR_SUCCESS) {
+        LOG(ERROR) << "[ReanimatedSensor] set sensor callback failed";
+        return false;
+    }
+    Sensor_Result sensorRes = OH_Sensor_Subscribe(id_, attr, subSensor_);
+    if (sensorRes != SENSOR_SUCCESS) {
+        LOG(ERROR) << "[ReanimatedSensor] on sensor subscribe failed";
+        return false;
+    }
+    return true;
+}
+
+
+bool rnoh::ReanimatedSensor::isSupportSensor() {
+    uint32_t count = 0;
+    int32_t ret = OH_Sensor_GetInfos(nullptr, &count);
+    bool isSupport = false;
+    if (count > 0) {
+        Sensor_Info **sensors = OH_Sensor_CreateInfos(count);
+        ret = OH_Sensor_GetInfos(sensors, &count);
+        for (uint32_t i = 0; i < count; ++i) {
+            Sensor_Info *sensorInfoTemp = sensors[i];
+            Sensor_Type sensorType;
+            ret = OH_SensorInfo_GetType(sensorInfoTemp, &sensorType);
+            if (sensorType == sensorType_) {
+                isSupport = true;
+                break;
+            }
+        }
+        ret = OH_Sensor_DestroyInfos(sensors, count);
+    }
+    return isSupport;
+}
+
+void rnoh::ReanimatedSensor::runSensor(double *value, size_t count) {
+    if (value && setter_ && runOnTheMainThread_ && count > 0) {
+        // 跨线程传递必须拷贝到堆：传感器回调运行在传感器线程，
+        // 而 setter_ 在主线程异步执行，栈上数据此时已释放（use-after-free）。
+        auto dataPtr = std::make_shared<std::vector<double>>(value, value + count);
+        runOnTheMainThread_([weakSelf = weak_from_this(), dataPtr]() {
+            auto self = weakSelf.lock();
+            if (!self) {
+                return;
+            }
+            self->setter_(dataPtr->data(), self->getInterfaceOrientation());
+        });
+    }
+}
+
+int rnoh::ReanimatedSensor::getInterfaceOrientation() {
+    NativeDisplayManager_Rotation rotation;
+    auto ret = OH_NativeDisplayManager_GetDefaultDisplayRotation(&rotation);
+    if (ret == DISPLAY_MANAGER_OK) {
+        switch (rotation) {
+        case DISPLAY_MANAGER_ROTATION_270:
+            return 270;
+        case DISPLAY_MANAGER_ROTATION_90:
+            return 90;
+        case DISPLAY_MANAGER_ROTATION_180:
+            return 180;
+        default:
+            return 0;
+        }
+    }
+    return 0;
+}
+
+
+void rnoh::ReanimatedSensor::cancel() { destroySensor(); }
+
+void rnoh::ReanimatedSensor::destroySensor() {
+    std::lock_guard<std::mutex> lock(g_subscriberMapMutex_);
+    for (auto it = g_sensorSubscriberMap_.begin(); it != g_sensorSubscriberMap_.end();) {
+        if (it->second == this) {
+            OH_Sensor_Unsubscribe(it->second->id_, it->second->subSensor_);
+            OH_Sensor_DestroySubscriptionId(it->second->id_);
+            OH_Sensor_DestroySubscriber(it->second->subSensor_);
+            it->second->subSensor_ = nullptr;
+            it = g_sensorSubscriberMap_.erase(it);
+        } else {
+            ++it;
+        }
+    }
+}
+
+rnoh::ReanimatedSensor::~ReanimatedSensor() { destroySensor(); }
+}

package/harmony/reanimated/src/main/cpp/ReanimatedSensor.h

@@ -0,0 +1,36 @@
+// Copyright (c) 2025 Huawei Device Co., Ltd. All rights reserved
+// Use of this source code is governed by a MIT license that can be
+// found in the LICENSE file.
+
+#ifndef HARMONY_REANIMATEDSENSOR_H
+#define HARMONY_REANIMATEDSENSOR_H
+#include <functional>
+#include <mutex>
+#include <sensors/oh_sensor_type.h>
+#include "RNOH/TaskExecutor/TaskExecutor.h"
+
+namespace rnoh {
+class ReanimatedSensor : public std::enable_shared_from_this<ReanimatedSensor> {
+public:
+    ReanimatedSensor(int sensorType, int interval, int iosReferenceFrame, std::function<void(double[], int)> setter,
+                     std::function<void(TaskExecutor::Task &&)> runOnTheMainThread);
+    ~ReanimatedSensor();
+    bool initialize();
+    void cancel();
+    void castSensorType(int sensorType);
+    void runSensor(double *value, size_t count);
+    std::function<void(double[], int)> setter_;
+    Sensor_Type sensorType_{SENSOR_TYPE_ACCELEROMETER};
+
+private:
+    void destroySensor();
+    bool isSupportSensor();
+    int getInterfaceOrientation();
+    int interval_{-1};
+    int iosReferenceFrame_{-1};
+    Sensor_Subscriber *subSensor_{nullptr};
+    Sensor_SubscriptionId *id_{nullptr};
+    std::function<void(TaskExecutor::Task &&)> runOnTheMainThread_;
+};
+} // namespace rnoh
+#endif // HARMONY_REANIMATEDSENSOR_H

package/harmony/reanimated/src/main/cpp/ReanimatedSensorContainer.cpp

@@ -0,0 +1,36 @@
+// Copyright (c) 2025 Huawei Device Co., Ltd. All rights reserved
+// Use of this source code is governed by a MIT license that can be
+// found in the LICENSE file.
+
+#include "ReanimatedSensorContainer.h"
+#include "glog/logging.h"
+namespace rnoh {
+
+rnoh::ReanimatedSensorContainer::ReanimatedSensorContainer() {}
+
+int rnoh::ReanimatedSensorContainer::registerSensor(int sensorType, int interval, int iosReferenceFrame,
+                                                    std::function<void(double *, int)> setter,
+                                                    std::function<void(TaskExecutor::Task &&)> runOnTheMainThread) {
+    auto sensor =
+        std::make_shared<ReanimatedSensor>(sensorType, interval, iosReferenceFrame, setter, runOnTheMainThread);
+    int sensorId = -1;
+    if (sensor->initialize()) {
+        sensorId = nextSensorId;
+        nextSensorId++;
+        sensorMap_[sensorId] = sensor;
+    }
+    return sensorId;
+}
+
+void rnoh::ReanimatedSensorContainer::unregisterSensor(int sensorId) {
+    auto it = sensorMap_.find(sensorId);
+    if (it == sensorMap_.end()) {
+        return;
+    }
+    auto sensor = it->second;
+    if (sensor != nullptr) {
+        sensor->cancel();
+        sensorMap_.erase(it);
+    }
+}
+}

package/harmony/reanimated/src/main/cpp/ReanimatedSensorContainer.h

@@ -0,0 +1,23 @@
+// Copyright (c) 2025 Huawei Device Co., Ltd. All rights reserved
+// Use of this source code is governed by a MIT license that can be
+// found in the LICENSE file.
+
+#ifndef HARMONY_REANIMATEDSENSORCONTAINER_H
+#define HARMONY_REANIMATEDSENSORCONTAINER_H
+#include "ReanimatedSensor.h"
+#include <functional>
+namespace rnoh {
+class ReanimatedSensorContainer {
+public:
+    ReanimatedSensorContainer();
+    ~ReanimatedSensorContainer() noexcept = default;
+    int registerSensor(int sensorType, int interval, int iosReferenceFrame, std::function<void(double[], int)> setter,
+                       std::function<void(TaskExecutor::Task &&)> runOnTheMainThread);
+    void unregisterSensor(int sensorId);
+
+private:
+    std::unordered_map<int, std::shared_ptr<ReanimatedSensor>> sensorMap_;
+    int nextSensorId{0};
+};
+} // namespace rnoh
+#endif // HARMONY_REANIMATEDSENSORCONTAINER_H

package/harmony/reanimated/src/main/cpp/patches/NativeModules/ReanimatedModuleProxy.cpp

@@ -256,6 +256,37 @@ ReanimatedModuleProxy::~ReanimatedModuleProxy() {
   }
   layoutAnimationsProxy_.reset();
 
+  // 主动触发 Hermes GC：在 uiWorkletRuntime_ 销毁前回收 Hermes 堆中持有
+  // ShadowNode::Shared（通过 NativeState / ShadowNodeWrapper）的 JSI 对象。
+  //
+  // 此处 commitHook_ / mountHook_ 仍未 reset，它们持有 uiManager_ 的
+  // shared_ptr，确保 GC 回收 ShadowNodeWrapper 触发 ~ShadowNodeFamily 时
+  // ComponentDescriptorRegistry 仍然有效。这样可避免 uiWorkletRuntime_.reset()
+  // → HadesGC::finalizeAll() 在上下文可能已失效后触发
+  // ~ShadowNodeFamily → ~InstanceHandle 崩溃（0730 复现变体根因）。
+  //
+  // UI runtime 为 LockableRuntime（supportsLocking=true），每个 JSI 操作
+  // 自动加锁 runtimeMutex_（recursive_mutex），从主线程调用 gc() 会阻塞
+  // 等待 UI 线程完成当前 worklet 后执行，不会死锁。
+#if JS_RUNTIME_HERMES
+  if (uiWorkletRuntime_) {
+    try {
+      auto &uiRuntime = uiWorkletRuntime_->getJSIRuntime();
+      auto gc = uiRuntime.global().getPropertyAsFunction(uiRuntime, "gc");
+      gc.call(uiRuntime);
+    } catch (const std::exception &) {
+      // gc() 调用失败不应阻止后续析构流程
+    } catch (...) {
+      // 忽略未知异常，保证析构不因 GC 失败而 terminate
+    }
+  }
+#endif // JS_RUNTIME_HERMES
+
+  // GC 之后再注销 hooks：确保 GC 回收 ShadowNodeWrapper 时
+  // UIManager（及 ComponentDescriptorRegistry）仍存活
+  commitHook_.reset();
+  mountHook_.reset();
+  uiManager_.reset();
 #endif // RCT_NEW_ARCH_ENABLED
   uiWorkletRuntime_.reset();
 }

package/harmony/reanimated/src/main/ets/ReanimatedModule.ts

@@ -5,6 +5,8 @@
 import { RNOHLogger, Tag, UITurboModule, UITurboModuleContext } from "@rnoh/react-native-openharmony/ts";
 import { Animator, AnimatorResult, window } from '@kit.ArkUI';
 import { KeyboardState } from "./AnimationManager";
+import deviceInfo from '@ohos.deviceInfo';
+import { accessibility } from '@kit.AccessibilityKit';
 
 export class ReanimatedModule extends UITurboModule {
   static NAME = "ReanimatedModule"
@@ -24,7 +26,13 @@ export class ReanimatedModule extends UITurboModule {
 
   public async subscribeKeyBordListeners(isStatusBarTranslucent: boolean, isNavigationBarTranslucent: boolean) {
     //ignore isStatusBarTranslucent  - those are Android only
-    const windowInstance = await window.getLastWindow(this.ctx.uiAbilityContext);
+    let windowInstance: window.Window;
+    try {
+      windowInstance = await window.getLastWindow(this.ctx.uiAbilityContext);
+    } catch (e: ESObject) {
+      this.logger.error(`subscribeKeyBordListeners failed: ${e?.message ?? e}`);
+      return;
+    }
     const navIndicatorArea = windowInstance.getWindowAvoidArea(
       window.AvoidAreaType.TYPE_NAVIGATION_INDICATOR
     );
@@ -91,7 +99,13 @@ export class ReanimatedModule extends UITurboModule {
   }
 
   public async unsubscribeKeyBordListeners() {
-    const windowInstance = await window.getLastWindow(this.ctx.uiAbilityContext);
+    let windowInstance: window.Window;
+    try {
+      windowInstance = await window.getLastWindow(this.ctx.uiAbilityContext);
+    } catch (e: ESObject) {
+      this.logger.error(`unsubscribeKeyBordListeners failed: ${e?.message ?? e}`);
+      return;
+    }
     windowInstance.off('keyboardHeightChange')
     if (this.currentAnimator) {
       this.currentAnimator.onFrame = null;
@@ -120,4 +134,15 @@ export class ReanimatedModule extends UITurboModule {
     }
     return isLayoutFullScreen;
   }
+
+  public isReducedMotionEnabled(): boolean {
+    try {
+      if (deviceInfo.sdkApiVersion >= 23) {
+        return (accessibility as ESObject).isAnimationReduceEnabledSync();
+      }
+    } catch (e) {
+      this.logger.warn(`isReducedMotionEnabled failed: ${JSON.stringify(e)}`);
+    }
+    return false;
+  }
 }

package/package.json

@@ -4,7 +4,7 @@
     "alias": "react-native-reanimated",
     "redirectInternalImports": true
   },
-  "version": "3.18.3-beta.2",
+  "version": "3.18.3",
   "description": "",
   "main": "lib/index.js",
   "scripts": {