mcpField
E
error-tracking-react-native

error-tracking-react-native

github.com/posthog开发76102 次安装今天更新
代码仓库

关于 error-tracking-react-native

用于在 React Native 应用中添加 PostHog 错误跟踪的技能，涵盖 SDK 配置、异常捕获和源码映射上传等实践。

主要功能

  1. 01React Native SDK 配置指南
  2. 02异常自动捕获与手动捕获
  3. 03源码映射上传指南
  4. 04问题监控与告警
  5. 05环境变量配置

适用场景

  1. 01为 React Native 应用添加 PostHog 跟踪
  2. 02捕获全局处理器未捕获的错误
  3. 03将堆栈跟踪还原到原始源码
  4. 04监控问题并通知团队

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/posthog/skills --skill error-tracking-react-native

安装后在 Claude Code 中输入/error-tracking-react-native确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
alerts.md
assigning-issues.md
fingerprints.md
monitoring.md
react-native.md
upload-source-maps.md

详细介绍

React Native 的 PostHog 错误跟踪

此技能可帮助你为 React Native 应用添加 PostHog 错误跟踪。

参考文件

  • references/react-native.md - React Native 错误跟踪安装文档
  • references/fingerprints.md - Fingerprints 文档
  • references/alerts.md - 发送错误跟踪警报文档
  • references/monitoring.md - 监控和搜索问题文档
  • references/assigning-issues.md - 将问题分配给队友的文档
  • references/upload-source-maps.md - 上传源映射文档

请查阅文档，了解 API 详情和特定框架的使用模式。

核心原则

  • 环境变量：始终使用环境变量配置 PostHog 密钥和主机 URL。切勿将它们硬编码。
  • 最小化改动：在现有错误处理旁添加错误跟踪。不要替换或重构现有错误处理代码。
  • 优先启用自动捕获：在添加手动捕获之前，先在 SDK 初始化时启用异常自动捕获。
  • 源映射：上传源映射，使堆栈跟踪能对应到原始源代码，而不是压缩后的代码包。
  • 在边界处手动捕获：对于不会传递到全局处理器的错误，在错误边界和 catch 代码块中使用 captureException()。

框架指南

  • posthog-react-native 是 React Native SDK 的包名
  • 使用 react-native-config 从 .env 加载 POSTHOG_PROJECT_TOKEN 和 POSTHOG_HOST（这些变量在构建时嵌入，而不是在运行时）
  • react-native-svg 是 posthog-react-native 的必需对等依赖（供 surveys 功能使用），必须与其一同安装
  • 为兼容 React Navigation v7，请将 PostHogProvider 放在 NavigationContainer 内部

评论

支持 Markdown