@arms/rum-reactnative 0.1.3-beta.4 → 0.1.3-beta.5

package/README.md

@@ -427,7 +427,7 @@ SDK 的 peerDependencies 声明为 `react-native: >=0.68.0`，原生构建配置
 |--------|--------------|-------------|------|
 | **原生崩溃采集** | 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` 时自动编译 |
+| iOS 崩溃采集（KSCrash） | KSCrash 2.5.1（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 引擎有降级方案 |

package/RumSdkReactnative.podspec

@@ -25,7 +25,9 @@ Pod::Spec.new do |s|
 
   # KSCrash 通过 CocoaPods 源码依赖引入。KSCrash 不发布官方 XCFramework，
   # 故不自行预编译，直接由宿主工程 `pod install` 时源码编译。
-  s.dependency "KSCrash", "~> 2.0"
+  # 锁定到已验证版本 2.5.1：避免 `~> 2.0` 浮动解析到未经测试的新版本，在不同
+  # iOS（尤其新系统如 iOS 26）上源码编译引入不可控行为。升级须重新回归验证后再改此处。
+  s.dependency "KSCrash", "2.5.1"
 
   if defined?(install_modules_dependencies)
     # RN 0.71+ 使用 install_modules_dependencies 自动解析 React 依赖

package/ios/RumCrashReporter.mm

@@ -11,6 +11,8 @@
 #import <dlfcn.h>
 #import <signal.h>
 #import <stdlib.h>
+#import <string.h>
+#import <mach-o/dyld.h>
 
 #import "fishhook.h"
 
@@ -53,6 +55,37 @@ static void RumCrashReporterEarlyLoad(void) {
     gRumCrashLoaded = 1;
 }
 
+#pragma mark - Detox detection
+
+/**
+ * 检测当前进程是否运行在 Detox（E2E 测试）环境下。
+ *
+ * 仅当检测到 Detox 时，才需要用 fishhook 把被 Detox swizzle 的 sigaction 重绑回
+ * libsystem 的真实实现（详见 +install 内注释）。生产环境不存在 Detox，应跳过该
+ * 全局运行时符号重绑：rebind_symbols 会遍历进程内所有已加载镜像、对命中的
+ * __DATA_CONST 符号指针页执行 vm_protect + 改写，属高侵入操作，可能扰动其他库
+ * （如图片解码）后台线程的内存布局与调度时序。参见
+ * docs/iOS 26 图片解码崩溃排查说明.md。
+ *
+ * 采用双重信号，兼容 Detox “链接进 App” 与 “DYLD_INSERT_LIBRARIES 注入” 两种集成：
+ *   1) Detox 框架注册的 Objective-C 主类 "Detox" 是否存在；
+ *   2) 已加载的 dyld 镜像路径中是否包含 "Detox"（覆盖注入了框架但主类名不同的情形）。
+ * 本函数在普通线程（RN 模块 init）调用，非信号处理器上下文，可安全使用 Foundation/dyld API。
+ */
+static BOOL RumIsDetoxRuntimePresent(void) {
+    if (NSClassFromString(@"Detox") != nil) {
+        return YES;
+    }
+    uint32_t imageCount = _dyld_image_count();
+    for (uint32_t i = 0; i < imageCount; i++) {
+        const char *imageName = _dyld_get_image_name(i);
+        if (imageName != NULL && strstr(imageName, "Detox") != NULL) {
+            return YES;
+        }
+    }
+    return NO;
+}
+
 #pragma mark - Helpers
 
 @interface RumCrashReporter ()
@@ -129,28 +162,32 @@ static void RumCrashReporterEarlyLoad(void) {
                 config.userInfoJSON = @{ kRumCrashUserInfoContextKey: currentContext };
             }
 
-            // Detox（如果注入）通过 fishhook swizzle 了 sigaction，会静默丢弃后续对
-            // SIGABRT/SIGSEGV 等致命信号的 sigaction 调用。KSCrash 的 signal monitor
-            // 调用 sigaction 安装自己的 handler 时就会被丢弃，导致 KSCrash 无法捕获
-            // 信号类崩溃。
-            // 这里在 KSCrash install 之前用 fishhook 把 sigaction 的 lazy pointer
-            // 重绑回 libsystem 的真实函数（dlsym 返回的是真实函数地址，不受 fishhook
-            // 影响）。重绑后 KSCrash 的 sigaction 调用会真正生效，其 signal handler
-            // 会覆盖 Detox 的 handler。崩溃发生时 KSCrash 先写报告，再 uninstall +
-            // raise(sig) 触发 Detox 的 handler（KSCrash 在 uninstall 时恢复了 previous
-            // handler），Detox 仍能感知崩溃并通知测试 runner。
-            static int (*real_sigaction)(int, const struct sigaction * __restrict,
-                                         struct sigaction * __restrict) = NULL;
-            if (real_sigaction == NULL) {
-                real_sigaction = (int (*)(int, const struct sigaction * __restrict,
-                                          struct sigaction * __restrict))
-                    dlsym(RTLD_DEFAULT, "sigaction");
-            }
-            if (real_sigaction != NULL) {
-                struct rebinding rebindings[] = {
-                    {"sigaction", (void *)real_sigaction, NULL},
-                };
-                rebind_symbols(rebindings, sizeof(rebindings) / sizeof(rebindings[0]));
+            // 【仅在 Detox（E2E）环境下执行】Detox 会通过 fishhook swizzle sigaction，
+            // 静默丢弃后续对 SIGABRT/SIGSEGV 等致命信号的 sigaction 调用，导致 KSCrash
+            // 的 signal monitor 无法安装 handler、捕获不到信号类崩溃。此时在 KSCrash
+            // install 之前用 fishhook 把 sigaction 的 lazy pointer 重绑回 libsystem 的
+            // 真实函数（dlsym 返回真实地址，不受 fishhook 影响），KSCrash 的 sigaction
+            // 调用即可生效，其 signal handler 会覆盖 Detox 的 handler；崩溃时 KSCrash
+            // 先写报告，再 uninstall + raise(sig) 触发 Detox 的 handler（uninstall 已
+            // 恢复 previous handler），Detox 仍能感知崩溃并通知测试 runner。
+            //
+            // 生产环境无 Detox 的 sigaction swizzle，无需重绑；rebind_symbols 的高侵入
+            // 全局改写可能扰动其他库后台线程（如 SDWebImage 图片解码）的内存/时序，
+            // 故用 RumIsDetoxRuntimePresent() 将其收敛为仅测试环境执行。
+            if (RumIsDetoxRuntimePresent()) {
+                static int (*real_sigaction)(int, const struct sigaction * __restrict,
+                                             struct sigaction * __restrict) = NULL;
+                if (real_sigaction == NULL) {
+                    real_sigaction = (int (*)(int, const struct sigaction * __restrict,
+                                              struct sigaction * __restrict))
+                        dlsym(RTLD_DEFAULT, "sigaction");
+                }
+                if (real_sigaction != NULL) {
+                    struct rebinding rebindings[] = {
+                        {"sigaction", (void *)real_sigaction, NULL},
+                    };
+                    rebind_symbols(rebindings, sizeof(rebindings) / sizeof(rebindings[0]));
+                }
             }
 
             NSError *error = nil;

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.4"};
+const _pkg = {"version":"0.1.3-beta.5"};
 const VERSION = exports.VERSION = _pkg.version;
 
 // eslint-disable-next-line @typescript-eslint/no-unused-vars

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.4"};
+const _pkg = {"version":"0.1.3-beta.5"};
 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.4",
+  "version": "0.1.3-beta.5",
   "description": "RUM SDK For ReactNative",
   "homepage": "https://help.aliyun.com/zh/arms/user-experience-monitoring/",
   "main": "./lib/commonjs/index.js",