Upload mappings for Android

CLI v0.7.4 or later

Install posthog-cli:

npm install -g @posthog/cli

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/PostHog/posthog/releases/latest/download/posthog-cli-installer.sh | sh
posthog-cli-update

To authenticate the CLI, call the login command. This opens your browser where you select your organization, project, and API scopes to grant:

posthog-cli login

If you are using the CLI in a CI/CD environment such as GitHub Actions, you can set environment variables to authenticate:

You can also use the --host option instead of the POSTHOG_CLI_HOST environment variable to target a different PostHog instance or region. For EU users:

posthog-cli --host https://eu.posthog.com [CMD]

AGP v8 or later

Automatic mappings uploading is handled through the Gradle build process on Android.

Install the PostHog Android Gradle Plugin on your app's build.gradle.kts file.

// Available through mavenCentral()
plugins {
    id("com.android.application")
    id("com.posthog.android") version "$version"
    ...
}

If you are running this in CI/CD, you can configure the CLI directly on the Gradle task instead of relying on POSTHOG_CLI_HOST, POSTHOG_CLI_PROJECT_ID, and POSTHOG_CLI_API_KEY environment variables:

import com.posthog.android.PostHogCliExecTask

tasks.withType<PostHogCliExecTask> {
    postHogHost = "https://eu.posthog.com"
    postHogProjectId = "my-project-id"
    postHogApiKey = "my-personal-api-key"
}

You can also set postHogExecutable if you want to use a custom posthog-cli path.