Sentry React Native 7.0.0-alpha.0 发布：性能监控与错误追踪的重大升级

Sentry React Native 是一个强大的错误监控和性能追踪工具，专门为 React Native 应用设计。它帮助开发者实时捕获应用中的错误、崩溃和性能问题，并提供详细的诊断信息。最新发布的 7.0.0-alpha.0 版本带来了多项重要改进和 API 变更，标志着该 SDK 的一个重要里程碑。

版本升级注意事项

从 6.x 升级到 7.0 版本时，开发者需要注意以下几点核心变化：

1. API 清理和重构：基于 Sentry JavaScript SDK 9.0 版本进行了大量 API 清理工作
2. 行为变更：部分功能的行为发生了变化，这些变化不会通过类型检查器或测试自动捕获
3. 兼容性：需要 Sentry 自托管版本 24.4.2 或更高版本支持

主要改进与修复

关键修复

• Expo 更新上下文处理：现在会在原生初始化后传递 Expo 更新上下文，确保崩溃报告中包含这些信息
• 网络请求追踪优化：默认避免重复追踪网络请求（fetch 和 xhr），提升了性能监控的准确性
• Expo 上下文标准化：所有 Expo 更新上下文值现在都统一为小写格式

重大变更

• IP 地址处理：当 sendDefaultPii 设置为 true 且 user.ip_address 未定义时，现在会自动设置为 {{auto}}
• 控制台异常处理：来自 captureConsoleIntegration 的异常现在默认标记为已处理（handled: true）
• 配置调整：shutdownTimeout 从核心模块移动到了 @sentry/react-native 模块
• 命名变更：hasTracingEnabled 重命名为 hasSpansEnabled，更准确地反映了其功能
• Span 处理：不再允许在 beforeSendSpan 钩子中丢弃 span 或返回 null

移除的功能与类型

7.0 版本移除了以下不再推荐使用的功能和类型：

• 废弃类型：TransactionNamingScheme、Request 和 Scope（推荐直接使用 Scope 类）
• 配置选项：
  • autoSessionTracking（改用 enableAutoSessionTracking）
  • enableTracing（通过设置 tracesSampleRate 来控制）
• 核心 API：移除了 getCurrentHub()、Hub 和 getCurrentHubShim()
• 传播上下文：移除了 spanId 字段
• 指标 API：完全移除了指标相关功能
• 工具包：移除了 @sentry/utils 包，相关功能已迁移到 @sentry/core

其他重要变更

• Scope 处理优化：当向 startSpanManual 或 startSpan 传递自定义 scope 时，现在会自动 fork 该 scope
• Web 支持增强：在 React Native Web 环境下，当 enableAutoSessionTracking 设置为 true 时，会自动添加 browserSessionIntegration
• 启动 span 描述简化：将 Cold/Warm App Start span 描述简化为 Cold/Warm Start，使报告更加简洁

依赖项更新

7.0.0-alpha.0 版本对多个核心依赖进行了升级：

• JavaScript SDK：从 v8.54.0 升级到 v9.12.0，带来了大量新功能和改进
• Android SDK：从 v7.20.1 升级到 v8.11.1，增强了 Android 平台的支持
• CLI 工具：从 v2.43.1 升级到 v2.45.0，改进了命令行功能
• 打包插件：从 v3.3.1 升级到 v3.4.0，优化了构建流程
• iOS SDK：从 v8.49.2 升级到 v8.50.0，提升了 iOS 平台的稳定性

升级建议

对于正在使用 Sentry React Native 6.x 版本的项目，建议：

1. 仔细阅读变更日志，了解所有 API 变更和行为变化
2. 在测试环境中先行验证 7.0.0-alpha.0 版本的兼容性
3. 重点关注移除的功能和变更的行为，确保应用逻辑不受影响
4. 利用这个预发布版本进行充分测试，为正式升级做好准备

这个版本为 React Native 应用带来了更稳定、更高效的错误监控和性能追踪能力，同时也为未来的功能扩展奠定了基础。