@arms/rum-reactnative 0.1.3-beta.1 → 0.1.3-beta.3

package/README.md

@@ -4,6 +4,7 @@
 
 ## 功能特性
 
+- **原生崩溃采集** — 自动捕获 iOS（KSCrash）与 Android（Java + NDK）原生崩溃，支持堆栈双侧截断与数据体积优化
 - **API性能监控** — 自动拦截 XMLHttpRequest / fetch 请求，采集耗时、状态码等指标
 - **JS错误捕获** — 自动捕获 JavaScript 运行时异常
 - **控制台错误监听** — 监听 `console.error` 输出
@@ -418,6 +419,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/docs/SDK /347/211/210/346/234/254/350/257/264/346/230/216.md"

@@ -4,9 +4,81 @@
 
 ## 版本列表
 
-| 版本 | 发布时间 | 发布说明 |
-|------|----------|----------|
-| v0.1.3 | 2026年07月 | 原生崩溃采集安全加固与自监控系统集成：<br/>• 修复 Android/iOS 原生崩溃采集多项安全漏洞（缓冲区溢出、路径遍历、crash_id 校验）<br/>• 提升采集稳定性（栈帧上限 256、线程安全、多格式时间戳解析）<br/>• 集成 rum-core Telemetry 自监控，SDK 内部异常自动上报<br/>• 公开导出 logger、callMonitored 供用户扩展使用 |
-| v0.1.2 | 2026年05月12日 | 包名正式化与核心采集能力修复：<br/>•  rum-core 升级至 >=0.1.4，包管理迁移至 Yarn 3 workspaces<br/>• 修复 PV 路由采集（首屏丢失、无 path 路由过滤、navigationRef 时序）<br/>• 修复 API 监控默认配置误关闭、propagatorTypes 空值崩溃<br/>• Reporter AppState 回调 this 绑定修复<br/>• 完善 README、接入指南、配置参考等文档 |
-| v0.1.1 | 2025年11月28日 | React Native SDK首个正式版本，提供各种配置、API，并提供了以下采集能力：<br/>• API监控（XMLHttpRequest / fetch），包括链路追踪等特性的支持<br/>• 异常监控（JS Error、Promise Rejection、console.error）<br/>• Session相关功能（采样、超时管理）<br/>• 自定义上报（Custom、Exception、Resource、View、Event）<br/>• React Navigation集成支持 |
-| v0.1.0 | 2025年08月20日 | React Native首个版本，提供各种配置、API，并提供了以下采集能力：<br/>• API监控（XMLHttpRequest / fetch），包括链路追踪等特性的支持<br/>• 异常监控（JS Error、Promise Rejection、console.error）<br/>• Session相关功能（采样、超时管理）<br/>• 自定义上报（Custom、Exception、Resource、View、Event）<br/>• React Navigation集成支持 |
+### v0.1.3（2026年07月）
+
+原生崩溃采集安全加固与自监控系统集成。
+
+- 修复 Android/iOS 原生崩溃采集多项安全漏洞（缓冲区溢出、路径遍历、crash_id 校验）
+- 提升采集稳定性（栈帧上限 256、线程安全、多格式时间戳解析）
+- 集成 rum-core Telemetry 自监控，SDK 内部异常自动上报
+- 公开导出 logger、callMonitored 供用户扩展使用
+
+#### v0.1.3-beta.3（2026年07月16日）
+
+API 监控增强与代码规范化。
+
+- 新增 XMLHttpRequest abort 事件处理，触发时标记 success 为 Failed
+- 修正 reviseApiAttr 保留 success 三态值（-1/0/1）的行为
+- 将 reporter sendRequest 失败日志等级由 error 降为 warn
+
+#### v0.1.3-beta.2（2026年07月16日）
+
+React Native 0.68-0.70 多版本兼容适配。
+
+- react-native peerDependencies 版本下限调整为 0.68.0
+- podspec / Android build.gradle 按 RN 版本条件适配依赖与插件配置
+- iOS crash 处理和代码生成适配多 RN 版本环境
+- 修复多平台崩溃采集数据不统一问题，保证字段和结构一致性
+- 强化 NDK 崩溃处理边界检查，提升稳定性
+- 缺少原生模块时自动降级，不影响纯 JS 功能运行
+
+#### v0.1.3-beta.1（2026年07月16日）
+
+崩溃堆栈截断策略与模块基址计算修复。
+
+- 统一安卓与 iOS 端双侧截断堆栈帧策略，保留前 256 + 后 256 帧，中间插入标记帧
+- NDK 最大帧数由 256 扩充至 512
+- 模块基址计算改用 rum_module_base_for_seg，确保 referenced_addrs 与 binary_images 过滤一致
+- 添加边界检查防止 ELF note section 解析时二次 SIGSEGV 崩溃
+
+#### v0.1.3-beta.0（2026年07月15日）
+
+iOS 与 Android NDK 崩溃采集修复及数据体积优化。
+
+- 修复 iOS objc_exception 和 cpp_exception 被 RN 桥拦截问题，改为新 NSThread 抛出异常绕过拦截
+- 修复 iOS KSCrash 安装失败静默吞掉、userInfo 异步更新竞态及 context 同步延迟问题
+- 优化 binary_images 按需过滤，iOS 减少 70-85%、Android NDK 减少 70-90% 崩溃数据体积
+- 移除 Android Java 崩溃 all_threads 字段，减少 60-80% 负载
+- 修复 Android NDK 崩溃文件重复上报问题，统一 crash_id 和文件名前缀匹配逻辑
+- 补充双平台缺失字段：iOS device brand/app package，Android rn_version，NDK platform/exception 结构
+- 修复 NDK 崩溃信号处理器二次 SIGSEGV，增加地址映射检测和缓冲区中间刷新
+
+### v0.1.2（2026年05月12日）
+
+包名正式化与核心采集能力修复。
+
+- rum-core 升级至 >=0.1.4，包管理迁移至 Yarn 3 workspaces
+- 修复 PV 路由采集（首屏丢失、无 path 路由过滤、navigationRef 时序）
+- 修复 API 监控默认配置误关闭、propagatorTypes 空值崩溃
+- Reporter AppState 回调 this 绑定修复
+- 完善 README、接入指南、配置参考等文档
+
+### v0.1.1（2025年11月28日）
+
+React Native SDK 首个正式版本，提供各种配置、API，并提供了以下采集能力：
+
+- API 监控（XMLHttpRequest / fetch），包括链路追踪等特性的支持
+- 异常监控（JS Error、Promise Rejection、console.error）
+- Session 相关功能（采样、超时管理）
+- 自定义上报（Custom、Exception、Resource、View、Event）
+- React Navigation 集成支持
+
+### v0.1.0（2025年08月20日）
+
+React Native 首个版本，提供各种配置、API，并提供了以下采集能力：
+
+- API 监控（XMLHttpRequest / fetch），包括链路追踪等特性的支持
+- 异常监控（JS Error、Promise Rejection、console.error）
+- Session 相关功能（采样、超时管理）
+- 自定义上报（Custom、Exception、Resource、View、Event）
+- React Navigation 集成支持

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

