XuqmGroup-RNSDK/packages/bugcollect/README.md

# @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 与序列化流程。