[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DPXKG5YA1RTX65FENPXR6H":3,"skill-same:01M7DPXKG5YA1RTX65FENPXR6H":81},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":33,"install":34,"resources":46},"01M7DPXKG5YA1RTX65FENPXR6H","sentry-android-sdk",null,"Full Sentry SDK setup for Android. Use when asked to \"add Sentry to Android\", \"install sentry-android\", \"setup Sentry in Android\", or configure error monitoring, tracing, profiling, session replay, or logging for Android applications. Supports Kotlin and Java codebases.","Hazek-dc\u002FPresensiGuru_FaceNet_EMAR","Hazek-dc","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F75208960?v=4","01M7DEQV5B4YGS86A81DYH81DR","Hazek","01M7DEQV5XP4TM0C6NTHXCXCHR",1,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-android-sdk\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: sentry-android-sdk\ndescription: Full Sentry SDK setup for Android. Use when asked to \"add Sentry to Android\", \"install sentry-android\", \"setup Sentry in Android\", or configure error monitoring, tracing, profiling, session replay, or logging for Android applications. Supports Kotlin and Java codebases.\nlicense: Apache-2.0\ncategory: sdk-setup\nparent: sentry-sdk-setup\ndisable-model-invocation: true\n---\n\n> [All Skills](..\u002F..\u002FSKILL_TREE.md) > [SDK Setup](..\u002Fsentry-sdk-setup\u002FSKILL.md) > Android SDK\n\n# Sentry Android SDK\n\nOpinionated wizard that scans your Android project and guides you through complete Sentry setup — error monitoring, tracing, profiling, session replay, logging, and more.\n\n## Invoke This Skill When\n\n- User asks to \"add Sentry to Android\" or \"set up Sentry\" in an Android app\n- User wants error monitoring, crash reporting, ANR detection, tracing, profiling, session replay, or logging in Android\n- User mentions `sentry-android`, `io.sentry:sentry-android`, mobile crash tracking, or Sentry for Kotlin\u002FJava Android\n- User wants to monitor native (NDK) crashes, application not responding (ANR) events, or app startup performance\n\n> **Note:** SDK versions and APIs below reflect current Sentry docs at time of writing (`io.sentry:sentry-android:8.33.0`, Gradle plugin `6.1.0`).\n> Always verify against [docs.sentry.io\u002Fplatforms\u002Fandroid\u002F](https:\u002F\u002Fdocs.sentry.io\u002Fplatforms\u002Fandroid\u002F) before implementing.\n\n---\n\n## Phase 1: Detect\n\nRun these commands to understand the project before making any recommendations:\n\n```bash\n# Detect project structure and build system\nls build.gradle build.gradle.kts settings.gradle settings.gradle.kts 2>\u002Fdev\u002Fnull\n\n# Check AGP version and existing Sentry\ngrep -r '\"com.android.application\"' build.gradle* app\u002Fbuild.gradle* 2>\u002Fdev\u002Fnull | head -3\ngrep -ri sentry build.gradle* app\u002Fbuild.gradle* 2>\u002Fdev\u002Fnull | head -10\n\n# Check app-level build file (Groovy vs KTS)\nls app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull\n\n# Detect Gradle version catalog (libs.versions.toml) — modern AGP projects\nls gradle\u002Flibs.versions.toml 2>\u002Fdev\u002Fnull\n\n# Check for existing Sentry entries in the version catalog\ngrep -iE 'sentry|io\\.sentry' gradle\u002Flibs.versions.toml 2>\u002Fdev\u002Fnull | head -10\n\n# Check if build files reference the catalog (alias\u002Flibs.* usage)\ngrep -E 'alias\\(libs\\.|libs\\.[a-zA-Z]' build.gradle build.gradle.kts app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -5\n\n# Detect Kotlin vs Java\nfind app\u002Fsrc\u002Fmain -name \"*.kt\" 2>\u002Fdev\u002Fnull | head -3\nfind app\u002Fsrc\u002Fmain -name \"*.java\" 2>\u002Fdev\u002Fnull | head -3\n\n# Check minSdk, targetSdk\ngrep -E 'minSdk|targetSdk|compileSdk|minSdkVersion|targetSdkVersion' app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -6\n\n# Detect Jetpack Compose\ngrep -E 'compose|androidx.compose' app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -5\n\n# Detect OkHttp (popular HTTP client — has dedicated integration)\ngrep -E 'okhttp|retrofit' app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -3\n\n# Detect Room or SQLite\ngrep -E 'androidx.room|androidx.sqlite' app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -3\n\n# Detect Timber (logging library)\ngrep -E 'timber' app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -3\n\n# Detect Jetpack Navigation\ngrep -E 'androidx.navigation' app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -3\n\n# Detect Apollo (GraphQL)\ngrep -E 'apollo' app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -3\n\n# Check existing Sentry initialization\ngrep -r \"SentryAndroid.init\\|io.sentry.Sentry\" app\u002Fsrc\u002F 2>\u002Fdev\u002Fnull | head -5\n\n# Check Application class\nfind app\u002Fsrc\u002Fmain -name \"*.kt\" -o -name \"*.java\" 2>\u002Fdev\u002Fnull | xargs grep -l \"Application()\" 2>\u002Fdev\u002Fnull | head -3\n\n# Adjacent backend (for cross-linking)\nls ..\u002Fbackend ..\u002Fserver ..\u002Fapi 2>\u002Fdev\u002Fnull\nfind .. -maxdepth 2 \\( -name \"go.mod\" -o -name \"requirements.txt\" -o -name \"Gemfile\" \\) 2>\u002Fdev\u002Fnull | grep -v node_modules | head -5\n```\n\n**What to determine:**\n\n| Question | Impact |\n|----------|--------|\n| `build.gradle.kts` present? | Use Kotlin DSL syntax in all examples |\n| `gradle\u002Flibs.versions.toml` present? | Add Sentry to the version catalog; reference via `libs.*` in build files |\n| Catalog already has `sentry` entries? | Reuse the existing version ref; don't duplicate or hardcode versions |\n| `minSdk \u003C 26`? | Note Session Replay requires API 26+ — silent no-op below that |\n| Compose detected? | Recommend `sentry-compose-android` and Compose-specific masking |\n| OkHttp present? | Recommend `sentry-okhttp` interceptor or Gradle plugin bytecode auto-instrumentation |\n| Room\u002FSQLite present? | Recommend `sentry-android-sqlite` or plugin bytecode instrumentation |\n| Timber present? | Recommend `sentry-android-timber` integration |\n| Jetpack Navigation? | Recommend `sentry-android-navigation` for screen tracking |\n| Already has `SentryAndroid.init()`? | Skip install, jump to feature config |\n| Application subclass exists? | That's where `SentryAndroid.init()` goes |\n\n---\n\n## Phase 2: Recommend\n\nPresent a concrete recommendation based on what you found. Don't ask open-ended questions — lead with a proposal:\n\n**Recommended (core coverage — always set up these):**\n- ✅ **Error Monitoring** — captures uncaught exceptions, ANRs, and native NDK crashes automatically\n- ✅ **Tracing** — auto-instruments Activity lifecycle, app start, HTTP requests, and database queries\n- ✅ **Session Replay** — records screen captures and user interactions for debugging (API 26+)\n\n**Optional (enhanced observability):**\n- ⚡ **Profiling** — continuous UI profiling (recommended) or transaction-based sampling\n- ⚡ **Logging** — structured logs via `Sentry.logger()`, with optional Timber bridge\n- ⚡ **User Feedback** — collect user-submitted bug reports from inside the app\n\n**Recommendation logic:**\n\n| Feature | Recommend when... |\n|---------|------------------|\n| Error Monitoring | **Always** — non-negotiable baseline for any Android app |\n| Tracing | **Always for Android** — app start time, Activity lifecycle, network latency matter |\n| Session Replay | User-facing production app on API 26+; visual debugging of user issues |\n| Profiling | Performance-sensitive apps, startup time investigations, production perf analysis |\n| Logging | App uses structured logging or you want log-to-trace correlation in Sentry |\n| User Feedback | Beta or customer-facing app where you want user-submitted bug reports |\n\nPropose: *\"For your [Kotlin \u002F Java] Android app (minSdk X), I recommend setting up Error Monitoring + Tracing + Session Replay. Want me to also add Profiling and Logging?\"*\n\n---\n\n## Phase 3: Guide\n\n### Determine Your Setup Path\n\n| Project type | Recommended setup | Complexity |\n|-------------|------------------|------------|\n| New project, no existing Sentry | Gradle plugin (recommended) | Low — plugin handles most config |\n| Existing project, no Sentry | Gradle plugin or manual init | Medium — add dependency + Application class |\n| Manual full control | `SentryAndroid.init()` in Application | Medium — explicit config, most flexible |\n\n### Option 1: Wizard (Recommended)\n\n> **You need to run this yourself** — the wizard opens a browser for login\n> and requires interactive input that the agent can't handle.\n> Copy-paste into your terminal:\n>\n> ```\n> npx @sentry\u002Fwizard@latest -i android\n> ```\n>\n> It handles login, org\u002Fproject selection, Gradle plugin setup, dependency\n> installation, DSN configuration, and ProGuard\u002FR8 mapping upload.\n>\n> **Once it finishes, come back and skip to [Verification](#verification).**\n\nIf the user skips the wizard, proceed with Option 2 (Manual Setup) below.\n\n---\n\n### Option 2: Manual Setup\n\n#### Using a Gradle Version Catalog (`gradle\u002Flibs.versions.toml`)\n\nIf Phase 1 detected `gradle\u002Flibs.versions.toml`, add Sentry to the catalog **first**, then reference it from your build files. This keeps versions centralized and matches modern AGP project conventions.\n\n**Step 1 — Add entries to `gradle\u002Flibs.versions.toml`**\n\n```toml\n[versions]\nsentry = \"8.33.0\"\nsentryGradlePlugin = \"6.1.0\"\n\n[libraries]\nsentry-android = { module = \"io.sentry:sentry-android\", version.ref = \"sentry\" }\nsentry-bom = { module = \"io.sentry:sentry-bom\", version.ref = \"sentry\" }\n# Optional integrations — add only the ones your project uses:\nsentry-android-timber = { module = \"io.sentry:sentry-android-timber\" }\nsentry-android-fragment = { module = \"io.sentry:sentry-android-fragment\" }\nsentry-compose-android = { module = \"io.sentry:sentry-compose-android\" }\nsentry-android-navigation = { module = \"io.sentry:sentry-android-navigation\" }\nsentry-okhttp = { module = \"io.sentry:sentry-okhttp\" }\nsentry-android-sqlite = { module = \"io.sentry:sentry-android-sqlite\" }\nsentry-kotlin-extensions = { module = \"io.sentry:sentry-kotlin-extensions\" }\n\n[plugins]\nsentry-android-gradle = { id = \"io.sentry.android.gradle\", version.ref = \"sentryGradlePlugin\" }\n```\n\n> **Note:** Optional integration entries omit `version.ref` — their versions come from the BOM at resolution time. Only `sentry-bom` needs the version ref.\n> If the catalog already defines a `sentry` version, reuse it instead of adding a duplicate entry.\n\n**Step 2 — Reference the catalog from `build.gradle[.kts]`**\n\nProject-level `build.gradle.kts`:\n```kotlin\nplugins {\n    alias(libs.plugins.sentry.android.gradle) apply false\n}\n```\n\nApp-level `app\u002Fbuild.gradle.kts`:\n```kotlin\nplugins {\n    id(\"com.android.application\")\n    alias(libs.plugins.sentry.android.gradle)\n}\n\ndependencies {\n    implementation(platform(libs.sentry.bom))\n    implementation(libs.sentry.android)\n    \u002F\u002F implementation(libs.sentry.okhttp)\n    \u002F\u002F implementation(libs.sentry.compose.android)\n}\n```\n\nGroovy DSL (`app\u002Fbuild.gradle`) equivalent:\n```groovy\nplugins {\n    id \"com.android.application\"\n    alias libs.plugins.sentry.android.gradle\n}\n\ndependencies {\n    implementation platform(libs.sentry.bom)\n    implementation libs.sentry.android\n}\n```\n\nThen continue with the `sentry {}` configuration block from Path A, Step 2 below. The rest of the setup (Application class init, manifest registration, verification) is identical.\n\n---\n\n#### Path A: Gradle Plugin (Recommended)\n\nThe Sentry Gradle plugin is the easiest setup path. It:\n- Uploads ProGuard\u002FR8 mapping files automatically on release builds\n- Injects source context into stack frames\n- Optionally instruments OkHttp, Room\u002FSQLite, File I\u002FO, Compose navigation, and `android.util.Log` via bytecode transforms (zero source changes)\n\n**Step 1 — Add the plugin to `build.gradle[.kts]` (project-level)**\n\nGroovy DSL (`build.gradle`):\n```groovy\nplugins {\n    id \"io.sentry.android.gradle\" version \"6.1.0\" apply false\n}\n```\n\nKotlin DSL (`build.gradle.kts`):\n```kotlin\nplugins {\n    id(\"io.sentry.android.gradle\") version \"6.1.0\" apply false\n}\n```\n\n**Step 2 — Apply plugin + add dependencies in `app\u002Fbuild.gradle[.kts]`**\n\nGroovy DSL:\n```groovy\nplugins {\n    id \"com.android.application\"\n    id \"io.sentry.android.gradle\"\n}\n\nandroid {\n    \u002F\u002F ...\n}\n\ndependencies {\n    \u002F\u002F Use BOM for consistent versions across sentry modules\n    implementation platform(\"io.sentry:sentry-bom:8.33.0\")\n    implementation \"io.sentry:sentry-android\"\n\n    \u002F\u002F Optional integrations (add what's relevant):\n    \u002F\u002F implementation \"io.sentry:sentry-android-timber\"     \u002F\u002F Timber bridge\n    \u002F\u002F implementation \"io.sentry:sentry-android-fragment\"   \u002F\u002F Fragment lifecycle tracing\n    \u002F\u002F implementation \"io.sentry:sentry-compose-android\"    \u002F\u002F Jetpack Compose support\n    \u002F\u002F implementation \"io.sentry:sentry-android-navigation\"  \u002F\u002F Jetpack Navigation\n    \u002F\u002F implementation \"io.sentry:sentry-okhttp\"             \u002F\u002F OkHttp interceptor\n    \u002F\u002F implementation \"io.sentry:sentry-android-sqlite\"     \u002F\u002F Room\u002FSQLite tracing\n    \u002F\u002F implementation \"io.sentry:sentry-kotlin-extensions\"  \u002F\u002F Coroutine context propagation\n}\n\nsentry {\n    org = \"YOUR_ORG_SLUG\"\n    projectName = \"YOUR_PROJECT_SLUG\"\n    authToken = System.getenv(\"SENTRY_AUTH_TOKEN\")\n\n    \u002F\u002F Enable auto-instrumentation via bytecode transforms (no source changes needed)\n    tracingInstrumentation {\n        enabled = true\n        features = [InstrumentationFeature.DATABASE, InstrumentationFeature.FILE_IO,\n                    InstrumentationFeature.OKHTTP, InstrumentationFeature.COMPOSE]\n    }\n\n    \u002F\u002F Upload ProGuard mapping and source context on release\n    autoUploadProguardMapping = true\n    includeSourceContext = true\n}\n```\n\nKotlin DSL (`app\u002Fbuild.gradle.kts`):\n```kotlin\nplugins {\n    id(\"com.android.application\")\n    id(\"io.sentry.android.gradle\")\n}\n\ndependencies {\n    implementation(platform(\"io.sentry:sentry-bom:8.33.0\"))\n    implementation(\"io.sentry:sentry-android\")\n\n    \u002F\u002F Optional integrations:\n    \u002F\u002F implementation(\"io.sentry:sentry-android-timber\")\n    \u002F\u002F implementation(\"io.sentry:sentry-android-fragment\")\n    \u002F\u002F implementation(\"io.sentry:sentry-compose-android\")\n    \u002F\u002F implementation(\"io.sentry:sentry-android-navigation\")\n    \u002F\u002F implementation(\"io.sentry:sentry-okhttp\")\n    \u002F\u002F implementation(\"io.sentry:sentry-android-sqlite\")\n    \u002F\u002F implementation(\"io.sentry:sentry-kotlin-extensions\")\n}\n\nsentry {\n    org = \"YOUR_ORG_SLUG\"\n    projectName = \"YOUR_PROJECT_SLUG\"\n    authToken = System.getenv(\"SENTRY_AUTH_TOKEN\")\n\n    tracingInstrumentation {\n        enabled = true\n        features = setOf(\n            InstrumentationFeature.DATABASE,\n            InstrumentationFeature.FILE_IO,\n            InstrumentationFeature.OKHTTP,\n            InstrumentationFeature.COMPOSE,\n        )\n    }\n\n    autoUploadProguardMapping = true\n    includeSourceContext = true\n}\n```\n\n**Step 3 — Initialize Sentry in your Application class**\n\nIf you don't have an Application subclass, create one:\n\n```kotlin\n\u002F\u002F MyApplication.kt\nimport android.app.Application\nimport io.sentry.SentryLevel\nimport io.sentry.android.core.SentryAndroid\nimport io.sentry.android.replay.SentryReplayOptions\n\nclass MyApplication : Application() {\n    override fun onCreate() {\n        super.onCreate()\n\n        SentryAndroid.init(this) { options ->\n            options.dsn = \"YOUR_SENTRY_DSN\"\n\n            \u002F\u002F Tracing — lower to 0.1–0.2 in high-traffic production\n            options.tracesSampleRate = 1.0\n\n            \u002F\u002F Profiling — use continuous UI profiling (recommended, SDK ≥ 8.7.0)\n            options.profileSessionSampleRate = 1.0\n\n            \u002F\u002F Session Replay (API 26+ only; silent no-op below API 26)\n            options.sessionReplay.sessionSampleRate = 0.1    \u002F\u002F 10% of all sessions\n            options.sessionReplay.onErrorSampleRate = 1.0    \u002F\u002F 100% on error\n\n            \u002F\u002F Structured logging\n            options.logs.isEnabled = true\n\n            \u002F\u002F Environment\n            options.environment = BuildConfig.BUILD_TYPE\n        }\n    }\n}\n```\n\nJava equivalent:\n```java\n\u002F\u002F MyApplication.java\nimport android.app.Application;\nimport io.sentry.android.core.SentryAndroid;\n\npublic class MyApplication extends Application {\n    @Override\n    public void onCreate() {\n        super.onCreate();\n\n        SentryAndroid.init(this, options -> {\n            options.setDsn(\"YOUR_SENTRY_DSN\");\n            options.setTracesSampleRate(1.0);\n            options.setProfileSessionSampleRate(1.0);\n            options.getSessionReplay().setSessionSampleRate(0.1);\n            options.getSessionReplay().setOnErrorSampleRate(1.0);\n            options.getLogs().setEnabled(true);\n            options.setEnvironment(BuildConfig.BUILD_TYPE);\n        });\n    }\n}\n```\n\n**Step 4 — Register Application in `AndroidManifest.xml`**\n\n```xml\n\u003Capplication\n    android:name=\".MyApplication\"\n    ... >\n```\n\n---\n\n#### Path B: Manual Setup (No Gradle Plugin)\n\nUse this if you can't use the Gradle plugin (e.g., non-standard build setups).\n\n**Step 1 — Add dependency in `app\u002Fbuild.gradle[.kts]`**\n\n```kotlin\ndependencies {\n    implementation(platform(\"io.sentry:sentry-bom:8.33.0\"))\n    implementation(\"io.sentry:sentry-android\")\n}\n```\n\n**Step 2 — Initialize in Application class** (same as Path A, Step 3)\n\n**Step 3 — Configure ProGuard\u002FR8 manually**\n\nThe Sentry SDK ships a ProGuard rules file automatically. For manual mapping upload, install `sentry-cli` and add to your CI:\n\n```bash\nsentry-cli releases files \"my-app@1.0.0+42\" upload-proguard \\\n  --org YOUR_ORG --project YOUR_PROJECT \\\n  app\u002Fbuild\u002Foutputs\u002Fmapping\u002Frelease\u002Fmapping.txt\n```\n\n---\n\n### Quick Reference: Full-Featured `SentryAndroid.init()`\n\n```kotlin\nSentryAndroid.init(this) { options ->\n    options.dsn = \"YOUR_SENTRY_DSN\"\n\n    \u002F\u002F Environment and release\n    options.environment = BuildConfig.BUILD_TYPE     \u002F\u002F \"debug\", \"release\", etc.\n    options.release = \"${BuildConfig.APPLICATION_ID}@${BuildConfig.VERSION_NAME}+${BuildConfig.VERSION_CODE}\"\n\n    \u002F\u002F Tracing — sample 100% in dev, lower to 10–20% in production\n    options.tracesSampleRate = 1.0\n\n    \u002F\u002F Continuous UI profiling (recommended over transaction-based)\n    options.profileSessionSampleRate = 1.0\n\n    \u002F\u002F Session Replay (API 26+; silent no-op on API 21–25)\n    options.sessionReplay.sessionSampleRate = 0.1\n    options.sessionReplay.onErrorSampleRate = 1.0\n    options.sessionReplay.maskAllText = true         \u002F\u002F mask text for privacy\n    options.sessionReplay.maskAllImages = true       \u002F\u002F mask images for privacy\n\n    \u002F\u002F Structured logging\n    options.logs.isEnabled = true\n\n    \u002F\u002F Error enrichment\n    options.isAttachScreenshot = true                \u002F\u002F capture screenshot on error\n    options.isAttachViewHierarchy = true             \u002F\u002F attach view hierarchy JSON\n\n    \u002F\u002F ANR detection (5s default; watchdog + ApplicationExitInfo API 30+)\n    options.isAnrEnabled = true\n\n    \u002F\u002F NDK native crash handling (enabled by default)\n    options.isEnableNdk = true\n\n    \u002F\u002F Send PII: IP address, user data\n    options.sendDefaultPii = true\n\n    \u002F\u002F Trace propagation (backend distributed tracing)\n    options.tracePropagationTargets = listOf(\"api.yourapp.com\", \".*\\\\.yourapp\\\\.com\")\n\n    \u002F\u002F Verbose logging — disable in production\n    options.isDebug = BuildConfig.DEBUG\n}\n```\n\n---\n\n### For Each Agreed Feature\n\nWalk through features one at a time. Load the reference file for each, follow its steps, then verify before moving on:\n\n| Feature | Reference | Load when... |\n|---------|-----------|-------------|\n| Error Monitoring | `${SKILL_ROOT}\u002Freferences\u002Ferror-monitoring.md` | Always (baseline) |\n| Tracing & Performance | `${SKILL_ROOT}\u002Freferences\u002Ftracing.md` | Always for Android (Activity lifecycle, network) |\n| Profiling | `${SKILL_ROOT}\u002Freferences\u002Fprofiling.md` | Performance-sensitive production apps |\n| Session Replay | `${SKILL_ROOT}\u002Freferences\u002Fsession-replay.md` | User-facing apps (API 26+) |\n| Logging | `${SKILL_ROOT}\u002Freferences\u002Flogging.md` | Structured logging \u002F log-to-trace correlation |\n| Metrics | `${SKILL_ROOT}\u002Freferences\u002Fmetrics.md` | Custom metric tracking (SDK ≥ 8.30.0) |\n| Crons | `${SKILL_ROOT}\u002Freferences\u002Fcrons.md` | Scheduled jobs, WorkManager check-ins |\n| Integration Reference | `${SKILL_ROOT}\u002Freferences\u002Fintegrations.md` | Built-in, optional, and Gradle bytecode integrations |\n\nFor each feature: `Read ${SKILL_ROOT}\u002Freferences\u002F\u003Cfeature>.md`, follow steps exactly, verify it works.\n\n---\n\n## Configuration Reference\n\n### Core `SentryOptions` (via `SentryAndroid.init`)\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `dsn` | `String` | — | **Required.** Project DSN; SDK silently disabled if empty |\n| `environment` | `String` | — | e.g., `\"production\"`, `\"staging\"`. Env: `SENTRY_ENVIRONMENT` |\n| `release` | `String` | — | App version, e.g., `\"my-app@1.0.0+42\"`. Env: `SENTRY_RELEASE` |\n| `dist` | `String` | — | Build variant \u002F distribution identifier |\n| `sendDefaultPii` | `Boolean` | `false` | Include PII: IP address, user data |\n| `sampleRate` | `Double` | `1.0` | Error event sampling (0.0–1.0) |\n| `maxBreadcrumbs` | `Int` | `100` | Max breadcrumbs per event |\n| `isAttachStacktrace` | `Boolean` | `true` | Auto-attach stack traces to message events |\n| `isAttachScreenshot` | `Boolean` | `false` | Capture screenshot on error |\n| `isAttachViewHierarchy` | `Boolean` | `false` | Attach JSON view hierarchy as attachment |\n| `isDebug` | `Boolean` | `false` | Verbose SDK output. **Never use in production** |\n| `isEnabled` | `Boolean` | `true` | Disable SDK entirely (e.g., for testing) |\n| `beforeSend` | `SentryOptions.BeforeSendCallback` | — | Modify or drop error events before sending |\n| `beforeBreadcrumb` | `SentryOptions.BeforeBreadcrumbCallback` | — | Filter breadcrumbs before storage |\n\n### Tracing Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `tracesSampleRate` | `Double` | `0.0` | Transaction sample rate (0–1). Use `1.0` in dev |\n| `tracesSampler` | `TracesSamplerCallback` | — | Per-transaction sampling; overrides `tracesSampleRate` |\n| `tracePropagationTargets` | `List\u003CString>` | `[\".*\"]` | Hosts\u002FURLs to receive `sentry-trace` and `baggage` headers |\n| `isEnableAutoActivityLifecycleTracing` | `Boolean` | `true` | Auto-instrument Activity lifecycle |\n| `isEnableTimeToFullDisplayTracing` | `Boolean` | `false` | TTFD spans (requires `Sentry.reportFullyDisplayed()`) |\n| `isEnableUserInteractionTracing` | `Boolean` | `false` | Auto-instrument user gestures as transactions |\n\n### Profiling Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `profileSessionSampleRate` | `Double` | `0.0` | Continuous profiling sample rate (SDK ≥ 8.7.0, API 22+) |\n| `profilesSampleRate` | `Double` | `0.0` | Legacy transaction profiling rate (mutually exclusive with continuous) |\n| `isProfilingStartOnAppStart` | `Boolean` | `false` | Auto-start profiling session on app launch |\n\n### ANR Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `isAnrEnabled` | `Boolean` | `true` | Enable ANR watchdog thread |\n| `anrTimeoutIntervalMillis` | `Long` | `5000` | Milliseconds before reporting ANR |\n| `isAnrReportInDebug` | `Boolean` | `false` | Report ANRs in debug builds (noisy in debugger) |\n\n### NDK Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `isEnableNdk` | `Boolean` | `true` | Enable native crash capture via sentry-native |\n| `isEnableScopeSync` | `Boolean` | `true` | Sync Java scope (user, tags) to NDK layer |\n| `isEnableTombstoneFetchJob` | `Boolean` | `true` | Fetch NDK tombstone files for enrichment |\n\n### Session Replay Options (`options.sessionReplay`)\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `sessionSampleRate` | `Double` | `0.0` | Fraction of all sessions to record |\n| `onErrorSampleRate` | `Double` | `0.0` | Fraction of error sessions to record |\n| `maskAllText` | `Boolean` | `true` | Mask all text in replays |\n| `maskAllImages` | `Boolean` | `true` | Mask all images in replays |\n| `quality` | `SentryReplayQuality` | `MEDIUM` | Video quality: `LOW`, `MEDIUM`, `HIGH` |\n\n### Logging Options (`options.logs`)\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `isEnabled` | `Boolean` | `false` | Enable `Sentry.logger()` API (SDK ≥ 8.12.0) |\n| `setBeforeSend` | `BeforeSendLogCallback` | — | Filter\u002Fmodify log entries before sending |\n\n### Environment Variables\n\n| Variable | Purpose | Notes |\n|----------|---------|-------|\n| `SENTRY_DSN` | Data Source Name | Set in CI; SDK reads from environment at init |\n| `SENTRY_AUTH_TOKEN` | Upload ProGuard mappings and source context | **Never commit — use CI\u002FCD secrets** |\n| `SENTRY_ORG` | Organization slug | Used by Gradle plugin `sentry.org` |\n| `SENTRY_PROJECT` | Project slug | Used by Gradle plugin `sentry.projectName` |\n| `SENTRY_RELEASE` | Release identifier | Falls back from `options.release` |\n| `SENTRY_ENVIRONMENT` | Environment name | Falls back from `options.environment` |\n\nYou can also configure DSN and many options via `AndroidManifest.xml` meta-data:\n\n```xml\n\u003Capplication>\n    \u003Cmeta-data android:name=\"io.sentry.dsn\" android:value=\"YOUR_DSN\" \u002F>\n    \u003Cmeta-data android:name=\"io.sentry.traces-sample-rate\" android:value=\"1.0\" \u002F>\n    \u003Cmeta-data android:name=\"io.sentry.environment\" android:value=\"production\" \u002F>\n    \u003Cmeta-data android:name=\"io.sentry.anr.enable\" android:value=\"true\" \u002F>\n    \u003Cmeta-data android:name=\"io.sentry.attach-screenshot\" android:value=\"true\" \u002F>\n    \u003Cmeta-data android:name=\"io.sentry.attach-view-hierarchy\" android:value=\"true\" \u002F>\n\u003C\u002Fapplication>\n```\n\n> ⚠️ Manifest meta-data is a convenient alternative but does **not** support the full option set. For complex configuration (session replay, profiling, hooks), use `SentryAndroid.init()`.\n\n---\n\n## Verification\n\nAfter setup, verify Sentry is receiving events:\n\n**Test error capture:**\n```kotlin\n\u002F\u002F In an Activity or Fragment\ntry {\n    throw RuntimeException(\"Sentry Android SDK test\")\n} catch (e: Exception) {\n    Sentry.captureException(e)\n}\n```\n\n**Test tracing:**\n```kotlin\nval transaction = Sentry.startTransaction(\"test-task\", \"task\")\nval span = transaction.startChild(\"test-span\", \"description\")\nspan.finish()\ntransaction.finish()\n```\n\n**Test structured logging (SDK ≥ 8.12.0):**\n```kotlin\nSentry.logger().info(\"Sentry logging test\")\nSentry.logger().error(\"Error log test\", Exception(\"test error\"))\n```\n\n**Check the Sentry dashboard:**\n- **Issues** → your test exception should appear within seconds\n- **Traces** → look for `test-task` transaction with child span\n- **Replays** → session recording visible after app interaction (requires API 26+)\n- **Logs** → structured log entries visible under Logs tab\n\nIf nothing appears:\n1. Set `options.isDebug = true` — SDK logs to Logcat\n2. Verify DSN is correct and matches your Sentry project\n3. Check that your `Application` class is registered in `AndroidManifest.xml` as `android:name`\n4. Confirm the device\u002Femulator has internet connectivity\n5. For NDK crashes, ensure `isEnableNdk = true` (default) and build with NDK support\n\n---\n\n## Phase 4: Cross-Link\n\nAfter completing Android setup, check for a backend or web frontend missing Sentry coverage:\n\n```bash\n# Adjacent backend directories\nls ..\u002Fbackend ..\u002Fserver ..\u002Fapi 2>\u002Fdev\u002Fnull\ncat ..\u002Fgo.mod 2>\u002Fdev\u002Fnull | head -3\ncat ..\u002Frequirements.txt ..\u002Fpyproject.toml 2>\u002Fdev\u002Fnull | head -5\ncat ..\u002FGemfile 2>\u002Fdev\u002Fnull | head -3\nls ..\u002Fbackend\u002Fpackage.json ..\u002Fserver\u002Fpackage.json 2>\u002Fdev\u002Fnull\n\n# iOS counterpart app\nls ..\u002Fios ..\u002FYourApp-iOS 2>\u002Fdev\u002Fnull\nfind .. -maxdepth 3 -name \"*.xcodeproj\" 2>\u002Fdev\u002Fnull | head -3\n```\n\nIf a backend or related platform exists without Sentry, suggest the matching skill:\n\n| Detected | Suggest skill |\n|----------|--------------|\n| Go backend (`go.mod`) | `sentry-go-sdk` |\n| Python backend (`requirements.txt`, `pyproject.toml`) | `sentry-python-sdk` |\n| Ruby backend (`Gemfile`) | `sentry-ruby-sdk` |\n| Node.js backend | `@sentry\u002Fnode` — see [docs.sentry.io\u002Fplatforms\u002Fjavascript\u002Fguides\u002Fexpress\u002F](https:\u002F\u002Fdocs.sentry.io\u002Fplatforms\u002Fjavascript\u002Fguides\u002Fexpress\u002F) |\n| iOS app (`.xcodeproj`) | `sentry-cocoa-sdk` |\n| React Native (`package.json` with `react-native`) | `sentry-react-native-sdk` |\n| React \u002F Next.js web | `sentry-react-sdk` or `sentry-nextjs-sdk` |\n\n**Distributed tracing setup** — if the backend skill is added, configure `tracePropagationTargets` in Android to propagate trace context to your API:\n\n```kotlin\noptions.tracePropagationTargets = listOf(\n    \"api.yourapp.com\",\n    \".*\\\\.yourapp\\\\.com\"\n)\n```\n\nThis links mobile transactions to backend traces in the Sentry waterfall view.\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n|-------|----------|\n| Events not appearing in Sentry | Set `isDebug = true`, check Logcat for SDK errors; verify DSN is correct and matches your project |\n| `SentryAndroid.init()` not called | Confirm `android:name=\".MyApplication\"` is set in `AndroidManifest.xml`; Application class not abstract |\n| Gradle plugin not found | Add the plugin to project-level `build.gradle.kts` first, then `apply false`; verify version `6.1.0` |\n| ProGuard mapping not uploading | Set `SENTRY_AUTH_TOKEN` env var; ensure `autoUploadProguardMapping = true` in `sentry {}` block |\n| NDK crashes not captured | Verify `isEnableNdk = true` (default); ensure project has NDK configured in `android.ndkVersion` |\n| ANR reported in debugger | Set `isAnrReportInDebug = false` (default); ANR watchdog fires when debugger pauses threads |\n| Session replay not recording | Requires API 26+; verify `sessionSampleRate > 0` or `onErrorSampleRate > 0`; check Logcat for replay errors |\n| Session replay shows blank screen | PixelCopy (default) requires hardware acceleration; try `SentryReplayOptions.screenshotQuality = CANVAS` |\n| Replay masking misaligned | Views with `translationX\u002FY` or `clipToPadding=false` can offset masks; report to [github.com\u002Fgetsentry\u002Fsentry-java](https:\u002F\u002Fgithub.com\u002Fgetsentry\u002Fsentry-java) |\n| `beforeSend` not firing | `beforeSend` only intercepts managed (Java\u002FKotlin) events; NDK native crashes bypass it |\n| OkHttp spans not appearing | Add `SentryOkHttpInterceptor` to your `OkHttpClient`, or use Gradle plugin `OKHTTP` bytecode instrumentation |\n| Spans not attached to transaction | Ensure `TransactionOptions().setBindToScope(true)` when starting transaction; child spans look for scope root |\n| Tracing not recording | Verify `tracesSampleRate > 0`; Activity instrumentation requires `isEnableAutoActivityLifecycleTracing = true` (default) |\n| Continuous profiling not working | SDK ≥ 8.7.0 required; API 22+ required; set `profileSessionSampleRate > 0`; don't also set `profilesSampleRate` |\n| Both profiling modes set | `profilesSampleRate` and `profileSessionSampleRate` are mutually exclusive — use only one |\n| TTFD spans missing | Set `isEnableTimeToFullDisplayTracing = true` and call `Sentry.reportFullyDisplayed()` when screen is ready |\n| Kotlin coroutine scope lost | Add `sentry-kotlin-extensions` dependency; use `Sentry.cloneMainContext()` to propagate trace context |\n| Release build stack traces unreadable | ProGuard mapping not uploaded; confirm Gradle plugin `autoUploadProguardMapping = true` and auth token set |\n| Source context not showing in Sentry | Enable `includeSourceContext = true` in `sentry {}` block (Gradle plugin required) |\n| BOM version conflict | Use `implementation(platform(\"io.sentry:sentry-bom:8.33.0\"))` and omit versions from all other `io.sentry:*` entries |\n| Version catalog alias unresolved | After editing `gradle\u002Flibs.versions.toml`, sync Gradle; alias names use `-` in TOML and `.` in build files (e.g., `sentry-android` → `libs.sentry.android`) |\n| Duplicate Sentry version in catalog | Reuse the existing `[versions] sentry = \"...\"` entry; don't add a second key, and don't hardcode the version in `build.gradle` when the catalog is in use |\n| `SENTRY_AUTH_TOKEN` exposed | Auth token is build-time only — never pass it to `SentryAndroid.init()` or embed in the APK |\n","> [All Skills](..\u002F..\u002FSKILL_TREE.md) > [SDK Setup](..\u002Fsentry-sdk-setup\u002FSKILL.md) > Android SDK\n\n# Sentry Android SDK\n\nOpinionated wizard that scans your Android project and guides you through complete Sentry setup — error monitoring, tracing, profiling, session replay, logging, and more.\n\n## Invoke This Skill When\n\n- User asks to \"add Sentry to Android\" or \"set up Sentry\" in an Android app\n- User wants error monitoring, crash reporting, ANR detection, tracing, profiling, session replay, or logging in Android\n- User mentions `sentry-android`, `io.sentry:sentry-android`, mobile crash tracking, or Sentry for Kotlin\u002FJava Android\n- User wants to monitor native (NDK) crashes, application not responding (ANR) events, or app startup performance\n\n> **Note:** SDK versions and APIs below reflect current Sentry docs at time of writing (`io.sentry:sentry-android:8.33.0`, Gradle plugin `6.1.0`).\n> Always verify against [docs.sentry.io\u002Fplatforms\u002Fandroid\u002F](https:\u002F\u002Fdocs.sentry.io\u002Fplatforms\u002Fandroid\u002F) before implementing.\n\n---\n\n## Phase 1: Detect\n\nRun these commands to understand the project before making any recommendations:\n\n```bash\n# Detect project structure and build system\nls build.gradle build.gradle.kts settings.gradle settings.gradle.kts 2>\u002Fdev\u002Fnull\n\n# Check AGP version and existing Sentry\ngrep -r '\"com.android.application\"' build.gradle* app\u002Fbuild.gradle* 2>\u002Fdev\u002Fnull | head -3\ngrep -ri sentry build.gradle* app\u002Fbuild.gradle* 2>\u002Fdev\u002Fnull | head -10\n\n# Check app-level build file (Groovy vs KTS)\nls app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull\n\n# Detect Gradle version catalog (libs.versions.toml) — modern AGP projects\nls gradle\u002Flibs.versions.toml 2>\u002Fdev\u002Fnull\n\n# Check for existing Sentry entries in the version catalog\ngrep -iE 'sentry|io\\.sentry' gradle\u002Flibs.versions.toml 2>\u002Fdev\u002Fnull | head -10\n\n# Check if build files reference the catalog (alias\u002Flibs.* usage)\ngrep -E 'alias\\(libs\\.|libs\\.[a-zA-Z]' build.gradle build.gradle.kts app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -5\n\n# Detect Kotlin vs Java\nfind app\u002Fsrc\u002Fmain -name \"*.kt\" 2>\u002Fdev\u002Fnull | head -3\nfind app\u002Fsrc\u002Fmain -name \"*.java\" 2>\u002Fdev\u002Fnull | head -3\n\n# Check minSdk, targetSdk\ngrep -E 'minSdk|targetSdk|compileSdk|minSdkVersion|targetSdkVersion' app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -6\n\n# Detect Jetpack Compose\ngrep -E 'compose|androidx.compose' app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -5\n\n# Detect OkHttp (popular HTTP client — has dedicated integration)\ngrep -E 'okhttp|retrofit' app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -3\n\n# Detect Room or SQLite\ngrep -E 'androidx.room|androidx.sqlite' app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -3\n\n# Detect Timber (logging library)\ngrep -E 'timber' app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -3\n\n# Detect Jetpack Navigation\ngrep -E 'androidx.navigation' app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -3\n\n# Detect Apollo (GraphQL)\ngrep -E 'apollo' app\u002Fbuild.gradle app\u002Fbuild.gradle.kts 2>\u002Fdev\u002Fnull | head -3\n\n# Check existing Sentry initialization\ngrep -r \"SentryAndroid.init\\|io.sentry.Sentry\" app\u002Fsrc\u002F 2>\u002Fdev\u002Fnull | head -5\n\n# Check Application class\nfind app\u002Fsrc\u002Fmain -name \"*.kt\" -o -name \"*.java\" 2>\u002Fdev\u002Fnull | xargs grep -l \"Application()\" 2>\u002Fdev\u002Fnull | head -3\n\n# Adjacent backend (for cross-linking)\nls ..\u002Fbackend ..\u002Fserver ..\u002Fapi 2>\u002Fdev\u002Fnull\nfind .. -maxdepth 2 \\( -name \"go.mod\" -o -name \"requirements.txt\" -o -name \"Gemfile\" \\) 2>\u002Fdev\u002Fnull | grep -v node_modules | head -5\n```\n\n**What to determine:**\n\n| Question | Impact |\n|----------|--------|\n| `build.gradle.kts` present? | Use Kotlin DSL syntax in all examples |\n| `gradle\u002Flibs.versions.toml` present? | Add Sentry to the version catalog; reference via `libs.*` in build files |\n| Catalog already has `sentry` entries? | Reuse the existing version ref; don't duplicate or hardcode versions |\n| `minSdk \u003C 26`? | Note Session Replay requires API 26+ — silent no-op below that |\n| Compose detected? | Recommend `sentry-compose-android` and Compose-specific masking |\n| OkHttp present? | Recommend `sentry-okhttp` interceptor or Gradle plugin bytecode auto-instrumentation |\n| Room\u002FSQLite present? | Recommend `sentry-android-sqlite` or plugin bytecode instrumentation |\n| Timber present? | Recommend `sentry-android-timber` integration |\n| Jetpack Navigation? | Recommend `sentry-android-navigation` for screen tracking |\n| Already has `SentryAndroid.init()`? | Skip install, jump to feature config |\n| Application subclass exists? | That's where `SentryAndroid.init()` goes |\n\n---\n\n## Phase 2: Recommend\n\nPresent a concrete recommendation based on what you found. Don't ask open-ended questions — lead with a proposal:\n\n**Recommended (core coverage — always set up these):**\n- ✅ **Error Monitoring** — captures uncaught exceptions, ANRs, and native NDK crashes automatically\n- ✅ **Tracing** — auto-instruments Activity lifecycle, app start, HTTP requests, and database queries\n- ✅ **Session Replay** — records screen captures and user interactions for debugging (API 26+)\n\n**Optional (enhanced observability):**\n- ⚡ **Profiling** — continuous UI profiling (recommended) or transaction-based sampling\n- ⚡ **Logging** — structured logs via `Sentry.logger()`, with optional Timber bridge\n- ⚡ **User Feedback** — collect user-submitted bug reports from inside the app\n\n**Recommendation logic:**\n\n| Feature | Recommend when... |\n|---------|------------------|\n| Error Monitoring | **Always** — non-negotiable baseline for any Android app |\n| Tracing | **Always for Android** — app start time, Activity lifecycle, network latency matter |\n| Session Replay | User-facing production app on API 26+; visual debugging of user issues |\n| Profiling | Performance-sensitive apps, startup time investigations, production perf analysis |\n| Logging | App uses structured logging or you want log-to-trace correlation in Sentry |\n| User Feedback | Beta or customer-facing app where you want user-submitted bug reports |\n\nPropose: *\"For your [Kotlin \u002F Java] Android app (minSdk X), I recommend setting up Error Monitoring + Tracing + Session Replay. Want me to also add Profiling and Logging?\"*\n\n---\n\n## Phase 3: Guide\n\n### Determine Your Setup Path\n\n| Project type | Recommended setup | Complexity |\n|-------------|------------------|------------|\n| New project, no existing Sentry | Gradle plugin (recommended) | Low — plugin handles most config |\n| Existing project, no Sentry | Gradle plugin or manual init | Medium — add dependency + Application class |\n| Manual full control | `SentryAndroid.init()` in Application | Medium — explicit config, most flexible |\n\n### Option 1: Wizard (Recommended)\n\n> **You need to run this yourself** — the wizard opens a browser for login\n> and requires interactive input that the agent can't handle.\n> Copy-paste into your terminal:\n>\n> ```\n> npx @sentry\u002Fwizard@latest -i android\n> ```\n>\n> It handles login, org\u002Fproject selection, Gradle plugin setup, dependency\n> installation, DSN configuration, and ProGuard\u002FR8 mapping upload.\n>\n> **Once it finishes, come back and skip to [Verification](#verification).**\n\nIf the user skips the wizard, proceed with Option 2 (Manual Setup) below.\n\n---\n\n### Option 2: Manual Setup\n\n#### Using a Gradle Version Catalog (`gradle\u002Flibs.versions.toml`)\n\nIf Phase 1 detected `gradle\u002Flibs.versions.toml`, add Sentry to the catalog **first**, then reference it from your build files. This keeps versions centralized and matches modern AGP project conventions.\n\n**Step 1 — Add entries to `gradle\u002Flibs.versions.toml`**\n\n```toml\n[versions]\nsentry = \"8.33.0\"\nsentryGradlePlugin = \"6.1.0\"\n\n[libraries]\nsentry-android = { module = \"io.sentry:sentry-android\", version.ref = \"sentry\" }\nsentry-bom = { module = \"io.sentry:sentry-bom\", version.ref = \"sentry\" }\n# Optional integrations — add only the ones your project uses:\nsentry-android-timber = { module = \"io.sentry:sentry-android-timber\" }\nsentry-android-fragment = { module = \"io.sentry:sentry-android-fragment\" }\nsentry-compose-android = { module = \"io.sentry:sentry-compose-android\" }\nsentry-android-navigation = { module = \"io.sentry:sentry-android-navigation\" }\nsentry-okhttp = { module = \"io.sentry:sentry-okhttp\" }\nsentry-android-sqlite = { module = \"io.sentry:sentry-android-sqlite\" }\nsentry-kotlin-extensions = { module = \"io.sentry:sentry-kotlin-extensions\" }\n\n[plugins]\nsentry-android-gradle = { id = \"io.sentry.android.gradle\", version.ref = \"sentryGradlePlugin\" }\n```\n\n> **Note:** Optional integration entries omit `version.ref` — their versions come from the BOM at resolution time. Only `sentry-bom` needs the version ref.\n> If the catalog already defines a `sentry` version, reuse it instead of adding a duplicate entry.\n\n**Step 2 — Reference the catalog from `build.gradle[.kts]`**\n\nProject-level `build.gradle.kts`:\n```kotlin\nplugins {\n    alias(libs.plugins.sentry.android.gradle) apply false\n}\n```\n\nApp-level `app\u002Fbuild.gradle.kts`:\n```kotlin\nplugins {\n    id(\"com.android.application\")\n    alias(libs.plugins.sentry.android.gradle)\n}\n\ndependencies {\n    implementation(platform(libs.sentry.bom))\n    implementation(libs.sentry.android)\n    \u002F\u002F implementation(libs.sentry.okhttp)\n    \u002F\u002F implementation(libs.sentry.compose.android)\n}\n```\n\nGroovy DSL (`app\u002Fbuild.gradle`) equivalent:\n```groovy\nplugins {\n    id \"com.android.application\"\n    alias libs.plugins.sentry.android.gradle\n}\n\ndependencies {\n    implementation platform(libs.sentry.bom)\n    implementation libs.sentry.android\n}\n```\n\nThen continue with the `sentry {}` configuration block from Path A, Step 2 below. The rest of the setup (Application class init, manifest registration, verification) is identical.\n\n---\n\n#### Path A: Gradle Plugin (Recommended)\n\nThe Sentry Gradle plugin is the easiest setup path. It:\n- Uploads ProGuard\u002FR8 mapping files automatically on release builds\n- Injects source context into stack frames\n- Optionally instruments OkHttp, Room\u002FSQLite, File I\u002FO, Compose navigation, and `android.util.Log` via bytecode transforms (zero source changes)\n\n**Step 1 — Add the plugin to `build.gradle[.kts]` (project-level)**\n\nGroovy DSL (`build.gradle`):\n```groovy\nplugins {\n    id \"io.sentry.android.gradle\" version \"6.1.0\" apply false\n}\n```\n\nKotlin DSL (`build.gradle.kts`):\n```kotlin\nplugins {\n    id(\"io.sentry.android.gradle\") version \"6.1.0\" apply false\n}\n```\n\n**Step 2 — Apply plugin + add dependencies in `app\u002Fbuild.gradle[.kts]`**\n\nGroovy DSL:\n```groovy\nplugins {\n    id \"com.android.application\"\n    id \"io.sentry.android.gradle\"\n}\n\nandroid {\n    \u002F\u002F ...\n}\n\ndependencies {\n    \u002F\u002F Use BOM for consistent versions across sentry modules\n    implementation platform(\"io.sentry:sentry-bom:8.33.0\")\n    implementation \"io.sentry:sentry-android\"\n\n    \u002F\u002F Optional integrations (add what's relevant):\n    \u002F\u002F implementation \"io.sentry:sentry-android-timber\"     \u002F\u002F Timber bridge\n    \u002F\u002F implementation \"io.sentry:sentry-android-fragment\"   \u002F\u002F Fragment lifecycle tracing\n    \u002F\u002F implementation \"io.sentry:sentry-compose-android\"    \u002F\u002F Jetpack Compose support\n    \u002F\u002F implementation \"io.sentry:sentry-android-navigation\"  \u002F\u002F Jetpack Navigation\n    \u002F\u002F implementation \"io.sentry:sentry-okhttp\"             \u002F\u002F OkHttp interceptor\n    \u002F\u002F implementation \"io.sentry:sentry-android-sqlite\"     \u002F\u002F Room\u002FSQLite tracing\n    \u002F\u002F implementation \"io.sentry:sentry-kotlin-extensions\"  \u002F\u002F Coroutine context propagation\n}\n\nsentry {\n    org = \"YOUR_ORG_SLUG\"\n    projectName = \"YOUR_PROJECT_SLUG\"\n    authToken = System.getenv(\"SENTRY_AUTH_TOKEN\")\n\n    \u002F\u002F Enable auto-instrumentation via bytecode transforms (no source changes needed)\n    tracingInstrumentation {\n        enabled = true\n        features = [InstrumentationFeature.DATABASE, InstrumentationFeature.FILE_IO,\n                    InstrumentationFeature.OKHTTP, InstrumentationFeature.COMPOSE]\n    }\n\n    \u002F\u002F Upload ProGuard mapping and source context on release\n    autoUploadProguardMapping = true\n    includeSourceContext = true\n}\n```\n\nKotlin DSL (`app\u002Fbuild.gradle.kts`):\n```kotlin\nplugins {\n    id(\"com.android.application\")\n    id(\"io.sentry.android.gradle\")\n}\n\ndependencies {\n    implementation(platform(\"io.sentry:sentry-bom:8.33.0\"))\n    implementation(\"io.sentry:sentry-android\")\n\n    \u002F\u002F Optional integrations:\n    \u002F\u002F implementation(\"io.sentry:sentry-android-timber\")\n    \u002F\u002F implementation(\"io.sentry:sentry-android-fragment\")\n    \u002F\u002F implementation(\"io.sentry:sentry-compose-android\")\n    \u002F\u002F implementation(\"io.sentry:sentry-android-navigation\")\n    \u002F\u002F implementation(\"io.sentry:sentry-okhttp\")\n    \u002F\u002F implementation(\"io.sentry:sentry-android-sqlite\")\n    \u002F\u002F implementation(\"io.sentry:sentry-kotlin-extensions\")\n}\n\nsentry {\n    org = \"YOUR_ORG_SLUG\"\n    projectName = \"YOUR_PROJECT_SLUG\"\n    authToken = System.getenv(\"SENTRY_AUTH_TOKEN\")\n\n    tracingInstrumentation {\n        enabled = true\n        features = setOf(\n            InstrumentationFeature.DATABASE,\n            InstrumentationFeature.FILE_IO,\n            InstrumentationFeature.OKHTTP,\n            InstrumentationFeature.COMPOSE,\n        )\n    }\n\n    autoUploadProguardMapping = true\n    includeSourceContext = true\n}\n```\n\n**Step 3 — Initialize Sentry in your Application class**\n\nIf you don't have an Application subclass, create one:\n\n```kotlin\n\u002F\u002F MyApplication.kt\nimport android.app.Application\nimport io.sentry.SentryLevel\nimport io.sentry.android.core.SentryAndroid\nimport io.sentry.android.replay.SentryReplayOptions\n\nclass MyApplication : Application() {\n    override fun onCreate() {\n        super.onCreate()\n\n        SentryAndroid.init(this) { options ->\n            options.dsn = \"YOUR_SENTRY_DSN\"\n\n            \u002F\u002F Tracing — lower to 0.1–0.2 in high-traffic production\n            options.tracesSampleRate = 1.0\n\n            \u002F\u002F Profiling — use continuous UI profiling (recommended, SDK ≥ 8.7.0)\n            options.profileSessionSampleRate = 1.0\n\n            \u002F\u002F Session Replay (API 26+ only; silent no-op below API 26)\n            options.sessionReplay.sessionSampleRate = 0.1    \u002F\u002F 10% of all sessions\n            options.sessionReplay.onErrorSampleRate = 1.0    \u002F\u002F 100% on error\n\n            \u002F\u002F Structured logging\n            options.logs.isEnabled = true\n\n            \u002F\u002F Environment\n            options.environment = BuildConfig.BUILD_TYPE\n        }\n    }\n}\n```\n\nJava equivalent:\n```java\n\u002F\u002F MyApplication.java\nimport android.app.Application;\nimport io.sentry.android.core.SentryAndroid;\n\npublic class MyApplication extends Application {\n    @Override\n    public void onCreate() {\n        super.onCreate();\n\n        SentryAndroid.init(this, options -> {\n            options.setDsn(\"YOUR_SENTRY_DSN\");\n            options.setTracesSampleRate(1.0);\n            options.setProfileSessionSampleRate(1.0);\n            options.getSessionReplay().setSessionSampleRate(0.1);\n            options.getSessionReplay().setOnErrorSampleRate(1.0);\n            options.getLogs().setEnabled(true);\n            options.setEnvironment(BuildConfig.BUILD_TYPE);\n        });\n    }\n}\n```\n\n**Step 4 — Register Application in `AndroidManifest.xml`**\n\n```xml\n\u003Capplication\n    android:name=\".MyApplication\"\n    ... >\n```\n\n---\n\n#### Path B: Manual Setup (No Gradle Plugin)\n\nUse this if you can't use the Gradle plugin (e.g., non-standard build setups).\n\n**Step 1 — Add dependency in `app\u002Fbuild.gradle[.kts]`**\n\n```kotlin\ndependencies {\n    implementation(platform(\"io.sentry:sentry-bom:8.33.0\"))\n    implementation(\"io.sentry:sentry-android\")\n}\n```\n\n**Step 2 — Initialize in Application class** (same as Path A, Step 3)\n\n**Step 3 — Configure ProGuard\u002FR8 manually**\n\nThe Sentry SDK ships a ProGuard rules file automatically. For manual mapping upload, install `sentry-cli` and add to your CI:\n\n```bash\nsentry-cli releases files \"my-app@1.0.0+42\" upload-proguard \\\n  --org YOUR_ORG --project YOUR_PROJECT \\\n  app\u002Fbuild\u002Foutputs\u002Fmapping\u002Frelease\u002Fmapping.txt\n```\n\n---\n\n### Quick Reference: Full-Featured `SentryAndroid.init()`\n\n```kotlin\nSentryAndroid.init(this) { options ->\n    options.dsn = \"YOUR_SENTRY_DSN\"\n\n    \u002F\u002F Environment and release\n    options.environment = BuildConfig.BUILD_TYPE     \u002F\u002F \"debug\", \"release\", etc.\n    options.release = \"${BuildConfig.APPLICATION_ID}@${BuildConfig.VERSION_NAME}+${BuildConfig.VERSION_CODE}\"\n\n    \u002F\u002F Tracing — sample 100% in dev, lower to 10–20% in production\n    options.tracesSampleRate = 1.0\n\n    \u002F\u002F Continuous UI profiling (recommended over transaction-based)\n    options.profileSessionSampleRate = 1.0\n\n    \u002F\u002F Session Replay (API 26+; silent no-op on API 21–25)\n    options.sessionReplay.sessionSampleRate = 0.1\n    options.sessionReplay.onErrorSampleRate = 1.0\n    options.sessionReplay.maskAllText = true         \u002F\u002F mask text for privacy\n    options.sessionReplay.maskAllImages = true       \u002F\u002F mask images for privacy\n\n    \u002F\u002F Structured logging\n    options.logs.isEnabled = true\n\n    \u002F\u002F Error enrichment\n    options.isAttachScreenshot = true                \u002F\u002F capture screenshot on error\n    options.isAttachViewHierarchy = true             \u002F\u002F attach view hierarchy JSON\n\n    \u002F\u002F ANR detection (5s default; watchdog + ApplicationExitInfo API 30+)\n    options.isAnrEnabled = true\n\n    \u002F\u002F NDK native crash handling (enabled by default)\n    options.isEnableNdk = true\n\n    \u002F\u002F Send PII: IP address, user data\n    options.sendDefaultPii = true\n\n    \u002F\u002F Trace propagation (backend distributed tracing)\n    options.tracePropagationTargets = listOf(\"api.yourapp.com\", \".*\\\\.yourapp\\\\.com\")\n\n    \u002F\u002F Verbose logging — disable in production\n    options.isDebug = BuildConfig.DEBUG\n}\n```\n\n---\n\n### For Each Agreed Feature\n\nWalk through features one at a time. Load the reference file for each, follow its steps, then verify before moving on:\n\n| Feature | Reference | Load when... |\n|---------|-----------|-------------|\n| Error Monitoring | `${SKILL_ROOT}\u002Freferences\u002Ferror-monitoring.md` | Always (baseline) |\n| Tracing & Performance | `${SKILL_ROOT}\u002Freferences\u002Ftracing.md` | Always for Android (Activity lifecycle, network) |\n| Profiling | `${SKILL_ROOT}\u002Freferences\u002Fprofiling.md` | Performance-sensitive production apps |\n| Session Replay | `${SKILL_ROOT}\u002Freferences\u002Fsession-replay.md` | User-facing apps (API 26+) |\n| Logging | `${SKILL_ROOT}\u002Freferences\u002Flogging.md` | Structured logging \u002F log-to-trace correlation |\n| Metrics | `${SKILL_ROOT}\u002Freferences\u002Fmetrics.md` | Custom metric tracking (SDK ≥ 8.30.0) |\n| Crons | `${SKILL_ROOT}\u002Freferences\u002Fcrons.md` | Scheduled jobs, WorkManager check-ins |\n| Integration Reference | `${SKILL_ROOT}\u002Freferences\u002Fintegrations.md` | Built-in, optional, and Gradle bytecode integrations |\n\nFor each feature: `Read ${SKILL_ROOT}\u002Freferences\u002F\u003Cfeature>.md`, follow steps exactly, verify it works.\n\n---\n\n## Configuration Reference\n\n### Core `SentryOptions` (via `SentryAndroid.init`)\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `dsn` | `String` | — | **Required.** Project DSN; SDK silently disabled if empty |\n| `environment` | `String` | — | e.g., `\"production\"`, `\"staging\"`. Env: `SENTRY_ENVIRONMENT` |\n| `release` | `String` | — | App version, e.g., `\"my-app@1.0.0+42\"`. Env: `SENTRY_RELEASE` |\n| `dist` | `String` | — | Build variant \u002F distribution identifier |\n| `sendDefaultPii` | `Boolean` | `false` | Include PII: IP address, user data |\n| `sampleRate` | `Double` | `1.0` | Error event sampling (0.0–1.0) |\n| `maxBreadcrumbs` | `Int` | `100` | Max breadcrumbs per event |\n| `isAttachStacktrace` | `Boolean` | `true` | Auto-attach stack traces to message events |\n| `isAttachScreenshot` | `Boolean` | `false` | Capture screenshot on error |\n| `isAttachViewHierarchy` | `Boolean` | `false` | Attach JSON view hierarchy as attachment |\n| `isDebug` | `Boolean` | `false` | Verbose SDK output. **Never use in production** |\n| `isEnabled` | `Boolean` | `true` | Disable SDK entirely (e.g., for testing) |\n| `beforeSend` | `SentryOptions.BeforeSendCallback` | — | Modify or drop error events before sending |\n| `beforeBreadcrumb` | `SentryOptions.BeforeBreadcrumbCallback` | — | Filter breadcrumbs before storage |\n\n### Tracing Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `tracesSampleRate` | `Double` | `0.0` | Transaction sample rate (0–1). Use `1.0` in dev |\n| `tracesSampler` | `TracesSamplerCallback` | — | Per-transaction sampling; overrides `tracesSampleRate` |\n| `tracePropagationTargets` | `List\u003CString>` | `[\".*\"]` | Hosts\u002FURLs to receive `sentry-trace` and `baggage` headers |\n| `isEnableAutoActivityLifecycleTracing` | `Boolean` | `true` | Auto-instrument Activity lifecycle |\n| `isEnableTimeToFullDisplayTracing` | `Boolean` | `false` | TTFD spans (requires `Sentry.reportFullyDisplayed()`) |\n| `isEnableUserInteractionTracing` | `Boolean` | `false` | Auto-instrument user gestures as transactions |\n\n### Profiling Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `profileSessionSampleRate` | `Double` | `0.0` | Continuous profiling sample rate (SDK ≥ 8.7.0, API 22+) |\n| `profilesSampleRate` | `Double` | `0.0` | Legacy transaction profiling rate (mutually exclusive with continuous) |\n| `isProfilingStartOnAppStart` | `Boolean` | `false` | Auto-start profiling session on app launch |\n\n### ANR Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `isAnrEnabled` | `Boolean` | `true` | Enable ANR watchdog thread |\n| `anrTimeoutIntervalMillis` | `Long` | `5000` | Milliseconds before reporting ANR |\n| `isAnrReportInDebug` | `Boolean` | `false` | Report ANRs in debug builds (noisy in debugger) |\n\n### NDK Options\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `isEnableNdk` | `Boolean` | `true` | Enable native crash capture via sentry-native |\n| `isEnableScopeSync` | `Boolean` | `true` | Sync Java scope (user, tags) to NDK layer |\n| `isEnableTombstoneFetchJob` | `Boolean` | `true` | Fetch NDK tombstone files for enrichment |\n\n### Session Replay Options (`options.sessionReplay`)\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `sessionSampleRate` | `Double` | `0.0` | Fraction of all sessions to record |\n| `onErrorSampleRate` | `Double` | `0.0` | Fraction of error sessions to record |\n| `maskAllText` | `Boolean` | `true` | Mask all text in replays |\n| `maskAllImages` | `Boolean` | `true` | Mask all images in replays |\n| `quality` | `SentryReplayQuality` | `MEDIUM` | Video quality: `LOW`, `MEDIUM`, `HIGH` |\n\n### Logging Options (`options.logs`)\n\n| Option | Type | Default | Purpose |\n|--------|------|---------|---------|\n| `isEnabled` | `Boolean` | `false` | Enable `Sentry.logger()` API (SDK ≥ 8.12.0) |\n| `setBeforeSend` | `BeforeSendLogCallback` | — | Filter\u002Fmodify log entries before sending |\n\n### Environment Variables\n\n| Variable | Purpose | Notes |\n|----------|---------|-------|\n| `SENTRY_DSN` | Data Source Name | Set in CI; SDK reads from environment at init |\n| `SENTRY_AUTH_TOKEN` | Upload ProGuard mappings and source context | **Never commit — use CI\u002FCD secrets** |\n| `SENTRY_ORG` | Organization slug | Used by Gradle plugin `sentry.org` |\n| `SENTRY_PROJECT` | Project slug | Used by Gradle plugin `sentry.projectName` |\n| `SENTRY_RELEASE` | Release identifier | Falls back from `options.release` |\n| `SENTRY_ENVIRONMENT` | Environment name | Falls back from `options.environment` |\n\nYou can also configure DSN and many options via `AndroidManifest.xml` meta-data:\n\n```xml\n\u003Capplication>\n    \u003Cmeta-data android:name=\"io.sentry.dsn\" android:value=\"YOUR_DSN\" \u002F>\n    \u003Cmeta-data android:name=\"io.sentry.traces-sample-rate\" android:value=\"1.0\" \u002F>\n    \u003Cmeta-data android:name=\"io.sentry.environment\" android:value=\"production\" \u002F>\n    \u003Cmeta-data android:name=\"io.sentry.anr.enable\" android:value=\"true\" \u002F>\n    \u003Cmeta-data android:name=\"io.sentry.attach-screenshot\" android:value=\"true\" \u002F>\n    \u003Cmeta-data android:name=\"io.sentry.attach-view-hierarchy\" android:value=\"true\" \u002F>\n\u003C\u002Fapplication>\n```\n\n> ⚠️ Manifest meta-data is a convenient alternative but does **not** support the full option set. For complex configuration (session replay, profiling, hooks), use `SentryAndroid.init()`.\n\n---\n\n## Verification\n\nAfter setup, verify Sentry is receiving events:\n\n**Test error capture:**\n```kotlin\n\u002F\u002F In an Activity or Fragment\ntry {\n    throw RuntimeException(\"Sentry Android SDK test\")\n} catch (e: Exception) {\n    Sentry.captureException(e)\n}\n```\n\n**Test tracing:**\n```kotlin\nval transaction = Sentry.startTransaction(\"test-task\", \"task\")\nval span = transaction.startChild(\"test-span\", \"description\")\nspan.finish()\ntransaction.finish()\n```\n\n**Test structured logging (SDK ≥ 8.12.0):**\n```kotlin\nSentry.logger().info(\"Sentry logging test\")\nSentry.logger().error(\"Error log test\", Exception(\"test error\"))\n```\n\n**Check the Sentry dashboard:**\n- **Issues** → your test exception should appear within seconds\n- **Traces** → look for `test-task` transaction with child span\n- **Replays** → session recording visible after app interaction (requires API 26+)\n- **Logs** → structured log entries visible under Logs tab\n\nIf nothing appears:\n1. Set `options.isDebug = true` — SDK logs to Logcat\n2. Verify DSN is correct and matches your Sentry project\n3. Check that your `Application` class is registered in `AndroidManifest.xml` as `android:name`\n4. Confirm the device\u002Femulator has internet connectivity\n5. For NDK crashes, ensure `isEnableNdk = true` (default) and build with NDK support\n\n---\n\n## Phase 4: Cross-Link\n\nAfter completing Android setup, check for a backend or web frontend missing Sentry coverage:\n\n```bash\n# Adjacent backend directories\nls ..\u002Fbackend ..\u002Fserver ..\u002Fapi 2>\u002Fdev\u002Fnull\ncat ..\u002Fgo.mod 2>\u002Fdev\u002Fnull | head -3\ncat ..\u002Frequirements.txt ..\u002Fpyproject.toml 2>\u002Fdev\u002Fnull | head -5\ncat ..\u002FGemfile 2>\u002Fdev\u002Fnull | head -3\nls ..\u002Fbackend\u002Fpackage.json ..\u002Fserver\u002Fpackage.json 2>\u002Fdev\u002Fnull\n\n# iOS counterpart app\nls ..\u002Fios ..\u002FYourApp-iOS 2>\u002Fdev\u002Fnull\nfind .. -maxdepth 3 -name \"*.xcodeproj\" 2>\u002Fdev\u002Fnull | head -3\n```\n\nIf a backend or related platform exists without Sentry, suggest the matching skill:\n\n| Detected | Suggest skill |\n|----------|--------------|\n| Go backend (`go.mod`) | `sentry-go-sdk` |\n| Python backend (`requirements.txt`, `pyproject.toml`) | `sentry-python-sdk` |\n| Ruby backend (`Gemfile`) | `sentry-ruby-sdk` |\n| Node.js backend | `@sentry\u002Fnode` — see [docs.sentry.io\u002Fplatforms\u002Fjavascript\u002Fguides\u002Fexpress\u002F](https:\u002F\u002Fdocs.sentry.io\u002Fplatforms\u002Fjavascript\u002Fguides\u002Fexpress\u002F) |\n| iOS app (`.xcodeproj`) | `sentry-cocoa-sdk` |\n| React Native (`package.json` with `react-native`) | `sentry-react-native-sdk` |\n| React \u002F Next.js web | `sentry-react-sdk` or `sentry-nextjs-sdk` |\n\n**Distributed tracing setup** — if the backend skill is added, configure `tracePropagationTargets` in Android to propagate trace context to your API:\n\n```kotlin\noptions.tracePropagationTargets = listOf(\n    \"api.yourapp.com\",\n    \".*\\\\.yourapp\\\\.com\"\n)\n```\n\nThis links mobile transactions to backend traces in the Sentry waterfall view.\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n|-------|----------|\n| Events not appearing in Sentry | Set `isDebug = true`, check Logcat for SDK errors; verify DSN is correct and matches your project |\n| `SentryAndroid.init()` not called | Confirm `android:name=\".MyApplication\"` is set in `AndroidManifest.xml`; Application class not abstract |\n| Gradle plugin not found | Add the plugin to project-level `build.gradle.kts` first, then `apply false`; verify version `6.1.0` |\n| ProGuard mapping not uploading | Set `SENTRY_AUTH_TOKEN` env var; ensure `autoUploadProguardMapping = true` in `sentry {}` block |\n| NDK crashes not captured | Verify `isEnableNdk = true` (default); ensure project has NDK configured in `android.ndkVersion` |\n| ANR reported in debugger | Set `isAnrReportInDebug = false` (default); ANR watchdog fires when debugger pauses threads |\n| Session replay not recording | Requires API 26+; verify `sessionSampleRate > 0` or `onErrorSampleRate > 0`; check Logcat for replay errors |\n| Session replay shows blank screen | PixelCopy (default) requires hardware acceleration; try `SentryReplayOptions.screenshotQuality = CANVAS` |\n| Replay masking misaligned | Views with `translationX\u002FY` or `clipToPadding=false` can offset masks; report to [github.com\u002Fgetsentry\u002Fsentry-java](https:\u002F\u002Fgithub.com\u002Fgetsentry\u002Fsentry-java) |\n| `beforeSend` not firing | `beforeSend` only intercepts managed (Java\u002FKotlin) events; NDK native crashes bypass it |\n| OkHttp spans not appearing | Add `SentryOkHttpInterceptor` to your `OkHttpClient`, or use Gradle plugin `OKHTTP` bytecode instrumentation |\n| Spans not attached to transaction | Ensure `TransactionOptions().setBindToScope(true)` when starting transaction; child spans look for scope root |\n| Tracing not recording | Verify `tracesSampleRate > 0`; Activity instrumentation requires `isEnableAutoActivityLifecycleTracing = true` (default) |\n| Continuous profiling not working | SDK ≥ 8.7.0 required; API 22+ required; set `profileSessionSampleRate > 0`; don't also set `profilesSampleRate` |\n| Both profiling modes set | `profilesSampleRate` and `profileSessionSampleRate` are mutually exclusive — use only one |\n| TTFD spans missing | Set `isEnableTimeToFullDisplayTracing = true` and call `Sentry.reportFullyDisplayed()` when screen is ready |\n| Kotlin coroutine scope lost | Add `sentry-kotlin-extensions` dependency; use `Sentry.cloneMainContext()` to propagate trace context |\n| Release build stack traces unreadable | ProGuard mapping not uploaded; confirm Gradle plugin `autoUploadProguardMapping = true` and auth token set |\n| Source context not showing in Sentry | Enable `includeSourceContext = true` in `sentry {}` block (Gradle plugin required) |\n| BOM version conflict | Use `implementation(platform(\"io.sentry:sentry-bom:8.33.0\"))` and omit versions from all other `io.sentry:*` entries |\n| Version catalog alias unresolved | After editing `gradle\u002Flibs.versions.toml`, sync Gradle; alias names use `-` in TOML and `.` in build files (e.g., `sentry-android` → `libs.sentry.android`) |\n| Duplicate Sentry version in catalog | Reuse the existing `[versions] sentry = \"...\"` entry; don't add a second key, and don't hardcode the version in `build.gradle` when the catalog is in use |\n| `SENTRY_AUTH_TOKEN` exposed | Auth token is build-time only — never pass it to `SentryAndroid.init()` or embed in the APK |\n",{"name":5,"parent":24,"license":15,"category":25,"description":7,"disable-model-invocation":26},"sentry-sdk-setup","sdk-setup",true,"main","b1e4ffadb4f933bbbcaa03a83f8b9929171ac28b",".agents\u002Fskills\u002Fsentry-android-sdk",0,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR","https:\u002F\u002Fgithub.com\u002FHazek-dc","2026-10-22 08:36:44",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":26},[36,39,42],{"tool":37,"command":38},"npx","npx skills add Hazek-dc\u002FPresensiGuru_FaceNet_EMAR --skill sentry-android-sdk",{"tool":40,"command":41},"bunx","bunx skills add Hazek-dc\u002FPresensiGuru_FaceNet_EMAR --skill sentry-android-sdk",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Hazek-dc\u002FPresensiGuru_FaceNet_EMAR --skill sentry-android-sdk","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-android-sdk\u002FSKILL.md",[47,53,57,61,65,69,73,77],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"references\u002Fcrons.md","REFERENCE","参考文档",11749,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-android-sdk\u002Freferences\u002Fcrons.md",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"references\u002Ferror-monitoring.md",26639,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-android-sdk\u002Freferences\u002Ferror-monitoring.md",{"path":58,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":59,"sourceHtmlUrl":60},"references\u002Fintegrations.md",2815,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-android-sdk\u002Freferences\u002Fintegrations.md",{"path":62,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Flogging.md",12621,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-android-sdk\u002Freferences\u002Flogging.md",{"path":66,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":67,"sourceHtmlUrl":68},"references\u002Fmetrics.md",9201,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-android-sdk\u002Freferences\u002Fmetrics.md",{"path":70,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":71,"sourceHtmlUrl":72},"references\u002Fprofiling.md",14915,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-android-sdk\u002Freferences\u002Fprofiling.md",{"path":74,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":75,"sourceHtmlUrl":76},"references\u002Fsession-replay.md",15183,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-android-sdk\u002Freferences\u002Fsession-replay.md",{"path":78,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":79,"sourceHtmlUrl":80},"references\u002Ftracing.md",28717,"https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsentry-android-sdk\u002Freferences\u002Ftracing.md",[82,90,97,104,111,118],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":86,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M7DS6GGYRZAYD33PFPS8Z2T3","testing-best-practices","Laravel test design and review. Use when selecting coverage, naming or structuring tests, choosing assertions or test data, isolating dependencies, testing HTTP or security boundaries, improving suite performance, or reviewing test value. Use framework guidance or search-docs for Pest and PHPUnit syntax.","MIT","https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002Fattendance-web\u002F.claude\u002Fskills\u002Ftesting-best-practices\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":86,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M7DS6BC3AW7HTPRHE2TTVKWM","tailwindcss-development","Always invoke when the user's message includes 'tailwind' in any form. Also invoke for: building responsive grid layouts (multi-column card grids, product grids), flex\u002Fgrid page structures (dashboards with sidebars, fixed topbars, mobile-toggle navs), styling UI components (cards, tables, navbars, pricing sections, forms, inputs, badges), adding dark mode variants, fixing spacing or typography, and Tailwind v3\u002Fv4 work. The core use case: writing or fixing Tailwind utility classes in HTML templates (Blade, JSX, Vue). Skip for backend PHP logic, database queries, API routes, JavaScript with no HTML\u002FCSS component, CSS file audits, build tool configuration, and vanilla CSS.","https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002Fattendance-web\u002F.claude\u002Fskills\u002Ftailwindcss-development\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":86,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M7DS66GE6B11MYJDVC74HXM4","laravel-best-practices","Apply this skill whenever writing, reviewing, or refactoring Laravel PHP code. This includes creating or modifying controllers, models, migrations, form requests, policies, jobs, scheduled commands, service classes, and Eloquent queries. Triggers for N+1 and query performance issues, caching strategies, authorization and security patterns, validation, error handling, queue and job configuration, route definitions, and architectural decisions. Also use for Laravel code reviews and refactoring existing Laravel code to follow best practices. Covers any task involving Laravel backend PHP code patterns.","https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002Fattendance-web\u002F.claude\u002Fskills\u002Flaravel-best-practices\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":86,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":19},"01M7DS5ZW717DMS6P1E90AQCKV","infer-conventions","Use this skill to analyze how a Laravel application is actually written and record its conventions as shared rules. Trigger when the user wants to detect, infer, document, or standardize project conventions or coding style, set up or grow `.ai\u002Frules`, resolve mixed or conflicting patterns (e.g. \"are we using Form Requests or inline validation?\"), or onboard agents and teammates to \"how we do things here\". Covers: a systematic sweep of ~49 Laravel convention dimensions (validation, models, architecture, testing, frontend, database, console), open-ended house-pattern discovery, conflict reporting, and recording rules scoped to the right paths via the Boost `record-rule` MCP tool. Only run this skill when the user explicitly asks for it; never start a sweep as part of another task. Do not use for one-off code review, enforcing formatting a linter already handles, or editing `.ai\u002Frules` files by hand.","https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002Fattendance-web\u002F.claude\u002Fskills\u002Finfer-conventions\u002FSKILL.md",[],[],{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":86,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":19},"01M7DS5W12RGCVJTFQJ1N0GB8E","inertia-react-development","Develops Inertia.js v2 React client-side applications. Activates when creating React pages, forms, or navigation; using \u003CLink>, \u003CForm>, useForm, or router; working with deferred props, prefetching, or polling; or when user mentions React with Inertia, React pages, React forms, or React navigation.","https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002Fattendance-web\u002F.claude\u002Fskills\u002Finertia-react-development\u002FSKILL.md",[],[],{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":86,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":124,"publishedAt":19},"01M7DS5PVDPMPCWSK2RXPDC9BB","deploying-to-cloud","Deploys and manages Laravel applications on Laravel Cloud using the `cloud` CLI. Use when the user wants to deploy an app, ship to Cloud, create or manage applications, environments, databases, caches, object storage, queues, domains, instances, background processes, secrets, compute, scheduled tasks, or Laravel Cloud infrastructure; or check billing, usage, or spend. Triggers on deployment, shipping, Cloud management, environment setup, database provisioning, billing or usage queries, the `cloud` CLI, and Laravel Cloud deployment troubleshooting.","https:\u002F\u002Fgithub.com\u002FHazek-dc\u002FPresensiGuru_FaceNet_EMAR\u002Fblob\u002Fmain\u002Fattendance-web\u002F.claude\u002Fskills\u002Fdeploying-to-cloud\u002FSKILL.md",[],[]]