Intégration PostHog pour Swift (iOS/macOS)

Cette skill vous aide à ajouter PostHog analytics à des applications Swift (iOS/macOS).

Workflow

Suivez ces étapes dans l'ordre pour compléter l'intégration :

1. basic-integration-1.0-begin.md - PostHog Setup - Begin ← Commencez ici
2. basic-integration-1.1-edit.md - PostHog Setup - Edit
3. basic-integration-1.2-revise.md - PostHog Setup - Revise
4. basic-integration-1.3-conclude.md - PostHog Setup - Conclusion

Fichiers de référence

• references/EXAMPLE.md - Exemple de code de projet Swift (iOS/macOS)
• references/ios.md - Ios - docs
• references/identify-users.md - Identify users - docs
• references/basic-integration-1.0-begin.md - PostHog setup - begin
• references/basic-integration-1.1-edit.md - PostHog setup - edit
• references/basic-integration-1.2-revise.md - PostHog setup - revise
• references/basic-integration-1.3-conclude.md - PostHog setup - conclusion

Le projet exemple montre le pattern d'implémentation cible. Consultez la documentation pour les détails de l'API.

Principes clés

• Variables d'environnement : Toujours utiliser les variables d'environnement pour les clés PostHog. Ne jamais les hardcoder.
• Changements minimaux : Ajouter le code PostHog aux côtés des intégrations existantes. Ne pas remplacer ni restructurer le code existant.
• Correspondre à l'exemple : Votre implémentation doit suivre les patterns du projet exemple aussi fidèlement que possible.

Directives du framework

• Lire la configuration à partir des variables d'environnement via une énumération PostHogEnv avec une propriété calculée value qui appelle ProcessInfo.processInfo.environment[rawValue] et fatalError si absent — les cases doivent être projectToken = "POSTHOG_PROJECT_TOKEN" et host = "POSTHOG_HOST", définis dans les variables d'environnement Run du schéma Xcode
• Lors de l'ajout de dépendances SPM à project.pbxproj, créer trois objets distincts avec des UUIDs uniques — un PBXBuildFile (avec productRef), une XCSwiftPackageProductDependency (avec package et productName), et une XCRemoteSwiftPackageReference (avec repositoryURL et requirement). Le fichier build va dans la phase Frameworks files, la dépendance produit va dans les packageProductDependencies de la cible, et la référence package va dans les packageReferences du projet.
• Vérifier la dernière version de posthog-ios sur https://github.com/PostHog/posthog-ios/releases avant de définir la minimumVersion dans la référence package SPM — ne pas hardcoder une version obsolète
• Si le projet utilise App Sandbox (macOS), ajouter ENABLE_OUTGOING_NETWORK_CONNECTIONS = YES aux paramètres build de la cible pour que PostHog puisse atteindre ses serveurs — ne PAS désactiver le sandbox complètement

Identifier les utilisateurs

Identifier les utilisateurs lors des événements de connexion et d'inscription. Consultez le code exemple et la documentation pour le pattern identify correct pour ce framework. Si du code frontend et backend existe, passer la session côté client et l'ID distinct en utilisant les headers X-POSTHOG-DISTINCT-ID et X-POSTHOG-SESSION-ID pour maintenir la corrélation.

Suivi des erreurs

Ajouter le suivi des erreurs PostHog aux fichiers pertinents, particulièrement autour des flux utilisateur critiques et des limites d'API.