mcpField
I
integration-swift

integration-swift

github.com/posthogデータ・データベース76108 回インストール今日更新
リポジトリ

integration-swift について

iOS と macOS の Swift アプリに PostHog 分析を追加するスキルです。段階的な手順と、設定、依存関係、ユーザー識別、エラー追跡の指針を提供します。

主な機能

  1. 014段階の統合ワークフロー
  2. 02環境変数による PostHog 設定
  3. 03Swift Package Manager の依存関係ガイド
  4. 04macOS サンドボックスのネットワーク設定
  5. 05ユーザー識別とエラー追跡

活用シーン

  1. 01iOS または macOS アプリへの PostHog 追加
  2. 02環境変数による PostHog キー設定
  3. 03Xcode プロジェクトへの 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 インテグレーション

このスキルでは、Swift（iOS/macOS）アプリケーションに 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 - 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 enum と、その value 計算プロパティを介して環境変数から設定を読み取ってください。value は ProcessInfo.processInfo.environment[rawValue] を呼び出し、値がない場合は fatalError を発生させます。ケースは projectToken = "POSTHOG_PROJECT_TOKEN" と host = "POSTHOG_HOST" にし、Xcode スキームの Run 環境変数に設定してください。
  • project.pbxproj に SPM の依存関係を追加する場合は、一意の UUID を持つ3つのオブジェクトを作成してください。つまり、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）を使用している場合は、PostHog がサーバーに接続できるように、ターゲットのビルド設定に ENABLE_OUTGOING_NETWORK_CONNECTIONS = YES を追加してください。サンドボックス全体を無効にしないでください。

ユーザーの識別

ログインとサインアップのイベント時にユーザーを識別してください。このフレームワークで正しく識別する方法については、サンプルコードとドキュメントを参照してください。フロントエンドとバックエンドのコードが両方ある場合は、相関関係を維持するため、クライアント側のセッションと distinct ID を X-POSTHOG-DISTINCT-ID および X-POSTHOG-SESSION-ID ヘッダーで渡してください。

エラー追跡

関連するファイル、特に重要なユーザーフローや API の境界部分に、PostHog のエラー追跡を追加してください。

コメント

Markdown 対応