@arms/rum-reactnative 0.1.3-beta.0 → 0.1.3-beta.2

package/README.md

@@ -418,6 +418,32 @@ SDK 仅持久化一个键 `_arms_uid`（匿名用户 UID），用于跨冷启动
 2. **隔离命名空间，不污染宿主 App**：iOS 走独立 `NSUserDefaults` suite、Android 走独立 prefs 文件，与宿主 App 自身的偏好数据互不干扰；用户卸载 / 抹机时会一并清除。
 3. **从旧版本（依赖 AsyncStorage）升级会重置一次 UID**：原 AsyncStorage 中的 `_arms_uid` 不会自动迁移到新存储，老用户首次升级后会被分配新 UID（仅影响一次 UV 统计的连续性，不影响功能与后续使用）。如对历史 UID 连续性有强诉求，请提 issue。
 
+## 版本要求
+
+SDK 的 peerDependencies 声明为 `react-native: >=0.68.0`，原生构建配置已做多版本条件适配，不同功能点的实际要求如下：
+
+| 功能点 | 关键依赖 / API | 最低 RN 版本 | 说明 |
+|--------|--------------|-------------|------|
+| **原生崩溃采集** | TurboModule + codegen | 0.68 | podspec / build.gradle 按版本条件分支，自动适配 0.68-0.70 和 0.71+ |
+| NDK 崩溃采集（C/C++） | CMake + NDK `externalNativeBuild` | 0.68 | 随原生崩溃采集一起启用 |
+| iOS 崩溃采集（KSCrash） | KSCrash ~2.0（CocoaPods 源码依赖） | 0.68 | `pod install` 时自动编译 |
+| **JS 异常采集** | `ErrorUtils.setGlobalHandler` | 0.68 | 全版本可用 |
+| Hermes Promise rejection | `HermesInternal.enablePromiseRejectionTracker` | 0.70（推荐） | Hermes 为默认引擎时完整支持 |
+| JSC Promise rejection 兜底 | `globalThis.onunhandledrejection` | 0.68 | 非 Hermes 引擎有降级方案 |
+| console.error 监听 | `interceptFunction(console, 'error')` | 0.68 | 全版本可用 |
+| **API 性能监控** | `XMLHttpRequest.prototype` 拦截 | 0.68 | 全版本可用 |
+| fetch 拦截 | `globalThis.fetch` patch | 0.68 | 当前已注释，仅启用 XHR 拦截 |
+| 分布式链路追踪 | tracecontext / b3 / jaeger / sw8 | 0.68 | 纯 JS 实现，无原生依赖 |
+| **页面导航追踪（PV）** | React Navigation `addListener('state')` | 0.68 | 兼容 React Navigation v5 / v6 |
+| **用户行为采集（Action）** | patch `React.createElement` | 0.68 | 经典 JSX 运行时 |
+| Pressable 组件支持 | `RN.Pressable` | 0.68 | Pressable 在 0.63 引入，下限受 peerDependencies 约束 |
+| automatic JSX runtime patch | `react/jsx-runtime` 的 `jsx` / `jsxs` / `jsxDEV` | 0.73（推荐） | automatic runtime 在 RN 0.73+ 为默认 |
+| **设备信息采集** | `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+） | 仅配置透传，零运行时依赖 |
+
+> **总结**：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 能力。
+
 ## 相关文档
 
 - [ARMS用户体验监控文档](https://help.aliyun.com/zh/arms/user-experience-monitoring/)

package/RumSdkReactnative.podspec

@@ -10,7 +10,10 @@ Pod::Spec.new do |s|
   s.license      = package["license"]
   s.authors      = package["author"]
 
-  s.platforms    = { :ios => min_ios_version_supported }
+  # RN 0.73+ 通过 min_ios_version_supported 变量提供 iOS 最低版本；
+  # RN 0.68-0.72 无此变量，回退到 iOS 13.0。
+  min_ios = defined?(min_ios_version_supported) ? min_ios_version_supported : '13.0'
+  s.platforms    = { :ios => min_ios }
   s.source       = { :git => "https://code.alibaba-inc.com/aliyun-rum/rum-sdk-reactnative.git", :tag => "#{s.version}" }
 
   s.source_files = "ios/**/*.{h,m,mm,c,cpp}"
@@ -24,5 +27,19 @@ Pod::Spec.new do |s|
   # 故不自行预编译，直接由宿主工程 `pod install` 时源码编译。
   s.dependency "KSCrash", "~> 2.0"
 
-  install_modules_dependencies(s)
+  if defined?(install_modules_dependencies)
+    # RN 0.71+ 使用 install_modules_dependencies 自动解析 React 依赖
+    install_modules_dependencies(s)
+  else
+    # RN 0.68-0.70 手动声明 React 依赖
+    s.dependency 'React-Core'
+    if ENV["RCT_NEW_ARCH_ENABLED"] == "1"
+      s.dependency "React-RCTFabric"
+      s.dependency "React-Codegen"
+      s.dependency "RCT-Folly"
+      s.dependency "RCTRequired"
+      s.dependency "RCTTypeSafety"
+      s.dependency "ReactCommon/turbomodule/core"
+    end
+  end
 end

package/android/build.gradle

@@ -2,13 +2,71 @@ ext.getExtOrDefault = {name ->
   return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['RumSdkReactnative_' + name]
 }
 
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["RumSdkReactnative_" + name]).toInteger()
+}
+
+/**
+ * 定位宿主工程的 react-native 安装路径。
+ * 优先使用 REACT_NATIVE_NODE_MODULES_DIR 扩展属性，
+ * 其次尝试通过 node 解析（Gradle 7.5+），
+ * 最后搜索常见 node_modules 路径。
+ */
+def resolveReactNativeDir() {
+  def override = getExtOrDefault("REACT_NATIVE_NODE_MODULES_DIR")
+  if (override != null) {
+    return file(override)
+  }
+  try {
+    // Gradle 7.5+ (RN 0.71+)
+    def resolved = providers.exec {
+      workingDir = rootDir
+      commandLine("node", "--print", "require.resolve('react-native/package.json')")
+    }.standardOutput.asText.get().trim()
+    return file(resolved).parentFile
+  } catch (Exception ignored) {
+    // Gradle < 7.5 (RN 0.68-0.70): 搜索常见路径
+    def candidates = [
+      file("${rootDir}/../node_modules/react-native"),
+      file("${projectDir}/../../node_modules/react-native"),
+      file("${rootDir}/node_modules/react-native")
+    ]
+    for (def c : candidates) {
+      if (c.exists()) return c
+    }
+    return null
+  }
+}
+
+/**
+ * 判断宿主工程的 React Native 版本是否 >= 指定的 major.minor。
+ * 无法检测时默认返回 true（假设为较新版本）。
+ */
+def isRnVersionAtLeast(int minMajor, int minMinor) {
+  try {
+    def rnDir = resolveReactNativeDir()
+    if (rnDir == null) return true
+    def pkgFile = new File(rnDir, "package.json")
+    if (!pkgFile.exists()) return true
+    def version = new groovy.json.JsonSlurper().parse(pkgFile).version as String
+    def parts = version.tokenize(".")
+    def major = parts[0].toInteger()
+    def minor = parts[1].toInteger()
+    return major > minMajor || (major == minMajor && minor >= minMinor)
+  } catch (Exception ignored) {
+    return true
+  }
+}
+
+def isRn71Plus = isRnVersionAtLeast(0, 71)
+
 apply plugin: "com.android.library"
 apply plugin: "kotlin-android"
 
-apply plugin: "com.facebook.react"
-
-def getExtOrIntegerDefault(name) {
-  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["RumSdkReactnative_" + name]).toInteger()
+// RN 0.71+ 提供 com.facebook.react Gradle 插件用于 codegen，
+// RN 0.68-0.70 无此插件，跳过即可。
+if (isRn71Plus) {
+  apply plugin: "com.facebook.react"
 }
 
 android {
@@ -78,6 +136,11 @@ repositories {
 def kotlin_version = getExtOrDefault("kotlinVersion")
 
 dependencies {
-  implementation "com.facebook.react:react-android"
+  // RN 0.71+ 使用 react-android 制品，RN 0.68-0.70 使用 react-native:+
+  if (isRn71Plus) {
+    implementation "com.facebook.react:react-android"
+  } else {
+    implementation "com.facebook.react:react-native:+"
+  }
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
 }

package/android/src/main/jni/rum_crash_writer.c

@@ -191,7 +191,7 @@ static void emit_frame(int fd, char *buf, size_t *pos,
 
     int si = rum_module_index_for_addr(addr);
     if (si >= 0) {
-        uintptr_t base = rum_seg_load_base(si);
+        uintptr_t base = rum_module_base_for_seg(si);
 
         // 记录被引用模块的 image_addr（去重），供 binary_images 过滤
         if (base != 0 && *referenced_count < MAX_REFERENCED_MODULES) {
@@ -316,6 +316,9 @@ void rum_write_crash(int fd, int signum, siginfo_t *info, ucontext_t *uc,
 
     // 解析 /proc/self/maps（async-signal-safe），为帧提供模块归属与相对偏移
     rum_modules_parse();
+    // 构建去重模块列表，供 emit_frame 获取模块级基址和 binary_images 枚举使用。
+    // 必须在 frames 循环前调用，确保 rum_module_base_for_seg() 能查到模块。
+    int mod_count = rum_module_build_distinct();
 
     // binary_images 按需过滤：仅保留被栈帧引用的模块。
     // 参照 Sentry 实践，服务端符号化时忽略未被任何栈帧引用的模块，
@@ -328,36 +331,28 @@ void rum_write_crash(int fd, int signum, siginfo_t *info, ucontext_t *uc,
     // "frames":[{"address","library","image_addr","offset"}, ...]
     // library/offset 供后端结合 binary_images 的 build_id 精确符号化
     //
-    // 双侧截断（参照 Sentry 推荐方案）：frame_count 达到 TRUNCATION_THRESHOLD(512)
-    // 时说明实际栈可能更长（信号处理器中只能采集前 MAX_FRAMES 帧）。此时保留
-    // 前 FRAMES_PER_SIDE 帧和后 FRAMES_PER_SIDE 帧，中间插入标记帧。
-    // 注意：NDK 信号处理器只能获取前 512 帧，无法获取真正的"后 256 帧"
-    // （靠近 main 的帧），omitted_count=-1 表示实际总帧数未知。
+    // NDK 信号处理器最多采集 MAX_FRAMES(512) 帧。frame_count 达到
+    // TRUNCATION_THRESHOLD(512) 时说明实际栈可能更长（已达到采集上限），
+    // 此时全部输出 512 帧 + 尾部标记帧（omitted_count=-1 表示实际总帧数
+    // 未知），不做双侧截断——因为 NDK 只能获取前 512 帧，前 256 + 后 256
+    // 恰好覆盖全部 512 帧，中间无省略，插入中间标记帧会造成冗余。
     // frame_count < TRUNCATION_THRESHOLD 时全部输出，不截断。
     // 所有操作仅为栈上数组读写与整数比较，符合 async-signal-safe。
     buf_append(fd, buf, &pos, ",\"frames\":[");
-    int needs_truncation = (frame_count >= TRUNCATION_THRESHOLD);
+    int needs_tail_marker = (frame_count >= TRUNCATION_THRESHOLD);
     int first = 1;
 
-    int head_count = needs_truncation ? FRAMES_PER_SIDE : frame_count;
-    for (int i = 0; i < head_count; i++) {
+    for (int i = 0; i < frame_count; i++) {
         emit_frame(fd, buf, &pos, (uintptr_t)frames[i],
                    referenced_addrs, &referenced_count, &first);
     }
 
-    if (needs_truncation) {
-        // 截断标记帧（omitted_count=-1 表示实际总帧数未知）
+    if (needs_tail_marker) {
+        // 尾部标记帧（omitted_count=-1 表示实际总帧数未知）
         if (!first) {
             buf_append(fd, buf, &pos, ",");
         }
         buf_append(fd, buf, &pos, "{\"truncated\":true,\"omitted_count\":-1}");
-        first = 0;
-
-        int tail_start = frame_count - FRAMES_PER_SIDE;
-        for (int i = tail_start; i < frame_count; i++) {
-            emit_frame(fd, buf, &pos, (uintptr_t)frames[i],
-                       referenced_addrs, &referenced_count, &first);
-        }
     }
     buf_append(fd, buf, &pos, "]");
 
@@ -375,7 +370,6 @@ void rum_write_crash(int fd, int signum, siginfo_t *info, ucontext_t *uc,
     // 仅上报带 GNU build-id 的 file-backed 模块（build-id 等价于 iOS image uuid，
     // 用于后端精确匹配符号文件）。
     buf_append(fd, buf, &pos, ",\"binary_images\":[");
-    int mod_count = rum_module_build_distinct();
     int emitted = 0;
     char bid[BUILD_ID_HEX_CAP];
     for (int m = 0; m < mod_count; m++) {

package/android/src/main/jni/rum_module_info.c

@@ -152,6 +152,27 @@ uintptr_t rum_seg_load_base(int seg_index) {
     return g_segs[seg_index].start - g_segs[seg_index].offset;
 }
 
+uintptr_t rum_module_base_for_seg(int seg_index) {
+    if (seg_index < 0 || seg_index >= g_seg_count) {
+        return 0;
+    }
+    // 查找该段所属模块（同路径），返回模块级基址（image_addr）。
+    // 与 binary_images 的 rum_module_image_addr() 一致，确保 emit_frame
+    // 收集的 referenced_addrs 与 binary_images 过滤比较的基址相同。
+    // 若 rum_module_build_distinct() 尚未调用（g_mod_count == 0），
+    // 回退到段级基址。
+    const char *path = g_segs[seg_index].path;
+    int path_len = g_segs[seg_index].path_len;
+    for (int m = 0; m < g_mod_count; m++) {
+        if (g_mods[m].path_len == path_len &&
+            memcmp(g_mods[m].path, path, (size_t)path_len) == 0) {
+            return g_mods[m].image_addr;
+        }
+    }
+    // Fallback: 段级基址
+    return g_segs[seg_index].start - g_segs[seg_index].offset;
+}
+
 const char *rum_seg_path(int seg_index, int *out_len) {
     if (seg_index < 0 || seg_index >= g_seg_count) {
         if (out_len) *out_len = 0;
@@ -296,6 +317,24 @@ int rum_module_build_id_hex(uintptr_t load_base, char *out, int out_cap) {
             const unsigned char *name = note + sizeof(ElfW(Nhdr));
             const unsigned char *desc = name + ((namesz + 3u) & ~3u);
 
+            // 边界检查：确保 name 区域不超出 note section。
+            // 损坏的 namesz 可导致 name 指针越界，memcmp 读取未映射内存
+            // 触发二次 SIGSEGV。
+            if (name + namesz > note_end) {
+                break;
+            }
+
+            // 边界检查：desc 起始地址（含对齐填充）不得超出 note section。
+            if (desc > note_end) {
+                break;
+            }
+
+            // 边界检查：将 descsz clamp 到实际可用范围，防止 desc[b] 循环
+            // 读取超出 note section 的内存，触发二次 SIGSEGV。
+            if (desc + descsz > note_end) {
+                descsz = (uint32_t)(note_end - desc);
+            }
+
             if (type == NT_GNU_BUILD_ID && namesz == 4 &&
                 memcmp(name, "GNU", 4) == 0) {
                 static const char hexc[] = "0123456789abcdef";

package/android/src/main/jni/rum_module_info.h

@@ -24,6 +24,10 @@ int rum_module_index_for_addr(uintptr_t addr);
 /** 段的加载基址（= start - file_offset）。索引非法返回 0。 */
 uintptr_t rum_seg_load_base(int seg_index);
 
+/** 段所属模块的加载基址（模块级 image_addr，与 binary_images 一致）。
+ *  需在 rum_module_build_distinct() 之后调用；未构建时回退到段级基址。 */
+uintptr_t rum_module_base_for_seg(int seg_index);
+
 /** 段对应的模块路径（指向内部缓冲，非 null 结尾）。out_len 输出长度。 */
 const char *rum_seg_path(int seg_index, int *out_len);
 

package/lib/commonjs/NativeRumSdkReactnative.js

@@ -16,6 +16,10 @@ var _reactNative = require("react-native");
 /**
  * 获取原生模块。
  *
+ * 优先使用 TurboModuleRegistry（RN 0.68+ TurboModule 架构），
+ * 若未找到则降级到 Legacy Bridge 的 NativeModules（RN 0.68-0.70 未开启 New Arch 时），
+ * 若均不可用则返回一组空实现兜底。
+ *
  * 使用非强制的 `TurboModuleRegistry.get`（而非 `getEnforcing`），避免在原生
  * 二进制未注册该模块时于「模块加载阶段」直接抛异常——那会连锁导致整个 JS
  * bundle 评估失败（表现为所有路由丢失 default export、App 白屏）。
@@ -25,7 +29,7 @@ var _reactNative = require("react-native");
  * JS 异常等纯 JS 能力不受影响。需重新构建原生工程（如 `expo run:ios` /
  * `pod install` + 重新编译）后崩溃采集才会真正生效。
  */
-const nativeModule = _reactNative.TurboModuleRegistry.get('RumSdkReactnative');
+const nativeModule = _reactNative.TurboModuleRegistry.get('RumSdkReactnative') ?? _reactNative.NativeModules.RumSdkReactnative;
 if (!nativeModule) {
   console.warn("[rum] Native module 'RumSdkReactnative' not found in the native binary. " + 'Crash reporting and native device info are disabled. ' + 'Rebuild the native app (e.g. `expo run:ios` / `expo run:android`, ' + 'or `pod install` + rebuild) so the module gets registered.');
 }

package/lib/commonjs/utils/crash.js

@@ -119,6 +119,9 @@ function formatStack(frames) {
     // 截断标记帧：双侧截断时插入的中间标记
     if (frame.truncated) {
       const count = frame.omitted_count ?? -1;
+      if (count < 0) {
+        return `#${index} ... frames omitted (unknown count) ...`;
+      }
       return `#${index} ... ${count} frames omitted ...`;
     }
     const library = frame.library || '<unknown>';

