@arms/rum-reactnative 0.1.4-beta.1 → 0.1.4-beta.2

package/README.md

@@ -420,6 +420,7 @@ SDK 仅持久化一个键 `_arms_uid`（匿名用户 UID），用于跨冷启动
 1. **必须重新构建原生工程**：新增了 TurboModule 方法，升级或首次接入后需要重新执行 iOS 的 `pod install`、Android 的 Gradle Sync；Expo 工程请执行 `expo prebuild --clean` 后再编译，否则会报 protocol method 缺失。
 2. **隔离命名空间，不污染宿主 App**：iOS 走独立 `NSUserDefaults` suite、Android 走独立 prefs 文件，与宿主 App 自身的偏好数据互不干扰；用户卸载 / 抹机时会一并清除。
 3. **从旧版本（依赖 AsyncStorage）升级会重置一次 UID**：原 AsyncStorage 中的 `_arms_uid` 不会自动迁移到新存储，老用户首次升级后会被分配新 UID（仅影响一次 UV 统计的连续性，不影响功能与后续使用）。如对历史 UID 连续性有强诉求，请提 issue。
+4. **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 无需改动——SDK 构建脚本对 AGP <7.3 自动回退 AndroidManifest package 属性。iOS 侧无额外配置，`pod install` 即可（0.68-0.70 自动走旧桥导出路径）。因含原生代码，**Expo Go 不可用**（需 `expo prebuild` 或 EAS Build）。
 
 ## 版本要求
 
@@ -427,7 +428,7 @@ SDK 的 peerDependencies 声明为 `react-native: >=0.68.0`，原生构建配置
 
 | 功能点 | 关键依赖 / API | 最低 RN 版本 | 说明 |
 |--------|--------------|-------------|------|
-| **原生崩溃采集** | TurboModule + codegen | 0.68 | podspec / build.gradle 按版本条件分支，自动适配 0.68-0.70 和 0.71+ |
+| **原生崩溃采集** | TurboModule + codegen | 0.68 | 自动适配 0.68-0.70 旧桥导出与 0.71+ Spec 协议/interop；RN ≤0.70 Android 前置条件见注意事项 4 |
 | NDK 崩溃采集（C/C++） | CMake + NDK `externalNativeBuild` | 0.68 | 随原生崩溃采集一起启用 |
 | iOS 崩溃采集（KSCrash） | KSCrash 2.5.1（CocoaPods 源码依赖，已锁定版本） | 0.68 | `pod install` 时自动编译 |
 | **OOM 采集（iOS）** | TurboModule + KSCrash + 状态快照持久化 | 0.68 | 仅 iOS，默认关闭（`collectors.oom` 显式开启）；Android 为空实现 |
@@ -446,7 +447,7 @@ SDK 的 peerDependencies 声明为 `react-native: >=0.68.0`，原生构建配置
 | **自监控（Self-Monitoring）** | `fetch` 上报 Protobuf 至 `/rum/monitor` | 0.68 | 纯 JS 实现 |
 | **Expo 集成** | Expo Config Plugin | Expo SDK 49+（RN 0.72+） | 仅配置透传，零运行时依赖 |
 
-> **总结**：SDK 声明支持 RN ≥ 0.68，原生构建配置（podspec / build.gradle）已做多版本条件适配。RN 0.71+ 使用 `install_modules_dependencies` / `react-android`；RN 0.68-0.70 使用手动依赖 / `react-native:+`。JS 侧通过 `TurboModuleRegistry.get` + `NativeModules` 双路径获取原生模块，原生模块缺失时自动降级为空实现，不影响纯 JS 能力。
+> **总结**：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/android/build.gradle

@@ -70,7 +70,11 @@ if (isRn71Plus) {
 }
 
 android {
-  namespace "com.rumsdkreactnative"
+  // AGP 7.3+ 才支持 namespace DSL（RN 0.70 模板默认 AGP 7.2.1）；低版本回退
+  // AndroidManifest.xml 的 package 属性（RN 0.68-0.70 兼容，见 dev-docs 打通方案 A1）
+  if (android.hasProperty("namespace")) {
+    namespace "com.rumsdkreactnative"
+  }
 
   compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
 
@@ -109,6 +113,13 @@ android {
     }
   }
 
