error-tracking-android

Android 向け PostHog エラートラッキング

このスキルは、Android アプリケーションに PostHog エラートラッキングを追加する方法を説明します。

参考ファイル

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

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

主な原則

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

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

• プロジェクトの Gradle バージョンに応じて、依存関係の設定を適切な build.gradle(.kts) ファイルに合わせてください。
• PostHogAndroid.setup() は、できるだけ早く、かつ一度だけ初期化されるよう、Application クラスの onCreate() メソッド内で一度だけ呼び出してください。
• Application クラスの onCreate() メソッド内で PostHog を初期化してください。
• 画面ビューを正確に追跡できるよう、すべてのアクティビティに android:label が設定されていることを確認してください。