package/lib/commonjs/utils/platform.js

@@ -14,7 +14,7 @@ var _rumCore = require("@arms/rum-core");
 var _reactNative = require("react-native");
 var _NativeRumSdkReactnative = _interopRequireDefault(require("../NativeRumSdkReactnative"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-const _pkg = {"version":"0.1.3-beta.0"};
+const _pkg = {"version":"0.1.3-beta.2"};
 const VERSION = exports.VERSION = _pkg.version;
 
 // eslint-disable-next-line @typescript-eslint/no-unused-vars

package/lib/module/NativeRumSdkReactnative.js

@@ -1,6 +1,6 @@
 "use strict";
 
-import { TurboModuleRegistry } from 'react-native';
+import { NativeModules, TurboModuleRegistry } from 'react-native';
 
 /**
  * 原生设备信息，对应存储模型中的公共属性：
@@ -13,6 +13,10 @@ import { TurboModuleRegistry } from 'react-native';
 /**
  * 获取原生模块。
  *
+ * 优先使用 TurboModuleRegistry（RN 0.68+ TurboModule 架构），
+ * 若未找到则降级到 Legacy Bridge 的 NativeModules（RN 0.68-0.70 未开启 New Arch 时），
+ * 若均不可用则返回一组空实现兜底。
+ *
  * 使用非强制的 `TurboModuleRegistry.get`（而非 `getEnforcing`），避免在原生
  * 二进制未注册该模块时于「模块加载阶段」直接抛异常——那会连锁导致整个 JS
  * bundle 评估失败（表现为所有路由丢失 default export、App 白屏）。
@@ -22,7 +26,7 @@ import { TurboModuleRegistry } from 'react-native';
  * JS 异常等纯 JS 能力不受影响。需重新构建原生工程（如 `expo run:ios` /
  * `pod install` + 重新编译）后崩溃采集才会真正生效。
  */
-const nativeModule = TurboModuleRegistry.get('RumSdkReactnative');
+const nativeModule = TurboModuleRegistry.get('RumSdkReactnative') ?? NativeModules.RumSdkReactnative;
 if (!nativeModule) {
   console.warn("[rum] Native module 'RumSdkReactnative' not found in the native binary. " + 'Crash reporting and native device info are disabled. ' + 'Rebuild the native app (e.g. `expo run:ios` / `expo run:android`, ' + 'or `pod install` + rebuild) so the module gets registered.');
 }

package/lib/module/utils/crash.js

@@ -114,6 +114,9 @@ function formatStack(frames) {
     // 截断标记帧：双侧截断时插入的中间标记
     if (frame.truncated) {
       const count = frame.omitted_count ?? -1;
+      if (count < 0) {
+        return `#${index} ... frames omitted (unknown count) ...`;
+      }
       return `#${index} ... ${count} frames omitted ...`;
     }
     const library = frame.library || '<unknown>';

package/lib/module/utils/platform.js

@@ -3,7 +3,7 @@
 import { AppType } from '@arms/rum-core';
 import { Dimensions, Platform } from 'react-native';
 import NativeRumSdkReactnative from "../NativeRumSdkReactnative.js";
-const _pkg = {"version":"0.1.3-beta.0"};
+const _pkg = {"version":"0.1.3-beta.2"};
 export const VERSION = _pkg.version;
 
 // eslint-disable-next-line @typescript-eslint/no-unused-vars

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arms/rum-reactnative",
-  "version": "0.1.3-beta.0",
+  "version": "0.1.3-beta.2",
   "description": "RUM SDK For ReactNative",
   "homepage": "https://help.aliyun.com/zh/arms/user-experience-monitoring/",
   "main": "./lib/commonjs/index.js",
@@ -109,7 +109,7 @@
   "peerDependencies": {
     "@arms/rum-core": ">=0.1.4",
     "react": "*",
-    "react-native": "*"
+    "react-native": ">=0.68.0"
   },
   "workspaces": [
     "example"