+  // CMake 显式链接 c++_shared 与 react-android 携带的同名 so 在 androidTest 变体
+  // 合并时冲突（mergeAndroidTestNativeLibs 报 2 files found）。两者为同一 STL，取任一
+  // 均可，pickFirst 去重（库模块自身声明，宿主无需额外配置）。
+  packagingOptions {
+    pickFirst "**/libc++_shared.so"
+  }
+
   lintOptions {
     disable "GradleCompatible"
   }

package/android/gradle.properties

@@ -1,4 +1,6 @@
-RumSdkReactnative_kotlinVersion=2.0.21
+# 默认 1.8.0：stdlib metadata 可被 1.8+ 编译器读取（向上兼容），覆盖 RN 0.68-0.70
+# 手动配置场景与 0.71+ 默认工具链；宿主 rootProject.ext.kotlinVersion 定义时优先跟随宿主
+RumSdkReactnative_kotlinVersion=1.8.0
 RumSdkReactnative_minSdkVersion=24
 RumSdkReactnative_targetSdkVersion=34
 RumSdkReactnative_compileSdkVersion=35

package/android/src/main/AndroidManifest.xml

@@ -1,4 +1,7 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+<!-- package 属性：AGP <7.3（RN 0.68-0.70）下的包名来源；AGP 7.3+ 由 build.gradle
+     条件 namespace 取代（该属性被忽略，仅 deprecation warning，属预期） -->
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+  package="com.rumsdkreactnative">
   <application>
     <!--
       崩溃处理器自启动：通过 ContentProvider 在 Application.onCreate() 之前安装

package/android/src/main/java/com/rumsdkreactnative/RumSdkReactnativeModule.kt

@@ -10,6 +10,8 @@ import android.view.WindowManager
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
 import com.facebook.react.module.annotations.ReactModule
 import com.rumsdkreactnative.crash.CrashContextManager
 import com.rumsdkreactnative.crash.CrashHandler
@@ -17,9 +19,13 @@ import org.json.JSONArray
 import org.json.JSONObject
 import java.io.File
 
+// 不继承 codegen 生成的 Spec 基类（RN ≤0.70 不运行 codegen、无此产物，见
+// dev-docs/RN 0.68-0.70 兼容性打通方案.md A2）：直接继承 ReactContextBaseJavaModule，
+// 方法经 @ReactMethod 导出（RN 0.71+ 经 TurboModule interop 调用）；
+// 代价是失去 codegen 对 TS Spec 与原生签名一致性的编译期校验，签名变更需人工同步 Spec
 @ReactModule(name = RumSdkReactnativeModule.NAME)
 class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
