SuperAPI AI 工具集

sentry-react-native-sdk

前端与建站

查看项目

更新于 10-16 08:47

技能介绍

用途:面向 React Native 或 Expo 项目,提供 Sentry SDK 的完整接入向导,覆盖错误监控、追踪(tracing)、性能分析(profiling)、会话回放与日志。适用触发场景包括:为 RN/Expo 应用添加 Sentry、安装 @sentry/react-native、监控原生崩溃、ANR、应用卡顿等。

主要能力:先通过命令扫描项目,判断是 Expo managed/bare 还是原生 RN、Expo SDK 是否 ≥50、是否已有 Sentry、所用导航库(@react-navigation/native 或 react-native-navigation)、状态管理、Hermes、Expo Router 及后端目录。随后给出分级建议:错误监控与追踪为始终推荐;会话回放、性能分析、日志、用户反馈按需选配。

使用方式:首选向导命令 npx @sentry/wizard@latest -i reactNative,可自动完成登录、组织/项目选择、SDK 安装、原生配置、source map 上传和 Sentry.init()。手动接入分三条路径:Expo Managed(SDK 50+)、Expo bare、原生 RN(0.69+)。Expo 需在 metro.config.js 使用 getSentryExpoConfig,在 app.json 加入 @sentry/react-native/expo 插件,初始化时用 Sentry.wrap 包裹根组件;Expo Router 项目将 init 放在 _layout.tsx。原生 RN 需改 Xcode 构建阶段、添加 dSYM 上传、配置 ios/sentry.properties 与 android/sentry.properties,并在 android/app/build.gradle 引入 sentry.gradle.kts。

限制:需自行运行向导,因其需交互登录;SDK 版本与 API 需以 docs.sentry.io/platforms/react-native/ 为准;Expo SDK <50 使用旧版 sentry-expo;Expo Router 的 per-route ErrorBoundary 默认吞掉渲染错误,需用 autoWrapExpoRouterErrorBoundary 或手动 wrapExpoRouterErrorBoundary 捕获。SENTRY_AUTH_TOKEN 不得提交到版本库。具体收费、价格与平台信息暂未提供。