@arms/rum-reactnative 0.1.4 → 0.1.5

package/README.md

@@ -5,6 +5,7 @@
 ## 功能特性
 
 - **原生崩溃采集** — 自动捕获 iOS（KSCrash）与 Android（Java + NDK）原生崩溃，支持堆栈双侧截断与数据体积优化
+- **鸿蒙（HarmonyOS）支持** — 通过 RNOH 接入鸿蒙 Next，原生能力（存储 / 设备信息 / 崩溃采集）由 ArkTS TurboModule 提供，崩溃经系统 faultLogger 事后拉取上报
 - **OOM采集（iOS）** — 看门狗终止（Watchdog Termination / FOOM）的事后推断上报，默认关闭，需显式开启
 - **API性能监控** — 自动拦截 XMLHttpRequest / fetch 请求，采集耗时、状态码等指标
 - **JS错误捕获** — 自动捕获 JavaScript 运行时异常
@@ -263,6 +264,50 @@ armsRum.init({ endpoint: cfg?.endpoint, env: cfg?.env });
 
 > 即便不使用 config plugin，Expo 工程在 `npm install` 后执行 `expo prebuild --clean` 即可由 autolinking 自动接入原生模块；plugin 仅提供配置透传的便利。
 
+## 鸿蒙（HarmonyOS / RNOH）接入
+
+SDK 支持通过 RNOH（React Native for OpenHarmony）接入鸿蒙应用，JS 侧初始化与 iOS / Android 完全一致，无需修改业务代码；原生能力由 SDK 内置的 ArkTS TurboModule（`harmony/rum_sdk`）提供。
+
+**前提条件**：
+
+- RNOH 0.77.71 线（宿主工程依赖 `@react-native-oh/react-native-harmony` 0.77.71、`react` 18.3.1、`react-native` 0.77.1）
+- DevEco Studio（含 OpenHarmony SDK 与 ohpm）
+
+**接入步骤**：
+
+1. 在 JS 工程安装 npm 包（同 iOS / Android）：`npm install @arms/rum-reactnative`。
+2. 在鸿蒙宿主工程的 `entry/oh-package.json5` 中以本地路径引用 SDK 的鸿蒙模块，并执行 `ohpm install`：
+
+```json5
+{
+  "dependencies": {
+    "@arms/rum-reactnative": "file:../node_modules/@arms/rum-reactnative/harmony/rum_sdk"
+  }
+}
+```
+
+3. 在 `entry/src/main/ets/PackageProvider.ets` 中注册 SDK 的 Package：
+
+```typescript
+import { RumSdkPackage } from '@arms/rum-reactnative';
+
+// packages 数组中追加
+new RumSdkPackage(ctx),
+```
+
+4. 重新构建 HAP（DevEco Studio Build，或 `hvigorw assembleHap`）。
+
+**能力差异**：
+
+| 能力 | 鸿蒙行为 |
+|------|----------|
+| 原生崩溃采集 | 经系统 faultLogger 事后拉取：崩溃发生后的**下次启动**时读取并上报；采集 JS_CRASH 与 CPP_CRASH，APP_FREEZE 不采集 |
+| OOM 采集 | 不支持（仅 iOS） |
+| 存储 | `@ohos.data.preferences`，命名空间与 iOS / Android 一致 |
+| 纯 JS 能力（API 监控 / JS 错误 / PV / Action / 链路追踪） | 与其他平台一致，原生模块缺失时自动降级为纯 JS 模式 |
+
+完整示例工程参见仓库内 `example-harmony`（含 hdc 驱动的端到端验证脚本）。
+
 ## 原生代码集成方式
 
 SDK 的原生崩溃采集层通过**源码编译**集成，不预编译二进制随 npm 包发布：
@@ -400,6 +445,7 @@ SDK 仅持久化一个键 `_arms_uid`（匿名用户 UID），用于跨冷启动
 |------|------|----------|
 | iOS | `NSUserDefaults`（独立 suite） | `com.aliyun.arms.rum.reactnative` |
 | Android | `SharedPreferences`（独立 prefs 文件） | `com.aliyun.arms.rum.reactnative` |
