mcpField
I
integration-android

integration-android

github.com/posthog数据与数据库7694 次安装今天更新
代码仓库

关于 integration-android

用于为 Android 应用添加 PostHog 分析功能的技能。它通过分阶段流程提供实现指导，并附有示例代码及初始化、用户识别和错误跟踪说明。

主要功能

  1. 01四步集成流程
  2. 02Android 示例与文档
  3. 03通过环境变量配置密钥
  4. 04用户识别与错误跟踪
  5. 05尽量少改动现有代码

适用场景

  1. 01为 Android 应用添加 PostHog
  2. 02在 Application 类中配置初始化
  3. 03在登录和注册时识别用户
  4. 04为关键流程添加错误跟踪

安装

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

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

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

包含的文件

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

references/
android.md
basic-integration-1.0-begin.md
basic-integration-1.1-edit.md
basic-integration-1.2-revise.md
basic-integration-1.3-conclude.md
EXAMPLE.md
identify-users.md

详细介绍

Android 版 PostHog 集成

此技能可帮助你将 PostHog 分析功能添加到 Android 应用中。

工作流

按顺序完成以下步骤以完成集成：

  1. basic-integration-1.0-begin.md - PostHog 设置 - 开始 ← 从这里开始
  2. basic-integration-1.1-edit.md - PostHog 设置 - 编辑
  3. basic-integration-1.2-revise.md - PostHog 设置 - 修订
  4. basic-integration-1.3-conclude.md - PostHog 设置 - 结尾

参考文件

  • references/EXAMPLE.md - Android 示例项目代码
  • references/android.md - Android - 文档
  • references/identify-users.md - 识别用户 - 文档
  • references/basic-integration-1.0-begin.md - PostHog 设置 - 开始
  • references/basic-integration-1.1-edit.md - PostHog 设置 - 编辑
  • references/basic-integration-1.2-revise.md - PostHog 设置 - 修订
  • references/basic-integration-1.3-conclude.md - PostHog 设置 - 结尾

示例项目展示了目标实现模式。请参考文档了解 API 详情。

核心原则

  • 环境变量：始终使用环境变量存储 PostHog 密钥。切勿将其硬编码。
  • 最小改动：在现有集成旁添加 PostHog 代码。不要替换或重构现有代码。
  • 遵循示例：实现应尽可能贴近示例项目中的模式。

框架指南

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

识别用户

在登录和注册事件期间识别用户。请参阅示例代码和文档，了解适用于此框架的正确识别模式。如果同时存在前端和后端代码，请通过 X-POSTHOG-DISTINCT-ID 和 X-POSTHOG-SESSION-ID 标头传递客户端会话和 distinct ID，以保持关联。

错误跟踪

在相关文件中添加 PostHog 错误跟踪，尤其是在关键用户流程和 API 边界附近。

评论

支持 Markdown