# Error Tracking Android

> PostHog error tracking for Android apps.

PostHog error tracking for Android apps. Covers adding the Android SDK to build.gradle files, enabling exception autocapture in Application.onCreate(), manual captureException() calls, fingerprints, source map upload, alerts, and assigning issues. Use when adding or configuring PostHog error tracking, crash reporting, or exception capture in an Android project written in Kotlin or Java.

- Page: https://ss33.ai/skills/posthog/error-tracking-android-48459182042
- Publisher: posthog
- Category: [Software Development](https://ss33.ai/skills/category/software-development-t44z8z) › [Mobile apps](https://ss33.ai/skills/category/software-development-t44z8z/mobile-apps-p8puwc)
- License: MIT
- Source: https://github.com/posthog/skills/blob/4922922c4ca74db4e6705cecbced2a46fd103f27/skills/posthog/all/skills/error-tracking-android/SKILL.md

## Skill

SKILL.md: https://ss33.ai/api/v1/ss33/download/posthog/error-tracking-android-48459182042

# PostHog error tracking for Android

This skill helps you add PostHog error tracking to Android applications.

## Reference files

- `references/android.md` - Android error tracking installation - docs
- `references/fingerprints.md` - Fingerprints - docs
- `references/alerts.md` - Send error tracking alerts - docs
- `references/monitoring.md` - Monitor and search issues - docs
- `references/assigning-issues.md` - Assign issues to teammates - docs
- `references/upload-source-maps.md` - Upload source maps - docs

Consult the documentation for API details and framework-specific patterns.

## Key principles

- **Environment variables**: Always use environment variables for PostHog keys and host URLs. Never hardcode them.
- **Minimal changes**: Add error tracking alongside existing error handling. Don't replace or restructure existing error handling code.
- **Autocapture first**: Enable exception autocapture in the SDK initialization before adding manual captures.
- **Source maps**: Upload source maps so stack traces resolve to original source code, not minified bundles.
- **Manual capture for boundaries**: Use `captureException()` at error boundaries and catch blocks for errors that don't propagate to the global handler.

## Framework guidelines

- Adapt dependency configuration to the appropriate build.gradle(.kts) file according to the project gradle version
- Call `PostHogAndroid.setup()` only once in the Application class's `onCreate()` method, so it's initialized as early as possible and only once.
- Initialize PostHog in the Application class's `onCreate()` method
- Ensure every activity has a `android:label` to accurately track screen views.