mcpField
I
integration-swift

integration-swift

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

关于 integration-swift

此技能帮助 iOS 和 macOS 的 Swift 应用集成 PostHog 分析，提供分阶段流程及配置、依赖、用户识别和错误跟踪指导。

主要功能

  1. 01四阶段集成流程
  2. 02通过环境变量配置 PostHog
  3. 03Swift Package Manager 依赖指导
  4. 04macOS 沙盒网络设置指导
  5. 05用户识别与错误跟踪

适用场景

  1. 01为 iOS 或 macOS 应用添加 PostHog
  2. 02通过环境变量配置 PostHog 密钥
  3. 03在 Xcode 项目中添加 PostHog 包
  4. 04在应用流程中跟踪用户和错误

安装

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

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

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

包含的文件

除 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
ios.md

详细介绍

Swift（iOS/macOS）PostHog 集成

此技能可帮助你将 PostHog 分析功能添加到 Swift（iOS/macOS）应用程序中。

工作流

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

  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 - Swift（iOS/macOS）示例项目代码
  • references/ios.md - iOS - 文档
  • 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 代码。不要替换或重构现有代码。
  • 遵循示例：实现应尽可能贴合示例项目中的模式。

框架指南

  • 通过 PostHogEnv 枚举从环境变量读取配置。该枚举应包含一个 value 计算属性，调用 ProcessInfo.processInfo.environment[rawValue]，并在缺少变量时调用 fatalError。枚举项应为 projectToken = "POSTHOG_PROJECT_TOKEN" 和 host = "POSTHOG_HOST"，并在 Xcode scheme 的 Run 环境变量中设置。
  • 向 project.pbxproj 添加 SPM 依赖时，创建三个 UUID 各不相同的对象：PBXBuildFile（含 productRef）、XCSwiftPackageProductDependency（含 package 和 productName），以及 XCRemoteSwiftPackageReference（含 repositoryURL 和 requirement）。将构建文件加入 Frameworks 阶段的 files，将产品依赖加入目标的 packageProductDependencies，将包引用加入项目的 packageReferences。
  • 在 SPM 包引用中设置 minimumVersion 前，请先查看 https://github.com/PostHog/posthog-ios/releases 上 posthog-ios 的最新版本；不要硬编码过时版本。
  • 如果项目使用 App Sandbox（macOS），请在目标的构建设置中添加 ENABLE_OUTGOING_NETWORK_CONNECTIONS = YES，以便 PostHog 连接其服务器。请勿完全禁用沙盒。

识别用户

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

错误跟踪

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

评论

支持 Markdown