error-tracking-react-native

React Native 向け PostHog エラートラッキング

このスキルは、React Native アプリケーションに PostHog エラートラッキングを追加するのに役立ちます。

参照ファイル

• references/react-native.md - React Native エラートラッキングのインストール - ドキュメント
• references/fingerprints.md - フィンガープリント - ドキュメント
• references/alerts.md - エラートラッキングのアラートを送信 - ドキュメント
• references/monitoring.md - イシューを監視、検索 - ドキュメント
• references/assigning-issues.md - チームメイトにイシューを割り当て - ドキュメント
• references/upload-source-maps.md - ソースマップをアップロード - ドキュメント

API の詳細とフレームワーク固有のパターンについては、ドキュメントを参照してください。

主な原則

• 環境変数：PostHog のキーとホスト URL には、必ず環境変数を使用してください。ハードコードしないでください。
• 最小限の変更：既存のエラー処理にエラートラッキングを追加してください。既存のエラー処理コードを置き換えたり、再構成したりしないでください。
• 自動キャプチャを優先：手動キャプチャを追加する前に、SDK の初期化時に例外の自動キャプチャを有効にしてください。
• ソースマップ：スタックトレースが圧縮されたバンドルではなく、元のソースコードを参照するように、ソースマップをアップロードしてください。
• 境界での手動キャプチャ：グローバルハンドラーに伝播しないエラーについては、エラーバウンダリーや catch ブロックで captureException() を使用してください。

フレームワークのガイドライン

• posthog-react-native は React Native SDK パッケージ名です。
• react-native-config を使用して、.env から POSTHOG_PROJECT_TOKEN と POSTHOG_HOST を読み込んでください（変数は実行時ではなく、ビルド時に埋め込まれます）。
• react-native-svg は posthog-react-native の必須ピア依存関係です（アンケート機能で使用されます）。posthog-react-native と一緒にインストールする必要があります。
• React Navigation v7 との互換性を確保するため、PostHogProvider は NavigationContainer の内側に配置してください。