用途:这是一项 PostHog 集成技能,帮助开发者把 PostHog 分析接入 Expo 应用。工作流按顺序执行以下文件:basic-integration-1.0-begin.md(开始)、basic-integration-1.1-edit.md(编辑)、basic-integration-1.2-revise.md(修订)、basic-integration-1.3-conclude.md(收尾)。参考文件包括 references/EXAMPLE.md(Expo 示例项目代码)、references/react-native.md、references/identify-users.md 及上述四个集成步骤文件。
主要实践要点:始终用环境变量保存 PostHog 密钥,不得硬编码;改动尽量最小,在现有集成旁添加 PostHog 代码,不替换或重构原代码;实现应尽量贴近示例项目的模式。
Expo 相关指引:SDK 包名为 posthog-react-native;使用 expo-constants 配合 app.config.js 的 extras 传入 POSTHOG_PROJECT_TOKEN 与 POSTHOG_HOST(而非 react-native-config),在 posthog.ts 中通过 Constants.expoConfig?.extra?.posthogProjectToken 读取;使用 expo-router 时在 app/_layout.tsx 中包裹 PostHogProvider,并在 useEffect 中用 posthog.screen(pathname, params) 手动追踪屏幕。
用户识别与错误追踪:在登录和注册时识别用户;若同时有前后端代码,通过 X-POSTHOG-DISTINCT-ID 与 X-POSTHOG-SESSION-ID 头传递客户端会话和 distinct ID 以保持关联;在关键用户流程和 API 边界处添加错误追踪。
限制:资料未提供具体版本号、价格或平台限制等信息。