sentry-android-sdk

An opinionated, wizard-style guide for adding the full Sentry SDK to an Android application in either Kotlin or Java. It scans the project and walks through complete setup across Sentry's capabilities: error monitoring, crash reporting, ANR (application-not-responding) detection, native NDK crash tracking, tracing, profiling, session replay, and logging, so an app gets end-to-end observability. Documented versions reflect Sentry docs at the time of writing (io.sentry:sentry-android:8.33.0 and Gradle plugin 6.1.0), with a reminder to verify against the current Android platform docs before implementing. Work proceeds in three phases. Phase 1, Detect, runs a battery of shell commands to understand the project before recommending anything: build system and whether it uses the Groovy or Kotlin DSL, AGP version, presence of a Gradle version catalog (gradle/libs.versions.toml), Kotlin versus Java sources, minSdk and target SDK, and popular libraries that have dedicated integrations such as Jetpack Compose, OkHttp/Retrofit, Room/SQLite, Timber, Jetpack Navigation, and Apollo, plus any existing SentryAndroid.init() call and the Application subclass where init belongs. A decision table maps each finding to its impact, such as Session Replay requiring API 26 or higher, or Compose warranting sentry-compose-android. Phase 2, Recommend, leads with a concrete proposal rather than open-ended questions: Error Monitoring, Tracing, and Session Replay as always-on core coverage, with Profiling, Logging, and User Feedback offered as optional enhancements based on the app's profile. Phase 3, Guide, chooses a setup path (Gradle plugin, recommended, or manual init) and presents two options: running the interactive Sentry wizard, which the user must run themselves because it opens a browser for login and handles org/project selection, plugin setup, dependency installation, DSN configuration, and ProGuard/R8 mapping upload; or a manual setup that, when a version catalog is detected, adds Sentry to gradle/libs.versions.toml first and references it via libs.* in build files. Use it to install and configure Sentry for a Kotlin or Java Android app, from detection through feature configuration and verification.