# @xuqm/rn-bugcollect JS 错误、业务日志、API 异常和漏斗采集模块。它依赖 `@xuqm/rn-common` 获取远程配置和当前会话,不提供独立初始化或登录入口。 ## 安装 ```bash pnpm add @xuqm/rn-common @xuqm/rn-bugcollect \ @react-native-async-storage/async-storage ``` ## 使用 ```ts import { BugCollect } from '@xuqm/rn-bugcollect' BugCollect.setEnvironment(__DEV__ ? 'development' : 'production') BugCollect.event('page_view', { page: 'home' }) try { // business } catch (error) { BugCollect.captureError(error) } ``` 初始化只由 common 自动完成,登录只由 `XuqmSDK.login()` 完成。配置中启用 bugcollect 后,SDK 在共享初始化完成时自动执行一次 `startCapture()`;手工调用仍然幂等,但正常集成不需要调用。`BugCollect.flush()` 可在 App 转入后台前主动刷新队列。 错误指纹使用 common 的统一 SHA-256 实现,事件里的 SDK 版本直接读取当前发布包版本,不再维护第二份硬编码版本号。 SourceMap 上传使用独立打包后处理流程;不要再叠加基于 Metro `customSerializer` 的旧插件方案,以免破坏新版 Metro 的 exports 与序列化流程。