@@ -18,7 +18,7 @@
 
 ### 前提条件
 
-- React Native版本 >= 0.71（SDK 使用新架构 TurboModule，需 RN 0.71 及以上）
+- React Native版本 >= 0.68（SDK 已适配 0.68-0.70 多版本环境，原生模块缺失时自动降级为纯 JS 模式）
 - Node.js >= 18
 - npm或yarn包管理工具
 - Android 构建：需安装 NDK 与 CMake（由宿主工程的 `ndkVersion` 决定，SDK 不强制特定版本）

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/collector/resource/api.js

@@ -77,9 +77,9 @@ class ApiCollector {
   }
   hackXhr() {
     const oldXHRProto = XMLHttpRequest.prototype;
-    const self = this;
+    const that = this;
     (0, _rumCore.interceptFunction)(oldXHRProto, 'open', function (method, url, async, user, password) {
-      const filters = self.ctx.getConfig().filters || {};
+      const filters = that.ctx.getConfig().filters || {};
       const urlStr = String(url);
       const methodStr = method.toUpperCase();
       // chrome 对 URL 的最大长度为 8182 个字符
@@ -93,7 +93,7 @@ class ApiCollector {
         password,
         headers: {}
       };
-      const baseRumEvent = self.ctx.session.getBaseEvent();
+      const baseRumEvent = that.ctx.session.getBaseEvent();
       this.apiAttr = {
         ...baseRumEvent,
         url: urlStr,
@@ -111,7 +111,7 @@ class ApiCollector {
       if (!this.apiAttr || !this.apiCache) return;
       let apiAttr = this.apiAttr;
       this.apiCache.data = body;
-      self.injectTracing(this.apiAttr, tracingHeaders => {
+      that.injectTracing(this.apiAttr, tracingHeaders => {
         Object.keys(tracingHeaders).forEach(key => {
           tracingHeaders[key] && this.setRequestHeader(key, tracingHeaders[key]);
         });
@@ -124,7 +124,7 @@ class ApiCollector {
         } = this;
         const {
           evaluateApi
-        } = self.ctx.getConfig();
+        } = that.ctx.getConfig();
         if (!this.apiAttr) return;
         apiAttr.status_code = status;
         apiAttr.message = statusText;
@@ -148,15 +148,21 @@ class ApiCollector {
             _rumCore.logger.warn('api-collector', 'evaluateApi failed for XHR', e);
           }
         }
-        self.sendAPI(apiAttr, entry);
+        that.sendAPI(apiAttr, entry);
       });
       this.addEventListener('error', () => {
         this.apiAttr && (this.apiAttr.success = _rumCore.ResourceStatus.Failed);
       });
+      this.addEventListener('abort', () => {
+        if (this.apiAttr) {
+          this.apiAttr.success = _rumCore.ResourceStatus.Failed;
+          this.apiAttr.message = 'abort';
+        }
+      });
     }, true);
   }
   hackFetch() {
-    const self = this;
+    const that = this;
     const originFetch = this.originFetch = globalThis.fetch;
     const filters = this.ctx.getConfig().filters || {};
     globalThis.fetch = function (input, init = {}) {
@@ -175,7 +181,7 @@ class ApiCollector {
       if ((0, _rumCore.urlMatch)(urlStr, filters.resource) || method === 'HEAD' || init?.mode === 'no-cors' || urlStr.length > 8182) {
         return originFetch.call(global, input, init);
       }
-      const baseRumEvent = self.ctx.session.getBaseEvent();
+      const baseRumEvent = that.ctx.session.getBaseEvent();
       let apiAttr = {
         ...baseRumEvent,
         url: urlStr,
@@ -184,7 +190,7 @@ class ApiCollector {
       };
       let apiResp;
       let apiError;
-      self.injectTracing(apiAttr, tracingHeaders => {
+      that.injectTracing(apiAttr, tracingHeaders => {
         Object.keys(tracingHeaders).forEach(key => {
           if (!headers) return;
           if (headers instanceof Headers) {
@@ -198,7 +204,7 @@ class ApiCollector {
       async function fetchFinally() {
         const {
           evaluateApi
-        } = self.ctx.getConfig();
+        } = that.ctx.getConfig();
         const entry = {
           name: apiAttr.url,
           entryType: _api.ApiType.FETCH,
@@ -218,7 +224,7 @@ class ApiCollector {
             _rumCore.logger.warn('api-collector', 'evaluateApi failed for fetch', e);
           }
         }
-        self.sendAPI(apiAttr, entry);
+        that.sendAPI(apiAttr, entry);
       }
       return originFetch.call(globalThis, input, init).then(response => {
         // @ts-ignore

package/lib/commonjs/reporter/index.js

@@ -138,7 +138,7 @@ class RNReporter extends _rumCore.Reporter {
     }
   }
   catchHandle = err => {
-    _rumCore.logger.error('reporter', 'sendRequest failed', err);
+    _rumCore.logger.warn('reporter', 'sendRequest failed', err);
   };
   destroy() {
     this.appStateListener?.remove();

package/lib/commonjs/utils/api.js

@@ -23,8 +23,9 @@ function reviseApiAttr(attrs) {
   if ((0, _rumCore.isString)(attrs.message)) {
     obj.message = attrs.message.substring(0, 1e3);
   }
-  if ('success' in attrs) {
-    obj.success = attrs.success ? 1 : 0;
+  // 对齐 Browser 端：保留三态 (-1/0/1)，避免 Unknown(-1) 被误转为 Success(1)
+  if ((0, _rumCore.isNumber)(attrs.success) && attrs.success >= -1 && attrs.success <= 1) {
+    obj.success = attrs.success;
   }
   if ((0, _rumCore.isNumber)(attrs.duration) && attrs.duration >= 0) {
     obj.duration = attrs.duration;

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.1"};
+const _pkg = {"version":"0.1.3-beta.3"};
 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/collector/resource/api.js

@@ -73,9 +73,9 @@ export default class ApiCollector {
   }
   hackXhr() {
     const oldXHRProto = XMLHttpRequest.prototype;
-    const self = this;
+    const that = this;
     interceptFunction(oldXHRProto, 'open', function (method, url, async, user, password) {
-      const filters = self.ctx.getConfig().filters || {};
+      const filters = that.ctx.getConfig().filters || {};
       const urlStr = String(url);
       const methodStr = method.toUpperCase();
       // chrome 对 URL 的最大长度为 8182 个字符
@@ -89,7 +89,7 @@ export default class ApiCollector {
         password,
         headers: {}
       };
-      const baseRumEvent = self.ctx.session.getBaseEvent();
+      const baseRumEvent = that.ctx.session.getBaseEvent();
       this.apiAttr = {
         ...baseRumEvent,
         url: urlStr,
@@ -107,7 +107,7 @@ export default class ApiCollector {
       if (!this.apiAttr || !this.apiCache) return;
       let apiAttr = this.apiAttr;
       this.apiCache.data = body;
-      self.injectTracing(this.apiAttr, tracingHeaders => {
+      that.injectTracing(this.apiAttr, tracingHeaders => {
         Object.keys(tracingHeaders).forEach(key => {
           tracingHeaders[key] && this.setRequestHeader(key, tracingHeaders[key]);
         });
@@ -120,7 +120,7 @@ export default class ApiCollector {
         } = this;
         const {
           evaluateApi
-        } = self.ctx.getConfig();
+        } = that.ctx.getConfig();
         if (!this.apiAttr) return;
         apiAttr.status_code = status;
         apiAttr.message = statusText;
@@ -144,15 +144,21 @@ export default class ApiCollector {
             logger.warn('api-collector', 'evaluateApi failed for XHR', e);
           }
         }
-        self.sendAPI(apiAttr, entry);
+        that.sendAPI(apiAttr, entry);
       });
       this.addEventListener('error', () => {
         this.apiAttr && (this.apiAttr.success = ResourceStatus.Failed);
       });
+      this.addEventListener('abort', () => {
+        if (this.apiAttr) {
+          this.apiAttr.success = ResourceStatus.Failed;
+          this.apiAttr.message = 'abort';
+        }
+      });
     }, true);
   }
   hackFetch() {
-    const self = this;
+    const that = this;
     const originFetch = this.originFetch = globalThis.fetch;
     const filters = this.ctx.getConfig().filters || {};
     globalThis.fetch = function (input, init = {}) {
@@ -171,7 +177,7 @@ export default class ApiCollector {
       if (urlMatch(urlStr, filters.resource) || method === 'HEAD' || init?.mode === 'no-cors' || urlStr.length > 8182) {
         return originFetch.call(global, input, init);
       }
-      const baseRumEvent = self.ctx.session.getBaseEvent();
+      const baseRumEvent = that.ctx.session.getBaseEvent();
       let apiAttr = {
         ...baseRumEvent,
         url: urlStr,
@@ -180,7 +186,7 @@ export default class ApiCollector {
       };
       let apiResp;
       let apiError;
-      self.injectTracing(apiAttr, tracingHeaders => {
+      that.injectTracing(apiAttr, tracingHeaders => {
         Object.keys(tracingHeaders).forEach(key => {
           if (!headers) return;
           if (headers instanceof Headers) {
@@ -194,7 +200,7 @@ export default class ApiCollector {
       async function fetchFinally() {
         const {
           evaluateApi
-        } = self.ctx.getConfig();
+        } = that.ctx.getConfig();
         const entry = {
           name: apiAttr.url,
           entryType: ApiType.FETCH,
@@ -214,7 +220,7 @@ export default class ApiCollector {
             logger.warn('api-collector', 'evaluateApi failed for fetch', e);
           }
         }
-        self.sendAPI(apiAttr, entry);
+        that.sendAPI(apiAttr, entry);
       }
       return originFetch.call(globalThis, input, init).then(response => {
         // @ts-ignore

package/lib/module/reporter/index.js

@@ -134,7 +134,7 @@ class RNReporter extends Reporter {
     }
   }
   catchHandle = err => {
-    logger.error('reporter', 'sendRequest failed', err);
+    logger.warn('reporter', 'sendRequest failed', err);
   };
   destroy() {
     this.appStateListener?.remove();

package/lib/module/utils/api.js

@@ -15,8 +15,9 @@ export function reviseApiAttr(attrs) {
   if (isString(attrs.message)) {
     obj.message = attrs.message.substring(0, 1e3);
   }
-  if ('success' in attrs) {
-    obj.success = attrs.success ? 1 : 0;
+  // 对齐 Browser 端：保留三态 (-1/0/1)，避免 Unknown(-1) 被误转为 Success(1)
+  if (isNumber(attrs.success) && attrs.success >= -1 && attrs.success <= 1) {
+    obj.success = attrs.success;
   }
   if (isNumber(attrs.duration) && attrs.duration >= 0) {
     obj.duration = attrs.duration;

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.1"};
+const _pkg = {"version":"0.1.3-beta.3"};
 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.1",
+  "version": "0.1.3-beta.3",
   "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"