+| HarmonyOS | `@ohos.data.preferences`（独立 store） | `com.aliyun.rum.reactnative` |
 
 ### 原生存储 API
 
@@ -446,6 +492,7 @@ SDK 的 peerDependencies 声明为 `react-native: >=0.68.0`，原生构建配置
 | **设备信息采集** | `Platform.OS` / `Dimensions.get()` | 0.68 | 全版本可用，原生桥失败有 JS 降级 |
 | **自监控（Self-Monitoring）** | `fetch` 上报 Protobuf 至 `/rum/monitor` | 0.68 | 纯 JS 实现 |
 | **Expo 集成** | Expo Config Plugin | Expo SDK 49+（RN 0.72+） | 仅配置透传，零运行时依赖 |
+| **鸿蒙（HarmonyOS）** | RNOH + ArkTS TurboModule + `@ohos.faultLogger` | RNOH 0.77.71（RN 0.77.1 + react 18.3.1） | 依赖宿主为 RNOH 工程；崩溃采集为下次启动事后拉取；App 的 RN 版本不受 0.68 下限约束（鸿蒙侧独立实现） |
 
 > **总结**：SDK 声明支持 RN ≥ 0.68。iOS 经 `__has_include` 条件协议 + `RCT_EXPORT_METHOD` 旧桥导出、Android 经 `@ReactMethod` 方法表 + `namespace` DSL 条件守卫，原生能力在 0.68-0.70（旧桥路径）与 0.71+（TurboModule 协议 / interop）均可用；构建层 RN 0.71+ 使用 `install_modules_dependencies` / `react-android`，0.68-0.70 使用手动依赖 / `react-native:+`。JS 侧通过 `TurboModuleRegistry.get` + `NativeModules` 双路径获取原生模块，原生模块缺失时自动降级为空实现，不影响纯 JS 能力。RN ≤0.70 的 Android 宿主需满足 Kotlin ≥1.8 前置条件（见「升级 / 接入注意事项」第 4 条）。
 

package/docs/ReactNative SDK/351/205/215/347/275/256/345/217/202/350/200/203.md"

@@ -421,6 +421,19 @@ armsRum.init({
 });
 ```
 
+## 平台能力差异
+
+SDK 的配置项在各平台通用，部分采集能力存在平台差异：
+
+| 能力 / 配置 | iOS | Android | HarmonyOS（RNOH） |
+|------------|-----|---------|-------------------|
+| 原生崩溃采集（crash） | KSCrash 现场捕获，下次启动读取上报 | Java + NDK 现场捕获，下次启动读取上报 | 系统 faultLogger 持久化，**下次启动拉取**上报；采集 JS_CRASH / CPP_CRASH，APP_FREEZE 暂不采集 |
+| oom | 支持（`collectors.oom: true` 显式开启） | 空实现（`OutOfMemoryError` 走崩溃链路） | 不支持 |
+| 存储 | `NSUserDefaults`（独立 suite） | `SharedPreferences`（独立 prefs 文件） | `@ohos.data.preferences`（独立 store） |
+| 设备信息 | 原生采集，失败回退 JS 兜底 | 原生采集，失败回退 JS 兜底 | 原生采集，失败回退 JS 兜底 |
+
+> **说明**：HarmonyOS 端崩溃在下次启动时上报，`exception` 事件中会携带 `snapshots.raw_log`（系统 faultlog 原文，超长截断）作为解析兜底；重复启动不会重复上报同一次崩溃（ack 删除 + 崩溃指纹去重）。
+
 ## 完整配置示例
 
 ```typescript

package/docs/SDK /347/211/210/346/234/254/350/257/264/346/230/216.md"

@@ -4,6 +4,15 @@
 
 ## 版本列表
 