-  NativeRumSdkReactnativeSpec(reactContext) {
+  ReactContextBaseJavaModule(reactContext) {
 
   private val prefs: SharedPreferences =
     migratePrefs(reactContext).also {
@@ -36,7 +42,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
 
   // region Storage
 
-  override fun getItem(key: String, promise: Promise) {
+  @ReactMethod
+  fun getItem(key: String, promise: Promise) {
     try {
       promise.resolve(prefs.getString(key, null))
     } catch (e: Throwable) {
@@ -44,7 +51,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  override fun setItem(key: String, value: String, promise: Promise) {
+  @ReactMethod
+  fun setItem(key: String, value: String, promise: Promise) {
     try {
       prefs.edit().putString(key, value).apply()
       promise.resolve(null)
@@ -53,7 +61,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  override fun removeItem(key: String, promise: Promise) {
+  @ReactMethod
+  fun removeItem(key: String, promise: Promise) {
     try {
       prefs.edit().remove(key).apply()
       promise.resolve(null)
@@ -62,7 +71,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  override fun clear(promise: Promise) {
+  @ReactMethod
+  fun clear(promise: Promise) {
     try {
       prefs.edit().clear().apply()
       promise.resolve(null)
@@ -71,7 +81,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  override fun getAllKeys(promise: Promise) {
+  @ReactMethod
+  fun getAllKeys(promise: Promise) {
     try {
       val array = Arguments.createArray()
       for (key in prefs.all.keys) {
@@ -87,7 +98,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
 
   // region Device Info
 
-  override fun getDeviceInfo(promise: Promise) {
+  @ReactMethod
+  fun getDeviceInfo(promise: Promise) {
     try {
       val ctx = reactApplicationContext
       val map = Arguments.createMap()
@@ -170,7 +182,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
    * 崩溃文件命名：crash_{timestamp}_{id}.json（Java）或 crash_native_{timestamp}_{pid}.json（NDK）
    * 注意：排除 context 文件（.rum_crash_context）和临时文件
    */
-  override fun getPendingCrashes(promise: Promise) {
+  @ReactMethod
+  fun getPendingCrashes(promise: Promise) {
     try {
       val arr = JSONArray()
       if (crashDir.exists() && crashDir.isDirectory) {
@@ -244,7 +257,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
   /**
    * 解析 crashIds JSON array，按 crash_id 删除对应文件。
    */
-  override fun clearCrashReports(crashIds: String, promise: Promise) {
+  @ReactMethod
+  fun clearCrashReports(crashIds: String, promise: Promise) {
     try {
       val ids = HashSet<String>()
       if (crashIds.isNotEmpty()) {
@@ -307,7 +321,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
   }
 
   /** 上次运行是否发生过崩溃：crashDir 中存在崩溃报告文件即认为发生过 */
-  override fun crashedLastRun(promise: Promise) {
+  @ReactMethod
+  fun crashedLastRun(promise: Promise) {
     try {
       val crashed = crashDir.exists() &&
         (crashDir.listFiles()?.any { it.isFile && isCrashReportFile(it.name) } ?: false)
@@ -318,7 +333,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
   }
 
   /** 更新崩溃上下文快照（session/view 变更时调用） */
-  override fun updateCrashContext(context: String) {
+  @ReactMethod
+  fun updateCrashContext(context: String) {
     try {
       crashContextManager.updateContext(context)
     } catch (_: Throwable) {
@@ -327,7 +343,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
   }
 
   /** 清除所有崩溃报告文件（用于清理无 crash_id 的旧版 NDK 文件） */
-  override fun clearAllCrashReports(promise: Promise) {
+  @ReactMethod
+  fun clearAllCrashReports(promise: Promise) {
     try {
       if (crashDir.exists() && crashDir.isDirectory) {
         val files = crashDir.listFiles { f -> isCrashReportFile(f.name) }
@@ -346,7 +363,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
   }
 
   /** 清理过期和超限的崩溃文件 */
-  override fun cleanupOldCrashes(maxFiles: Double, maxAgeMs: Double, promise: Promise) {
+  @ReactMethod
+  fun cleanupOldCrashes(maxFiles: Double, maxAgeMs: Double, promise: Promise) {
     try {
       if (!crashDir.exists() || !crashDir.isDirectory) {
         promise.resolve(null)
@@ -429,7 +447,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
    * 已由 CrashHandler 崩溃链路捕获，系统低内存杀进程检测不在本期范围。
    * 空实现仅为满足 TurboModule Spec 双端对齐。
    */
-  override fun getPendingOomReports(promise: Promise) {
+  @ReactMethod
+  fun getPendingOomReports(promise: Promise) {
     try {
       promise.resolve("[]")
     } catch (e: Throwable) {
@@ -438,7 +457,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
   }
 
   /** 清除 OOM 报告文件：Android 无 OOM 文件，no-op */
-  override fun clearOomReports(oomIds: String, promise: Promise) {
+  @ReactMethod
+  fun clearOomReports(oomIds: String, promise: Promise) {
     try {
       promise.resolve(null)
     } catch (e: Throwable) {
@@ -447,7 +467,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
   }
 
   /** 同步 JS 侧采集器配置（如 oom 开关）：Android 无 OOM 能力，接受但忽略 */
-  override fun updateCollectorsConfig(config: String) {
+  @ReactMethod
+  fun updateCollectorsConfig(config: String) {
     // no-op
   }
 
@@ -457,7 +478,8 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
 
   private external fun nativeTriggerCrash(type: Int)
 
-  override fun triggerTestCrash(crashType: String) {
+  @ReactMethod
+  fun triggerTestCrash(crashType: String) {
     when (crashType) {
       // TurboModule 架构下，@ReactMethod void 方法中抛出的 Java 异常会被 C++ 层
       // 拦截并转换为 JS 异常，不会到达 Thread.getDefaultUncaughtExceptionHandler()。

package/android/src/main/java/com/rumsdkreactnative/RumSdkReactnativePackage.kt

@@ -1,13 +1,17 @@
 package com.rumsdkreactnative
 
-import com.facebook.react.BaseReactPackage
+// 基类用 TurboReactPackage 而非 BaseReactPackage（见 dev-docs/RN 0.68-0.70 兼容性打通方案
+// 方案 A4）：BaseReactPackage 为 RN 0.74 新增类，RN 0.68-0.73 宿主下编译失败；
+// TurboReactPackage 自 RN 0.68 起存在（0.76+ 标记 deprecated 但仍可用，仅为警告）。
+// 两者抽象方法签名一致（getModule / getReactModuleInfoProvider）。
+import com.facebook.react.TurboReactPackage
 import com.facebook.react.bridge.NativeModule
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.module.model.ReactModuleInfo
 import com.facebook.react.module.model.ReactModuleInfoProvider
 import java.util.HashMap
 
-class RumSdkReactnativePackage : BaseReactPackage() {
+class RumSdkReactnativePackage : TurboReactPackage() {
   override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
     return if (name == RumSdkReactnativeModule.NAME) {
       RumSdkReactnativeModule(reactContext)
@@ -19,11 +23,14 @@ class RumSdkReactnativePackage : BaseReactPackage() {
   override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
     return ReactModuleInfoProvider {
       val moduleInfos: MutableMap<String, ReactModuleInfo> = HashMap()
+      // 7 参构造（含 hasConstants）：RN ≤0.72 仅提供此签名；0.73+ 保留为 deprecated
+      // 兼容构造（hasConstants 被忽略），故 0.68-0.79+ 全版本可编译。模块无 constants，传 false。
       moduleInfos[RumSdkReactnativeModule.NAME] = ReactModuleInfo(
         RumSdkReactnativeModule.NAME,
         RumSdkReactnativeModule.NAME,
         false,  // canOverrideExistingModule
         false,  // needsEagerInit
+        false,  // hasConstants（RN ≤0.72 必填，0.73+ 忽略）
         false,  // isCxxModule
         true // isTurboModule
       )

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

@@ -6,7 +6,13 @@
 
 ### v0.1.4（2026年09月）
 
-iOS 看门狗终止（OOM）推断采集与发布产物混淆修复。
+iOS 看门狗终止（OOM）推断采集、RN 0.68-0.70 原生兼容打通与发布产物混淆修复。
+
+#### v0.1.4-beta.2（2026年09月23日）
+
+打通 RN 0.68-0.70 原生兼容。
+
+- iOS/Android 崩溃采集与 OOM 在低版本旧架构可用（Android 宿主需 Kotlin ≥1.8，详见接入文档前提条件）
 
 #### v0.1.4-beta.1（2026年09月23日）
 

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

@@ -22,7 +22,8 @@
 - Node.js >= 18
 - npm或yarn包管理工具
 - Android 构建：需安装 NDK 与 CMake（由宿主工程的 `ndkVersion` 决定，SDK 不强制特定版本）
-- iOS 构建：需 CocoaPods（用于拉取 `KSCrash` 崩溃采集依赖）
+  - **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` 后自动走旧桥导出路径
 
 ### 安装步骤
 

package/ios/RumSdkReactnative.h

@@ -1,5 +1,15 @@
+// codegen 产物存在性分支（RN 版本兼容，见 dev-docs/RN 0.68-0.70 兼容性打通方案.md）：
+// - RN 0.71+（新旧架构均生成 React-Codegen 产物）：实现 codegen Spec 协议，
+//   方法经 JSI/TurboModule 绑定导出；
+// - RN 0.68-0.70 默认旧架构（codegen 不运行、无 Spec 产物）：回退普通
+//   RCTBridgeModule，方法经 .mm 中 RCT_EXPORT_METHOD 方法表导出，
+//   JS 侧经 NativeModules 路径调用（TurboModuleRegistry.get 未命中时自动降级）。
+#if __has_include(<RumSdkReactnativeSpec/RumSdkReactnativeSpec.h>)
 #import <RumSdkReactnativeSpec/RumSdkReactnativeSpec.h>
-
 @interface RumSdkReactnative : NSObject <NativeRumSdkReactnativeSpec>
+#else
+#import <React/RCTBridgeModule.h>
+@interface RumSdkReactnative : NSObject <RCTBridgeModule>
+#endif
 
 @end

package/ios/RumSdkReactnative.mm

@@ -55,40 +55,40 @@ RCT_EXPORT_MODULE()
     return defaults;
 }
 
-- (void)getItem:(NSString *)key
-        resolve:(RCTPromiseResolveBlock)resolve
-         reject:(RCTPromiseRejectBlock)reject
+RCT_EXPORT_METHOD(getItem:(NSString *)key
+                  resolve:(RCTPromiseResolveBlock)resolve
+                   reject:(RCTPromiseRejectBlock)reject)
 {
     NSString *value = [[self defaults] stringForKey:key];
     resolve(value ?: [NSNull null]);
 }
 
-- (void)setItem:(NSString *)key
-          value:(NSString *)value
-        resolve:(RCTPromiseResolveBlock)resolve
-         reject:(RCTPromiseRejectBlock)reject
+RCT_EXPORT_METHOD(setItem:(NSString *)key
+                  value:(NSString *)value
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
 {
     [[self defaults] setObject:value forKey:key];
     resolve(nil);
 }
 
-- (void)removeItem:(NSString *)key
-           resolve:(RCTPromiseResolveBlock)resolve
-            reject:(RCTPromiseRejectBlock)reject
+RCT_EXPORT_METHOD(removeItem:(NSString *)key
+                  resolve:(RCTPromiseResolveBlock)resolve
+                   reject:(RCTPromiseRejectBlock)reject)
 {
     [[self defaults] removeObjectForKey:key];
     resolve(nil);
 }
 
-- (void)clear:(RCTPromiseResolveBlock)resolve
-       reject:(RCTPromiseRejectBlock)reject
+RCT_EXPORT_METHOD(clear:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
 {
     [[self defaults] removePersistentDomainForName:kRumSdkDefaultsSuiteName];
     resolve(nil);
 }
 
-- (void)getAllKeys:(RCTPromiseResolveBlock)resolve
-            reject:(RCTPromiseRejectBlock)reject
+RCT_EXPORT_METHOD(getAllKeys:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
 {
     NSDictionary<NSString *, id> *suite =
         [[self defaults] persistentDomainForName:kRumSdkDefaultsSuiteName];
@@ -97,8 +97,8 @@ RCT_EXPORT_MODULE()
 
 // MARK: - Device Info
 
-- (void)getDeviceInfo:(RCTPromiseResolveBlock)resolve
-               reject:(RCTPromiseRejectBlock)reject
+RCT_EXPORT_METHOD(getDeviceInfo:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
 {
     @try {
         NSMutableDictionary *info = [NSMutableDictionary dictionary];
@@ -166,16 +166,22 @@ RCT_EXPORT_MODULE()
 
 // MARK: - TurboModule
 
+// RN 0.71+ 才生成 codegen 产物；RN 0.68-0.70 旧架构无 Spec，方法缺席即可——
+// 模块经 RCT_EXPORT_METHOD 方法表走旧桥（JS 侧 NativeModules 路径）。
+// 守卫条件与 .h 一致：Spec.h 为 umbrella 头，NativeRumSdkReactnativeSpecJSI
+// 类定义内联其中（codegen 产物中不存在 RumSdkReactnativeSpec/…SpecJSI.h 路径）
+#if __has_include(<RumSdkReactnativeSpec/RumSdkReactnativeSpec.h>)
 - (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
     (const facebook::react::ObjCTurboModule::InitParams &)params
 {
     return std::make_shared<facebook::react::NativeRumSdkReactnativeSpecJSI>(params);
 }
+#endif
 
 // MARK: - Crash Reporting
 
-- (void)getPendingCrashes:(RCTPromiseResolveBlock)resolve
-                   reject:(RCTPromiseRejectBlock)reject
+RCT_EXPORT_METHOD(getPendingCrashes:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
 {
     @try {
         NSArray<NSDictionary *> *reports = [RumCrashReporter pendingCrashReports];
@@ -195,9 +201,9 @@ RCT_EXPORT_MODULE()
     }
 }
 
-- (void)clearCrashReports:(NSString *)crashIds
+RCT_EXPORT_METHOD(clearCrashReports:(NSString *)crashIds
                   resolve:(RCTPromiseResolveBlock)resolve
-                   reject:(RCTPromiseRejectBlock)reject
+                   reject:(RCTPromiseRejectBlock)reject)
 {
     @try {
         NSArray *ids = @[];
@@ -218,8 +224,8 @@ RCT_EXPORT_MODULE()
     }
 }
 
-- (void)clearAllCrashReports:(RCTPromiseResolveBlock)resolve
-                      reject:(RCTPromiseRejectBlock)reject
+RCT_EXPORT_METHOD(clearAllCrashReports:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
 {
     @try {
         [RumCrashReporter clearAllCrashReports];
@@ -229,10 +235,10 @@ RCT_EXPORT_MODULE()
     }
 }
 
-- (void)cleanupOldCrashes:(double)maxFiles
-                 maxAgeMs:(double)maxAgeMs
+RCT_EXPORT_METHOD(cleanupOldCrashes:(double)maxFiles
+                  maxAgeMs:(double)maxAgeMs
                   resolve:(RCTPromiseResolveBlock)resolve
-                   reject:(RCTPromiseRejectBlock)reject
+                   reject:(RCTPromiseRejectBlock)reject)
 {
     @try {
         [RumCrashReporter cleanupOldCrashesWithMaxFiles:(NSInteger)maxFiles maxAgeMs:maxAgeMs];
@@ -242,15 +248,15 @@ RCT_EXPORT_MODULE()
     }
 }
 
-- (void)crashedLastRun:(RCTPromiseResolveBlock)resolve
-                reject:(RCTPromiseRejectBlock)reject
+RCT_EXPORT_METHOD(crashedLastRun:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
 {
     resolve(@([RumCrashReporter crashedLastRun]));
 }
 
 // MARK: - OOM (Watchdog Termination) Reporting
 
-- (void)updateCollectorsConfig:(NSString *)config
+RCT_EXPORT_METHOD(updateCollectorsConfig:(NSString *)config)
 {
     @try {
         // 解析 config JSON（如 {"oom": true}）。仅 oom == true 时安装 OOM 状态记录器
@@ -280,8 +286,8 @@ RCT_EXPORT_MODULE()
     }
 }
 
-- (void)getPendingOomReports:(RCTPromiseResolveBlock)resolve
-                      reject:(RCTPromiseRejectBlock)reject
+RCT_EXPORT_METHOD(getPendingOomReports:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
 {
     @try {
         NSArray<NSDictionary *> *reports = [RumAppStateRecorder pendingOomReports];
@@ -301,9 +307,9 @@ RCT_EXPORT_MODULE()
     }
 }
 
-- (void)clearOomReports:(NSString *)oomIds
-                 resolve:(RCTPromiseResolveBlock)resolve
-                  reject:(RCTPromiseRejectBlock)reject
+RCT_EXPORT_METHOD(clearOomReports:(NSString *)oomIds
+                  resolve:(RCTPromiseResolveBlock)resolve
+                   reject:(RCTPromiseRejectBlock)reject)
 {
     @try {
         NSArray *ids = @[];
@@ -324,7 +330,7 @@ RCT_EXPORT_MODULE()
     }
 }
 
-- (void)updateCrashContext:(NSString *)context
+RCT_EXPORT_METHOD(updateCrashContext:(NSString *)context)
 {
     [RumCrashReporter updateCrashContext:context];
 }

package/lib/commonjs/utils/platform.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.appName=exports.VERSION=void 0,exports.clearStorage=clearStorage,exports.fixAttrs=void 0,exports.getAllStorageKeys=getAllStorageKeys,exports.getStorage=getStorage,exports.removeStorage=removeStorage,exports.setStorage=setStorage;var _rumCore=require("@arms/rum-core"),_reactNative=require("react-native"),_NativeRumSdkReactnative=_interopRequireDefault(require("../NativeRumSdkReactnative"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const _pkg={version:"0.1.4-beta.1"},VERSION=exports.VERSION=_pkg.version,appName=exports.appName="react-native";function getReactNativeVersion(){try{return require("react-native/package.json").version??""}catch{const e=_reactNative.Platform.constants?.reactNativeVersion;return e?`${e.major}.${e.minor}.${e.patch}`:""}}function getStorage(e){return _NativeRumSdkReactnative.default.getItem(e)}function setStorage(e,t){return _NativeRumSdkReactnative.default.setItem(e,t)}function removeStorage(e){return _NativeRumSdkReactnative.default.removeItem(e)}function clearStorage(){return _NativeRumSdkReactnative.default.clear()}function getAllStorageKeys(){return _NativeRumSdkReactnative.default.getAllKeys()}async function fetchDeviceInfo(){try{return await _NativeRumSdkReactnative.default.getDeviceInfo()}catch(e){return console.warn("[rum] getDeviceInfo failed, falling back to JS defaults",e),{os_type:"ios"===_reactNative.Platform.OS?"iOS":"Android",os_version:String(_reactNative.Platform.Version??"")}}}let _cachedDeviceInfo=null;function getDeviceInfo(){return _cachedDeviceInfo||(_cachedDeviceInfo=fetchDeviceInfo()),_cachedDeviceInfo}const fixAttrs=async function(e){if(!e)return;const t=await getDeviceInfo(),r={id:t.device_id,type:t.device_type,brand:t.device_brand,model:t.device_model,name:t.device_name},a=getReactNativeVersion(),i={type:t.os_type??("ios"===_reactNative.Platform.OS?"iOS":"Android"),version:t.os_version??String(_reactNative.Platform.Version??""),container:appName,container_version:a||void 0};let o;if(t.viewport_width&&t.viewport_height)o={width:t.viewport_width,height:t.viewport_height};else try{const e=_reactNative.Dimensions.get("screen");o={width:Math.round(e.width),height:Math.round(e.height)}}catch{}return e.app.type=_rumCore.AppType.reactnative,e.app.package=e.app.package??t.app_package,e.app.version=e.app.version??t.app_version,e._v=VERSION,e.device={...r,...e.device},e.os={...i,...e.os},o&&(e.viewport={...e.viewport,...o}),e};exports.fixAttrs=fixAttrs;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.appName=exports.VERSION=void 0,exports.clearStorage=clearStorage,exports.fixAttrs=void 0,exports.getAllStorageKeys=getAllStorageKeys,exports.getStorage=getStorage,exports.removeStorage=removeStorage,exports.setStorage=setStorage;var _rumCore=require("@arms/rum-core"),_reactNative=require("react-native"),_NativeRumSdkReactnative=_interopRequireDefault(require("../NativeRumSdkReactnative"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const _pkg={version:"0.1.4-beta.2"},VERSION=exports.VERSION=_pkg.version,appName=exports.appName="react-native";function getReactNativeVersion(){try{return require("react-native/package.json").version??""}catch{const e=_reactNative.Platform.constants?.reactNativeVersion;return e?`${e.major}.${e.minor}.${e.patch}`:""}}function getStorage(e){return _NativeRumSdkReactnative.default.getItem(e)}function setStorage(e,t){return _NativeRumSdkReactnative.default.setItem(e,t)}function removeStorage(e){return _NativeRumSdkReactnative.default.removeItem(e)}function clearStorage(){return _NativeRumSdkReactnative.default.clear()}function getAllStorageKeys(){return _NativeRumSdkReactnative.default.getAllKeys()}async function fetchDeviceInfo(){try{return await _NativeRumSdkReactnative.default.getDeviceInfo()}catch(e){return console.warn("[rum] getDeviceInfo failed, falling back to JS defaults",e),{os_type:"ios"===_reactNative.Platform.OS?"iOS":"Android",os_version:String(_reactNative.Platform.Version??"")}}}let _cachedDeviceInfo=null;function getDeviceInfo(){return _cachedDeviceInfo||(_cachedDeviceInfo=fetchDeviceInfo()),_cachedDeviceInfo}const fixAttrs=async function(e){if(!e)return;const t=await getDeviceInfo(),r={id:t.device_id,type:t.device_type,brand:t.device_brand,model:t.device_model,name:t.device_name},a=getReactNativeVersion(),i={type:t.os_type??("ios"===_reactNative.Platform.OS?"iOS":"Android"),version:t.os_version??String(_reactNative.Platform.Version??""),container:appName,container_version:a||void 0};let o;if(t.viewport_width&&t.viewport_height)o={width:t.viewport_width,height:t.viewport_height};else try{const e=_reactNative.Dimensions.get("screen");o={width:Math.round(e.width),height:Math.round(e.height)}}catch{}return e.app.type=_rumCore.AppType.reactnative,e.app.package=e.app.package??t.app_package,e.app.version=e.app.version??t.app_version,e._v=VERSION,e.device={...r,...e.device},e.os={...i,...e.os},o&&(e.viewport={...e.viewport,...o}),e};exports.fixAttrs=fixAttrs;

package/lib/module/utils/platform.js

@@ -1 +1 @@
-"use strict";import{AppType}from"@arms/rum-core";import{Dimensions,Platform}from"react-native";import NativeRumSdkReactnative from"../NativeRumSdkReactnative.js";const _pkg={version:"0.1.4-beta.1"};export const VERSION=_pkg.version;export const appName="react-native";function getReactNativeVersion(){try{return require("react-native/package.json").version??""}catch{const e=Platform.constants?.reactNativeVersion;return e?`${e.major}.${e.minor}.${e.patch}`:""}}export function getStorage(e){return NativeRumSdkReactnative.getItem(e)}export function setStorage(e,t){return NativeRumSdkReactnative.setItem(e,t)}export function removeStorage(e){return NativeRumSdkReactnative.removeItem(e)}export function clearStorage(){return NativeRumSdkReactnative.clear()}export function getAllStorageKeys(){return NativeRumSdkReactnative.getAllKeys()}async function fetchDeviceInfo(){try{return await NativeRumSdkReactnative.getDeviceInfo()}catch(e){return console.warn("[rum] getDeviceInfo failed, falling back to JS defaults",e),{os_type:"ios"===Platform.OS?"iOS":"Android",os_version:String(Platform.Version??"")}}}let _cachedDeviceInfo=null;function getDeviceInfo(){return _cachedDeviceInfo||(_cachedDeviceInfo=fetchDeviceInfo()),_cachedDeviceInfo}export const fixAttrs=async function(e){if(!e)return;const t=await getDeviceInfo(),i={id:t.device_id,type:t.device_type,brand:t.device_brand,model:t.device_model,name:t.device_name},r=getReactNativeVersion(),n={type:t.os_type??("ios"===Platform.OS?"iOS":"Android"),version:t.os_version??String(Platform.Version??""),container:appName,container_version:r||void 0};let a;if(t.viewport_width&&t.viewport_height)a={width:t.viewport_width,height:t.viewport_height};else try{const e=Dimensions.get("screen");a={width:Math.round(e.width),height:Math.round(e.height)}}catch{}return e.app.type=AppType.reactnative,e.app.package=e.app.package??t.app_package,e.app.version=e.app.version??t.app_version,e._v=VERSION,e.device={...i,...e.device},e.os={...n,...e.os},a&&(e.viewport={...e.viewport,...a}),e};
+"use strict";import{AppType}from"@arms/rum-core";import{Dimensions,Platform}from"react-native";import NativeRumSdkReactnative from"../NativeRumSdkReactnative.js";const _pkg={version:"0.1.4-beta.2"};export const VERSION=_pkg.version;export const appName="react-native";function getReactNativeVersion(){try{return require("react-native/package.json").version??""}catch{const e=Platform.constants?.reactNativeVersion;return e?`${e.major}.${e.minor}.${e.patch}`:""}}export function getStorage(e){return NativeRumSdkReactnative.getItem(e)}export function setStorage(e,t){return NativeRumSdkReactnative.setItem(e,t)}export function removeStorage(e){return NativeRumSdkReactnative.removeItem(e)}export function clearStorage(){return NativeRumSdkReactnative.clear()}export function getAllStorageKeys(){return NativeRumSdkReactnative.getAllKeys()}async function fetchDeviceInfo(){try{return await NativeRumSdkReactnative.getDeviceInfo()}catch(e){return console.warn("[rum] getDeviceInfo failed, falling back to JS defaults",e),{os_type:"ios"===Platform.OS?"iOS":"Android",os_version:String(Platform.Version??"")}}}let _cachedDeviceInfo=null;function getDeviceInfo(){return _cachedDeviceInfo||(_cachedDeviceInfo=fetchDeviceInfo()),_cachedDeviceInfo}export const fixAttrs=async function(e){if(!e)return;const t=await getDeviceInfo(),i={id:t.device_id,type:t.device_type,brand:t.device_brand,model:t.device_model,name:t.device_name},r=getReactNativeVersion(),n={type:t.os_type??("ios"===Platform.OS?"iOS":"Android"),version:t.os_version??String(Platform.Version??""),container:appName,container_version:r||void 0};let a;if(t.viewport_width&&t.viewport_height)a={width:t.viewport_width,height:t.viewport_height};else try{const e=Dimensions.get("screen");a={width:Math.round(e.width),height:Math.round(e.height)}}catch{}return e.app.type=AppType.reactnative,e.app.package=e.app.package??t.app_package,e.app.version=e.app.version??t.app_version,e._v=VERSION,e.device={...i,...e.device},e.os={...n,...e.os},a&&(e.viewport={...e.viewport,...a}),e};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arms/rum-reactnative",
-  "version": "0.1.4-beta.1",
+  "version": "0.1.4-beta.2",
   "description": "RUM SDK For ReactNative",
   "homepage": "https://help.aliyun.com/zh/arms/user-experience-monitoring/",
   "main": "./lib/commonjs/index.js",