@arms/rum-reactnative 0.1.3-beta.4 → 0.1.4-beta.1

package/README.md

@@ -5,6 +5,7 @@
 ## 功能特性
 
 - **原生崩溃采集** — 自动捕获 iOS（KSCrash）与 Android（Java + NDK）原生崩溃，支持堆栈双侧截断与数据体积优化
+- **OOM采集（iOS）** — 看门狗终止（Watchdog Termination / FOOM）的事后推断上报，默认关闭，需显式开启
 - **API性能监控** — 自动拦截 XMLHttpRequest / fetch 请求，采集耗时、状态码等指标
 - **JS错误捕获** — 自动捕获 JavaScript 运行时异常
 - **控制台错误监听** — 监听 `console.error` 输出
@@ -81,6 +82,7 @@ armsRum.init({
 | api | boolean \| object | `true` | API请求监控（XMLHttpRequest / fetch） |
 | jsError | boolean \| object | `true` | JavaScript运行时错误捕获 |
 | consoleError | boolean \| object | `true` | `console.error`监听 |
+| oom | boolean | `false` | OOM（iOS 看门狗终止推断）采集，仅 iOS 前台场景，需显式开启，详见[配置参考](docs/ReactNative%20SDK配置参考.md) |
 
 ### sessionConfig Session配置
 
@@ -427,7 +429,8 @@ 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` 时自动编译 |
+| **OOM 采集（iOS）** | TurboModule + KSCrash + 状态快照持久化 | 0.68 | 仅 iOS，默认关闭（`collectors.oom` 显式开启）；Android 为空实现 |
 | **JS 异常采集** | `ErrorUtils.setGlobalHandler` | 0.68 | 全版本可用 |
 | Hermes Promise rejection | `HermesInternal.enablePromiseRejectionTracker` | 0.70（推荐） | Hermes 为默认引擎时完整支持 |
 | JSC Promise rejection 兜底 | `globalThis.onunhandledrejection` | 0.68 | 非 Hermes 引擎有降级方案 |
@@ -447,4 +450,7 @@ SDK 的 peerDependencies 声明为 `react-native: >=0.68.0`，原生构建配置
 
 ## 相关文档
 
+- [接入ReactNative应用](docs/接入ReactNative应用.md)
+- [ReactNative SDK配置参考](docs/ReactNative%20SDK配置参考.md)
+- [SDK 版本说明](docs/SDK%20版本说明.md)
 - [ARMS用户体验监控文档](https://help.aliyun.com/zh/arms/user-experience-monitoring/)

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/android/src/main/java/com/rumsdkreactnative/RumSdkReactnativeModule.kt

@@ -422,6 +422,37 @@ class RumSdkReactnativeModule(reactContext: ReactApplicationContext) :
 
   // endregion
 
+  // region OOM (iOS-only watchdog termination, no-op on Android)
+
+  /**
+   * Android 无 OOM（看门狗终止推断）能力（D2）：Java OutOfMemoryError
+   * 已由 CrashHandler 崩溃链路捕获，系统低内存杀进程检测不在本期范围。
+   * 空实现仅为满足 TurboModule Spec 双端对齐。
+   */
+  override fun getPendingOomReports(promise: Promise) {
+    try {
+      promise.resolve("[]")
+    } catch (e: Throwable) {
+      promise.reject(ERR_CRASH, e)
+    }
+  }
+
+  /** 清除 OOM 报告文件：Android 无 OOM 文件，no-op */
+  override fun clearOomReports(oomIds: String, promise: Promise) {
+    try {
+      promise.resolve(null)
+    } catch (e: Throwable) {
+      promise.reject(ERR_CRASH, e)
+    }
+  }
+
+  /** 同步 JS 侧采集器配置（如 oom 开关）：Android 无 OOM 能力，接受但忽略 */
+  override fun updateCollectorsConfig(config: String) {
+    // no-op
+  }
+
+  // endregion
+
   // region Test Crash
 
   private external fun nativeTriggerCrash(type: Int)

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

@@ -104,6 +104,7 @@ Collector是RUM SDK用于收集React Native应用监控数据的最小单元。
 | api | boolean \| object | 监听API请求（XMLHttpRequest / fetch） | 否 | true |
 | jsError | boolean \| object | 监听JS错误 | 否 | true |
 | consoleError | boolean \| object | 监听Console错误 | 否 | true |
+| oom | boolean | OOM（iOS看门狗终止推断）采集，详细说明请参见[oom配置](#oom-配置) | 否 | false |
 
 ### 示例
 
@@ -131,6 +132,30 @@ armsRum.init({
 });
 ```
 
+## oom 配置
+
+iOS看门狗终止（Watchdog Termination / FOOM，前台 OOM）的事后推断采集。App在前台被系统看门狗终止时无任何信号可捕获，表现为无提示"闪退"，现有崩溃管线天然采集不到；开启本能力后，SDK在运行期持续持久化 App 状态快照，下次冷启动时用排除法推断上次是否发生看门狗终止，并通过标准 exception 事件链路上报（`type='crash'` + `subtype='oom'`，name 为 `WatchdogTermination`）。
+
+```typescript
+armsRum.init({
+  endpoint: '<your-endpoint>',
+  collectors: {
+    oom: true,
+  },
+});
+```
+
+**能力范围与限制**：
+
+- 仅支持 iOS，且仅覆盖**前台激活状态**被杀的推断（后台被杀不判定不上报）；Android 无此能力（Java `OutOfMemoryError` 已由崩溃采集链路捕获）
+- 启发式推断存在精度上限：无堆栈（`stack` 为空），`timestamp` 为估算值，事件通过 `snapshots.estimated: true` 结构化标记推断性质
+- 每次启动最多上报 1 条 OOM 事件；首次安装后被杀、调试器附加期间被杀、设备重启等场景不判定（业界同类能力同款排除条件）
+- 判定依据为上次会话持久化的状态快照，需重新构建原生 App（如 `expo run:ios` / `pod install` + 重新编译）后生效
+
+> **注意**：
+> - `oom` 默认为 `false`，需显式开启（`oom: true`）；其开关方向与崩溃采集相反（崩溃采集默认开启，配置 `crash: false` 才关闭）。
+> - 建议与崩溃采集同时开启（保持 `crash` 默认开启即可）。崩溃采集关闭时，原生崩溃监控仍会安装、KSCrash 崩溃报告照常写入但不会被读取和清理；残留的陈旧报告会使紧跟崩溃之后的 OOM 判定让位崩溃链路（防双报，预期行为），整体方向保守——OOM 倾向被抑制（漏判方向），而非误报增多。
+
 ## tracing 链路追踪配置
 
 支持布尔值开关或详细配置对象：

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

@@ -4,6 +4,20 @@
 
 ## 版本列表
 
+### v0.1.4（2026年09月）
+
+iOS 看门狗终止（OOM）推断采集与发布产物混淆修复。
+
+#### v0.1.4-beta.1（2026年09月23日）
+
+新增 iOS 看门狗终止（OOM）事后推断采集。
+
+- 新增 iOS OOM 采集，默认关闭需显式开启
+- 崩溃与 OOM 配置独立，判定互斥防双报
+- OOM 事件英文证据式表述，estimated 标记推断性质
+- 锁定 KSCrash 依赖版本
+- 修复发布流程，生产产物启用代码混淆压缩
+
 ### v0.1.3（2026年07月）
 
 原生崩溃采集安全加固与自监控系统集成。

package/ios/RumAppStateRecorder.h

@@ -0,0 +1,69 @@
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * RumAppStateRecorder
+ *
+ * iOS 看门狗终止（OOM）事后推断采集（P1 阶段，方案见
+ * dev-docs/OOM采集调研与实施方案.md 4.2 节）。负责：
+ *   - 运行期持久化 App 状态快照（app_state.json）：生命周期通知驱动、仅状态变化时写
+ *   - 下次启动时按 10 项排除条件判定上次是否发生看门狗终止（判定逻辑纯函数化，见下）
+ *   - 判定通过时构造 oom_{timestamp}_{uuid}.json 事件文件，交由 JS 侧回捞上报
+ *     （原生落盘、JS 回捞，保持 Ack 删文件链路的可靠性）
+ *
+ * 与 RumCrashReporter 的职责边界：RumCrashReporter 管信号/崩溃（KSCrash），
+ * 本类管状态记录与 OOM 推断，不使用信号处理器、不与 KSCrash 冲突。
+ * 判定逻辑（RumWatchdogTerminationLogic）与本类同文件实现。
+ */
+@interface RumAppStateRecorder : NSObject
+
+/**
+ * 安装 OOM 采集（幂等，dispatch_once 保证判定只执行一次）。
+ *
+ * 驱动方：RumSdkReactnative.updateCollectorsConfig——JS 侧 OomCollector 在
+ * SDK init 且 collectors.oom === true 时调用 updateCollectorsConfig("{\"oom\":true}")
+ * 触发；未开启时本方法不会被调用：不安装 Recorder、不执行判定、不产生
+ * 任何 OOM 相关 I/O（D6 默认关闭）。
+ *
+ * 上次会话是否开启由 app_state.json 的存在性隐式承载（上次未开启则无快照，
+ * 判定条件①不通过，不会误判），无需独立的开关持久化。
+ */
++ (void)setup;
+
+/** 获取待上报的 OOM 事件（已解析为字典数组，逐文件处理，不一次性全量读入拼接） */
++ (NSArray<NSDictionary *> *)pendingOomReports;
+
+/** 按 oomId 删除已上报的 OOM 事件文件 */
++ (void)clearOomReportsWithIds:(NSArray<NSString *> *)oomIds;
+
+/**
+ * 看门狗终止判定（纯函数化：输入上次快照 + 当前环境 + 崩溃证据，输出是否判定，
+ * 便于后续经桥伪造输入测试或 XCTest）。
+ *
+ * 10 项排除条件全部满足才判定（方案 4.2.2，D5/D7 硬约束）：
+ *   ① 存在上次快照；② 非模拟器；③ appVersion 未变；④ osVersion 未变；
+ *   ⑤ systemBootTime 未变；⑥ vendorId 一致且非空；⑦ 上次非调试态；
+ *   ⑧ 上次非正常终止；⑨ 上次前台激活（D5 前台限定）；
+ *   ⑩ 上次运行内无崩溃证据（crashed_last_run.flag 不存在 且 KSCrash reportStore
+ *      无晚于上次快照 updatedAt 的 pending 报告——时间范围限定排除陈旧报告，
+ *      D7 判定层互斥）。
+ *
+ * @param previousState      上次会话的 app_state.json 快照（不存在时传 nil）
+ * @param currentState       本次会话采集的当前环境快照
+ * @param flagExists         crashed_last_run.flag 是否存在
+ * @param hasPendingReports  上次运行内是否存在待处理崩溃报告（调用方对 KSCrash
+ *                           pending 报告施加时间范围限定后传入：仅最新报告时间戳
+ *                           晚于上次快照 updatedAt 时为 YES，陈旧报告不计入）
+ * @param isSimulator        是否运行在模拟器（生产路径由 TARGET_OS_SIMULATOR
+ *                           编译宏求值；参数化便于模拟器上运行的测试伪造真机分支）
+ */
++ (BOOL)evaluateWatchdogTerminationFromPreviousState:(nullable NSDictionary *)previousState
+                                         currentState:(NSDictionary *)currentState
+                                crashedLastRunFlagExists:(BOOL)flagExists
+                                   hasPendingCrashReports:(BOOL)hasPendingReports
+                                      runningOnSimulator:(BOOL)isSimulator;
+
+@end
+
+NS_ASSUME_NONNULL_END