mcpField
E
error-tracking-android

error-tracking-android

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

关于 error-tracking-android

用于在 Android 应用中接入 PostHog 错误跟踪的技能，涵盖异常自动捕获、错误边界的手动捕获、源码映射上传及 Android 初始化实践。

主要功能

  1. 01配置异常自动捕获
  2. 02在错误边界手动捕获
  3. 03上传源码映射
  4. 04Android SDK 初始化指导
  5. 05使用环境变量配置

适用场景

  1. 01为 Android 应用接入 PostHog 错误跟踪
  2. 02捕获全局处理器未处理的错误
  3. 03将堆栈跟踪还原到源代码

安装

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

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

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

包含的文件

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

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

详细介绍

Android 的 PostHog 错误跟踪

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

参考文件

  • references/android.md - Android 错误跟踪安装文档
  • 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()。

框架指南

  • 根据项目使用的 Gradle 版本，将依赖配置添加到相应的 build.gradle(.kts) 文件中
  • 仅在 Application 类的 onCreate() 方法中调用一次 PostHogAndroid.setup()，以尽早完成初始化，并确保只初始化一次。
  • 在 Application 类的 onCreate() 方法中初始化 PostHog。
  • 确保每个 activity 都有 android:label，以便准确跟踪屏幕浏览量。

评论

支持 Markdown