+### v0.1.5（2026年11月）
+
+新增鸿蒙（HarmonyOS）平台支持，通过 RNOH 接入，JS 侧初始化与 iOS / Android 完全一致。
+
+- 新增鸿蒙平台支持：内置 ArkTS TurboModule 提供存储、设备信息与原生崩溃采集，宿主需 RNOH 0.77.71 线（RN 0.77.1 + react 18.3.1）与 DevEco Studio
+- 鸿蒙原生崩溃经系统 faultLogger 于下次启动时拉取上报，采集 JS 崩溃与 Native 崩溃，应用卡死（APP_FREEZE）不采集
+- 鸿蒙端未接入原生模块时自动降级为纯 JS 模式，API 监控 / JS 错误 / PV / Action / 链路追踪照常可用
+- OOM 采集仍仅 iOS 提供，鸿蒙端不支持
+
 ### v0.1.4（2026年10月）
 
 iOS 看门狗终止（OOM）推断采集、RN 0.68-0.70 原生兼容打通、API 采集合并为 XHR 单一通道与发布产物混淆修复。

package/docs//346/216/245/345/205/245ReactNative/345/272/224/347/224/250.md

@@ -1,6 +1,6 @@
 # 接入React Native应用
 
-阿里云ARMS用户体验监控支持监控React Native应用（编译为Android和iOS等原生应用），通过集成npm包的方式，采集应用运行过程中的性能指标、异常问题和用户行为数据，并上报至ARMS控制台，帮助您提升应用的稳定性和用户体验。
+阿里云ARMS用户体验监控支持监控React Native应用（编译为Android、iOS及鸿蒙HarmonyOS等原生应用），通过集成npm包的方式，采集应用运行过程中的性能指标、异常问题和用户行为数据，并上报至ARMS控制台，帮助您提升应用的稳定性和用户体验。
 
 ## 创建应用
 
@@ -24,6 +24,7 @@
 - Android 构建：需安装 NDK 与 CMake（由宿主工程的 `ndkVersion` 决定，SDK 不强制特定版本）
   - **RN 0.68-0.70 的 Android 工程额外要求**：宿主 `android/build.gradle` 的 buildscript 需声明 `kotlin-gradle-plugin` classpath，且 Kotlin 版本 **≥ 1.8.0**（RN 0.70 模板默认 1.6.x，与 SDK 依赖的 kotlin-stdlib 1.8 metadata 不兼容，需手动提升）；AGP 7.2 及以下无需改动，SDK 构建脚本自动回退 AndroidManifest package 属性
 - iOS 构建：需 CocoaPods（用于拉取 `KSCrash` 崩溃采集依赖）；RN 0.68-0.70 无需额外配置，`pod install` 后自动走旧桥导出路径
