mcpField
I
integration-react-native

integration-react-native

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

关于 integration-react-native

此技能帮助 React Native 应用集成 PostHog 分析，提供分阶段流程，并说明依赖、配置、导航位置、用户识别和错误跟踪。

主要功能

  1. 01四阶段集成流程
  2. 02通过 react-native-config 配置环境变量
  3. 03SDK 与同级依赖指导
  4. 04PostHogProvider 放置位置指导
  5. 05用户识别与错误跟踪

适用场景

  1. 01为 React Native 应用添加 PostHog
  2. 02从 .env 加载 PostHog 设置
  3. 03在 React Navigation v7 中配置 PostHog
  4. 04在应用流程中跟踪用户和错误

安装

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

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

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

包含的文件

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

references/
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
react-native.md

详细介绍

React Native 的 PostHog 集成

此技能可帮助你在 React Native 应用中添加 PostHog 分析功能。

工作流

按顺序执行以下步骤，完成集成：

  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 - React Native 示例项目代码
  • references/react-native.md - React native - 文档
  • 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 代码。不要替换或重构现有代码。
  • 遵循示例：实现应尽可能贴近示例项目中的模式。

框架指南

  • 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 内部

识别用户

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

错误追踪

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

评论

支持 Markdown