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

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.3"};
+const _pkg = {"version":"0.1.3-beta.4"};
 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.3"};
+const _pkg = {"version":"0.1.3-beta.4"};
 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.3",
+  "version": "0.1.3-beta.4",
   "description": "RUM SDK For ReactNative",
   "homepage": "https://help.aliyun.com/zh/arms/user-experience-monitoring/",
   "main": "./lib/commonjs/index.js",
@@ -21,6 +21,7 @@
   },
   "files": [
     "lib",
+    "src/NativeRumSdkReactnative.ts",
     "android",
     "ios",
     "docs",
@@ -107,7 +108,7 @@
     "typescript": "^5.8.3"
   },
   "peerDependencies": {
-    "@arms/rum-core": ">=0.1.4",
+    "@arms/rum-core": "0.1.7",
     "react": "*",
     "react-native": ">=0.68.0"
   },

package/src/NativeRumSdkReactnative.ts

@@ -0,0 +1,107 @@
+import type { TurboModule } from 'react-native';
+import { NativeModules, TurboModuleRegistry } from 'react-native';
+
+/**
+ * 原生设备信息，对应存储模型中的公共属性：
+ * - device.* （id / type / brand / model / name）
+ * - os.*     （type / version / container / container_version）
+ * - app.package
+ * - viewport.width / viewport.height
+ */
+export interface NativeDeviceInfo {
+  device_id?: string;
+  device_type?: string;
+  device_brand?: string;
+  device_model?: string;
+  device_name?: string;
+  os_type?: string;
+  os_version?: string;
+  app_package?: string;
+  app_version?: string;
+  viewport_width?: number;
+  viewport_height?: number;
+}
+
+export interface Spec extends TurboModule {
+  getItem(key: string): Promise<string | null>;
+  setItem(key: string, value: string): Promise<void>;
+  removeItem(key: string): Promise<void>;
+  clear(): Promise<void>;
+  getAllKeys(): Promise<string[]>;
+
+  /**
+   * 采集原生平台设备信息，仅在初始化时调用一次。
+   */
+  getDeviceInfo(): Promise<NativeDeviceInfo>;
+
+  // === 崩溃采集相关 ===
+
+  /** 获取待上报的崩溃报告列表（下次启动时调用） */
+  getPendingCrashes(): Promise<string>;
+
+  /** 清除已上报的崩溃文件 */
+  clearCrashReports(crashIds: string): Promise<void>;
+
+  /** 清除所有崩溃报告文件（用于清理无 crash_id 的旧版文件） */
+  clearAllCrashReports(): Promise<void>;
+
+  /** 清理过期和超限的崩溃文件（maxFiles 上限，maxAgeMs 过期时间） */
+  cleanupOldCrashes(maxFiles: number, maxAgeMs: number): Promise<void>;
+
+  /** 查询上次运行是否发生过崩溃 */
+  crashedLastRun(): Promise<boolean>;
+
+  /** 更新崩溃上下文快照（session/view 变更时调用） */
+  updateCrashContext(context: string): void;
+
+  /** 触发测试崩溃（仅用于开发调试，调用后 App 立即崩溃） */
+  triggerTestCrash(crashType: string): void;
+}
+
+/**
+ * 获取原生模块。
+ *
+ * 优先使用 TurboModuleRegistry（RN 0.68+ TurboModule 架构），
+ * 若未找到则降级到 Legacy Bridge 的 NativeModules（RN 0.68-0.70 未开启 New Arch 时），
+ * 若均不可用则返回一组空实现兜底。
+ *
+ * 使用非强制的 `TurboModuleRegistry.get`（而非 `getEnforcing`），避免在原生
+ * 二进制未注册该模块时于「模块加载阶段」直接抛异常——那会连锁导致整个 JS
+ * bundle 评估失败（表现为所有路由丢失 default export、App 白屏）。
+ *
+ * 当原生模块缺失时（通常是新增原生代码后未重新编译原生 App，只重跑了 Metro），
+ * 返回一组空实现兜底：崩溃采集与原生设备信息降级为不可用，但 PV / 行为 / API /
+ * JS 异常等纯 JS 能力不受影响。需重新构建原生工程（如 `expo run:ios` /
+ * `pod install` + 重新编译）后崩溃采集才会真正生效。
+ */
+const nativeModule =
+  TurboModuleRegistry.get<Spec>('RumSdkReactnative') ??
+  (NativeModules.RumSdkReactnative as Spec | undefined);
+
+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.'
+  );
+}
+
+/** 原生模块缺失时的空实现，保证调用方不会因缺方法而抛错。 */
+const fallback: Spec = {
+  getItem: async () => null,
+  setItem: async () => {},
+  removeItem: async () => {},
+  clear: async () => {},
+  getAllKeys: async () => [],
+  getDeviceInfo: async () => ({}),
+  getPendingCrashes: async () => '[]',
+  clearCrashReports: async () => {},
+  clearAllCrashReports: async () => {},
+  cleanupOldCrashes: async () => {},
+  crashedLastRun: async () => false,
+  updateCrashContext: () => {},
+  triggerTestCrash: () => {},
+};
+
+export default nativeModule ?? fallback;