+- 鸿蒙构建（可选）：需 RNOH 0.77.71 线（`@react-native-oh/react-native-harmony` 0.77.71、`react` 18.3.1、`react-native` 0.77.1）与 DevEco Studio，详见下方[接入鸿蒙（HarmonyOS / RNOH）](#接入鸿蒙harmonyos--rnoh)
 
 ### 安装步骤
 
@@ -167,6 +168,64 @@ export default function App() {
 
 > **说明**：集成后，SDK会自动采集页面切换事件，包括页面名称、加载时间等信息。
 
+## 接入鸿蒙（HarmonyOS / RNOH）
+
+SDK 支持通过 RNOH（React Native for OpenHarmony）接入鸿蒙应用。JS 侧初始化代码与 iOS / Android 完全一致，无需修改业务代码；原生能力（存储、设备信息、崩溃采集）由 SDK 内置的 ArkTS TurboModule 提供。
+
+### 前提条件
+
+- 宿主工程为 RNOH 工程，且位于 0.77.71 线（`@react-native-oh/react-native-harmony` 0.77.71、`react` 18.3.1、`react-native` 0.77.1）
+- 已安装 DevEco Studio（含 OpenHarmony SDK 与 ohpm）
+
+### 接入步骤
+
+**1. 安装 npm 包**
+
+在 JS 工程根目录执行（与 iOS / Android 共用同一安装步骤）：
+
+```bash
+npm install @arms/rum-reactnative
+```
+
+**2. 鸿蒙宿主工程添加 ohpm 依赖**
+
+在宿主工程 `entry/oh-package.json5` 中以本地路径引用 SDK 的鸿蒙模块，然后执行 `ohpm install`：
+
+```json5
+{
+  "dependencies": {
+    "@arms/rum-reactnative": "file:../node_modules/@arms/rum-reactnative/harmony/rum_sdk"
+  }
+}
+```
+
+**3. 注册 TurboModule Package**
+
+在 `entry/src/main/ets/PackageProvider.ets` 中注册：
+
+```typescript
+import { RumSdkPackage } from '@arms/rum-reactnative';
+
+// 在 packages 数组中追加
+new RumSdkPackage(ctx),
+```
+
+**4. 重新构建 HAP**
+
+使用 DevEco Studio Build，或命令行执行 `hvigorw assembleHap`。构建完成后部署到鸿蒙设备即可，JS 侧 `armsRum.init` 无需任何改动。
+
+### 鸿蒙端能力说明
+
+| 能力 | 鸿蒙端行为 |
+|------|-----------|
+| 原生崩溃采集 | 崩溃发生后由系统 faultLogger 服务持久化，SDK 在**下次启动**时拉取并上报；采集 JS 崩溃（JS_CRASH）与 Native 崩溃（CPP_CRASH），应用卡死（APP_FREEZE）暂不采集 |
+| JS 异常 / API 监控 / PV / Action / 链路追踪 | 与 iOS / Android 行为一致 |
+| OOM 采集 | 不支持（仅 iOS 提供） |
+| 存储 | `@ohos.data.preferences`，与应用自身偏好数据相互隔离 |
+| 降级容错 | 原生模块未接入时，SDK 自动降级为纯 JS 模式，事件照常上报 |
+
+> **说明**：SDK 使用 `@ohos.faultLogger` 读取应用自身的崩溃记录，无需在 `module.json5` 中声明任何权限。
+
 ## 验证接入
 
 完成上述步骤后，启动您的React Native应用并进行一些操作（如点击按钮、发起网络请求等）。等待约1-2分钟后，在ARMS控制台的**用户体验监控** > **应用列表**中查看您的应用，确认有数据上报。
@@ -237,3 +296,7 @@ SDK 的 Android 崩溃采集模块通过 CMake 从源码编译，需要 NDK 与
 ### 6. iOS `pod install` 拉取 KSCrash 失败？
 
 `KSCrash` 通过 CocoaPods 源码依赖引入。若拉取失败，先执行 `pod repo update` 更新本地 spec 仓库后重试；网络受限环境可配置 CocoaPods 镜像源。
+
+### 7. 鸿蒙端崩溃为什么在应用重启后才上报？
+
+鸿蒙端崩溃采集基于系统 faultLogger 服务：崩溃发生时由系统持久化崩溃记录，进程已终止无法现场上报；SDK 在下次启动初始化时拉取、解析并上报，随后删除本地缓存并通过崩溃指纹去重，不会重复上报。这是鸿蒙端的预期行为。

package/harmony/rum_sdk/BuildProfile.ets

@@ -0,0 +1,17 @@
+/**
+ * Use these variables when you tailor your ArkTS code. They must be of the const type.
+ */
+export const HAR_VERSION = '0.1.4';
+export const BUILD_MODE_NAME = 'debug';
+export const DEBUG = true;
+export const TARGET_NAME = 'default';
+
+/**
+ * BuildProfile Class is used only for compatibility purposes.
+ */
+export default class BuildProfile { 
+	static readonly HAR_VERSION = HAR_VERSION;
+	static readonly BUILD_MODE_NAME = BUILD_MODE_NAME;
+	static readonly DEBUG = DEBUG;
+	static readonly TARGET_NAME = TARGET_NAME;
+}

package/harmony/rum_sdk/Index.ets

@@ -0,0 +1,2 @@
+export * from './ts';
+export * from './src/main/ets/RumSdkPackage';

package/harmony/rum_sdk/build-profile.json5

@@ -0,0 +1,22 @@
+{
+  "apiType": "stageMode",
+  "buildOption": {},
+  "buildOptionSet": [
+    {
+      "name": "release",
+      "arkOptions": {
+        "obfuscation": {
+          "ruleOptions": {
+            "enable": false,
+            "files": ["./obfuscation-rules.txt"]
+          }
+        }
+      }
+    }
+  ],
+  "targets": [
+    {
+      "name": "default"
+    }
+  ]
+}

package/harmony/rum_sdk/hvigorfile.ts

@@ -0,0 +1 @@
+export { harTasks } from '@ohos/hvigor-ohos-plugin';

package/harmony/rum_sdk/oh-package.json5

@@ -0,0 +1,10 @@
+{
+  "name": "@arms/rum-reactnative",
+  "version": "0.1.5",
+  "description": "RUM SDK for React Native - HarmonyOS (RNOH) TurboModule",
+  "main": "Index.ets",
+  "license": "MIT",
+  "dependencies": {
+    "@rnoh/react-native-openharmony": "0.77.71"
+  }
+}

package/harmony/rum_sdk/src/main/ets/RumSdkPackage.ets

@@ -0,0 +1,15 @@
+import { RNOHPackage } from '@rnoh/react-native-openharmony'
+import type { AnyThreadTurboModule, AnyThreadTurboModuleContext } from '@rnoh/react-native-openharmony/ts'
+import { TM } from './generated/ts'
+import { RumSdkTurboModule } from './RumSdkTurboModule'
+
+export class RumSdkPackage extends RNOHPackage {
+  override getAnyThreadTurboModuleFactoryByNameMap(): Map<string, (ctx: AnyThreadTurboModuleContext) => AnyThreadTurboModule | null> {
+    return new Map<string, (ctx: AnyThreadTurboModuleContext) => AnyThreadTurboModule>()
+      .set(TM.RumSdkReactnative.NAME, (ctx) => new RumSdkTurboModule(ctx))
+  }
+
+  override getDebugName(): string {
+    return 'rum_sdk'
+  }
+}

package/harmony/rum_sdk/src/main/ets/RumSdkTurboModule.ts

@@ -0,0 +1,274 @@
+import { AnyThreadTurboModule } from '@rnoh/react-native-openharmony/ts'
+import type { AnyThreadTurboModuleContext } from '@rnoh/react-native-openharmony/ts'
+import { TM } from './generated/ts'
+import deviceInfo from '@ohos.deviceInfo'
+import dataPreferences from '@ohos.data.preferences'
+import bundleManager from '@ohos.bundle.bundleManager'
+import display from '@ohos.display'
+import util from '@ohos.util'
+import type common from '@ohos.app.ability.common'
+import { CrashManager, triggerArkTsCrash } from './crash/CrashManager'
+
+const PREFS_NAME = 'com.aliyun.rum.reactnative'
+const DEVICE_ID_KEY = 'rum_device_id'
+
+type RumTurboModuleContext = AnyThreadTurboModuleContext
+
+/**
+ * RUM SDK 鸿蒙端 TurboModule 实现（P0 阶段）：
+ * - 存储：@ohos.data.preferences（与 Android SharedPreferences 语义对齐）
+ * - 设备信息：deviceInfo / bundleManager / display
+ * - 崩溃 / OOM：P2 阶段对接 faultLogger 前的空实现（与 JS 侧降级语义一致）
+ *
+ * 继承 AnyThreadTurboModule：Worker 线程与 UI 线程均可实例化，
+ * RNOH 按任一工厂提供的映射解析。
+ */
+export class RumSdkTurboModule extends AnyThreadTurboModule implements TM.RumSdkReactnative.Spec {
+  private context: common.UIAbilityContext | undefined = undefined
+  private crashManager: CrashManager | undefined = undefined
+
+  constructor(ctx: RumTurboModuleContext) {
+    super(ctx)
+    this.context = ctx.uiAbilityContext as common.UIAbilityContext
+  }
+
+  private getCrashManager(): CrashManager {
+    if (!this.crashManager && this.context) {
+      this.crashManager = new CrashManager(this.context)
+    }
+    if (!this.crashManager) {
+      throw new Error('uiAbilityContext is unavailable')
+    }
+    return this.crashManager
+  }
+
+  private getPrefs(): dataPreferences.Preferences {
+    if (!this.context) {
+      throw new Error('uiAbilityContext is unavailable')
+    }
+    return dataPreferences.getPreferencesSync(this.context, { name: PREFS_NAME })
+  }
+
+  // region Storage
+
+  getItem(key: string): Promise<null | string> {
+    return new Promise<null | string>((resolve, reject) => {
+      try {
+        const prefs = this.getPrefs()
+        if (!prefs.hasSync(key)) {
+          resolve(null)
+          return
+        }
+        const value = prefs.getSync(key, '') as string
+        resolve(value)
+      } catch (e) {
+        reject(new Error(`RUM_STORAGE_ERROR: ${e}`))
+      }
+    })
+  }
+
+  setItem(key: string, value: string): Promise<void> {
+    return new Promise<void>((resolve, reject) => {
+      try {
+        const prefs = this.getPrefs()
+        prefs.putSync(key, value)
+        prefs.flush()
+        resolve()
+      } catch (e) {
+        reject(new Error(`RUM_STORAGE_ERROR: ${e}`))
+      }
+    })
+  }
+
+  removeItem(key: string): Promise<void> {
+    return new Promise<void>((resolve, reject) => {
+      try {
+        const prefs = this.getPrefs()
+        prefs.deleteSync(key)
+        prefs.flush()
+        resolve()
+      } catch (e) {
+        reject(new Error(`RUM_STORAGE_ERROR: ${e}`))
+      }
+    })
+  }
+
+  clear(): Promise<void> {
+    return new Promise<void>((resolve, reject) => {
+      try {
+        const prefs = this.getPrefs()
+        prefs.clearSync()
+        prefs.flush()
+        resolve()
+      } catch (e) {
+        reject(new Error(`RUM_STORAGE_ERROR: ${e}`))
+      }
+    })
+  }
+
+  getAllKeys(): Promise<string[]> {
+    return new Promise<string[]>((resolve, reject) => {
+      try {
+        const prefs = this.getPrefs()
+        const all = prefs.getAllSync()
+        resolve(Object.keys(all))
+      } catch (e) {
+        reject(new Error(`RUM_STORAGE_ERROR: ${e}`))
+      }
+    })
+  }
+
+  // endregion
+
+  // region Device Info
+
+  /**
+   * OpenHarmony 无公开的设备级稳定 ID API（udid 需系统权限），
+   * 采用「本地生成 UUID 并持久化」作为 device_id（应用级稳定，
+   * 卸载重装后变化，与 Android ANDROID_ID 恢复出厂重置的语义最接近）。
+   */
+  private getOrCreateDeviceId(): string {
+    try {
+      const prefs = this.getPrefs()
+      if (prefs.hasSync(DEVICE_ID_KEY)) {
+        return prefs.getSync(DEVICE_ID_KEY, '') as string
+      }
+      const id = util.generateRandomUUID(false)
+      prefs.putSync(DEVICE_ID_KEY, id)
+      prefs.flush()
+      return id
+    } catch (e) {
+      // 存储不可用时返回临时 ID，避免设备信息整体采集失败
+      return util.generateRandomUUID(false)
+    }
+  }
+
+  /** deviceInfo.deviceType（phone/tablet/2in1/...）→ 存储模型 device.type 取值 */
+  private resolveDeviceType(type: string): string {
+    if (type === 'tablet') {
+      return 'tablet'
+    }
+    return 'mobile'
+  }
+
+  getDeviceInfo(): Promise<TM.RumSdkReactnative.NativeDeviceInfo> {
+    return new Promise<TM.RumSdkReactnative.NativeDeviceInfo>((resolve, reject) => {
+      try {
+        const info: TM.RumSdkReactnative.NativeDeviceInfo = {}
+        info.device_id = this.getOrCreateDeviceId()
+        info.device_brand = deviceInfo.manufacture
+        info.device_model = deviceInfo.productModel
+        info.device_name = deviceInfo.hardwareModel
+        info.device_type = this.resolveDeviceType(deviceInfo.deviceType)
+        info.os_type = 'HarmonyOS'
+        info.os_version = deviceInfo.osFullName
+        try {
+          const bundleInfo = bundleManager.getBundleInfoForSelfSync(
+            bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT
+          )
+          info.app_package = bundleInfo.name
+          info.app_version = bundleInfo.versionName
+        } catch (e) {
+          // 忽略，交由 JS 层兜底
+        }
+        try {
+          const d = display.getDefaultDisplaySync()
+          info.viewport_width = d.width
+          info.viewport_height = d.height
+        } catch (e) {
+          // 忽略，交由 JS 层 Dimensions 兜底
+        }
+        resolve(info)
+      } catch (e) {
+        reject(new Error(`RUM_DEVICE_INFO_ERROR: ${e}`))
+      }
+    })
+  }
+
+  // endregion
+
+  // region Crash（对接 @ohos.faultLogger，详见 crash/CrashManager.ts）
+
+  getPendingCrashes(): Promise<string> {
+    return this.getCrashManager().getPendingCrashes()
+  }
+
+  clearCrashReports(crashIds: string): Promise<void> {
+    return new Promise<void>((resolve, reject) => {
+      try {
+        this.getCrashManager().clearCrashReports(crashIds)
+        resolve()
+      } catch (e) {
+        reject(new Error(`RUM_CRASH_ERROR: ${e}`))
+      }
+    })
+  }
+
+  clearAllCrashReports(): Promise<void> {
+    return new Promise<void>((resolve, reject) => {
+      try {
+        this.getCrashManager().clearAllCrashReports()
+        resolve()
+      } catch (e) {
+        reject(new Error(`RUM_CRASH_ERROR: ${e}`))
+      }
+    })
+  }
+
+  cleanupOldCrashes(maxFiles: number, maxAgeMs: number): Promise<void> {
+    return new Promise<void>((resolve, reject) => {
+      try {
+        this.getCrashManager().cleanupOldCrashes(maxFiles, maxAgeMs)
+        resolve()
+      } catch (e) {
+        reject(new Error(`RUM_CRASH_ERROR: ${e}`))
+      }
+    })
+  }
+
+  crashedLastRun(): Promise<boolean> {
+    return new Promise<boolean>((resolve, reject) => {
+      try {
+        resolve(this.getCrashManager().hasCrashFiles())
+      } catch (e) {
+        reject(new Error(`RUM_CRASH_ERROR: ${e}`))
+      }
+    })
+  }
+
+  updateCrashContext(context: string): void {
+    try {
+      this.getCrashManager().updateContext(context)
+    } catch (e) {
+      // ignore
+    }
+  }
+
+  triggerTestCrash(crashType: string): void {
+    if (crashType === 'js_crash' || crashType === 'js_exception' || crashType === 'java_exception') {
+      triggerArkTsCrash()
+    }
+  }
+
+  // endregion
+
+  // region OOM（看门狗终止为 iOS 能力，鸿蒙端空实现）
+
+  getPendingOomReports(): Promise<string> {
+    return new Promise<string>((resolve) => {
+      resolve('[]')
+    })
+  }
+
+  clearOomReports(oomIds: string): Promise<void> {
+    return new Promise<void>((resolve, reject) => {
+      resolve()
+    })
+  }
+
+  updateCollectorsConfig(config: string): void {
+    // 鸿蒙端暂无可同步的原生采集配置，接受但忽略
+  }
+
+  // endregion
+}