cc @getsentry/support

Summary

The sentry-android-sdk skill is 10 versions behind (documents 8.33.0, latest is 8.43.0) and missing multiple new configuration options, APIs, and behavioral changes introduced since January 2025.

Critical: The skill also references the archived repo getsentry/sentry-android — the Android SDK is now maintained in getsentry/sentry-java.

New Features to Document

8.43.0 (latest)

• ReplayFrameObserver (experimental): options.sessionReplay.frameObserver for observing captured replay frames
• ART memory parsing: Automatic enhancement for ANR events (no config needed, mention as feature benefit)

8.42.0

• Raw tombstone attachment: options.isAttachRawTombstone = true / manifest io.sentry.tombstone.attach-raw
• Historical ANR manifest config: io.sentry.anr.report-historical attribute
• Gradle plugin: Bump recommended version from 6.1.0 → 6.6.0

8.41.0

• Session Replay SurfaceView capture: options.sessionReplay.isCaptureSurfaceViews = true (experimental, Unity/video/maps)
• New Feedback API: Sentry.feedback().show() and .capture() (replaces deprecated showUserFeedbackDialog)
• Per-form shake gesture: SentryUserFeedbackForm.Builder(...).configurator { it.isUseShakeGesture = true }

8.37.0

• Replay beforeErrorSampling: options.sessionReplay.beforeErrorSampling callback to filter which errors trigger replay

8.36.0

• Shake-to-report feedback: options.getFeedbackOptions().setUseShakeGesture(true) / manifest io.sentry.feedback.use-shake-gesture

8.35.0

• ANR profiling: options.setAnrProfilingSampleRate(1.0) / manifest io.sentry.anr.profiling.sample-rate
• ANR fingerprinting: Enabled by default (enableAnrFingerprinting = true) to group system-only ANRs

8.34.0

• Screenshot masking: New options.screenshot.setMaskAllText(true), setMaskAllImages(true), addMaskViewClass() (requires sentry-android-replay)
• Scope attributes API: Sentry.setAttribute(), setAttributes(), removeAttribute()

8.32.0

• Tombstone integration: options.isTombstoneEnabled = true / manifest io.sentry.tombstone.enable (Android 12+, native crashes via ApplicationExitInfo)
• Database transaction tracing: options.enableDatabaseTransactionTracing = true (BEGIN/COMMIT/ROLLBACK spans)
• Target SDK: Updated to API 36 (Android 16)

8.30.0

• Metrics API: Sentry.metrics().count(), .gauge(), .distribution() (enabled by default)
• External storage context: Now disabled by default; re-enable via options.isCollectExternalStorageContext = true

8.28.0

• Session Replay network details: OkHttp request/response body capture via options.sessionReplay.networkDetailAllowUrls, networkRequestHeaders, networkResponseHeaders

Behavioral Changes

1. ANR fingerprinting is now enabled by default (8.35.0) — may affect issue grouping
2. External storage context is now disabled by default (8.30.0) — opt back in if needed
3. Spotlight integration moved to separate module (8.32.0) — add io.sentry:sentry-spotlight for debug builds
4. Deprecated APIs (8.41.0): showUserFeedbackDialog(), captureFeedback(), SentryUserFeedbackButton — migrate to Sentry.feedback()

Affected Skill Sections

• Line 23: Version references (8.33.0 → 8.43.0, plugin 6.1.0 → 6.6.0)
• Configuration Reference (lines 564-636): Add new options tables for ANR profiling, screenshot masking, tombstone, replay observers, feedback shake gesture, database transaction tracing
• Logging section (lines 631-635): Note metrics API is separate from logging
• Session Replay section: Add SurfaceView capture, network details, beforeErrorSampling, frameObserver
• User Feedback section: Document new Sentry.feedback() API, deprecation notices, shake gesture
• Environment Variables (lines 638-663): No changes needed (manifest options covered in config tables)
• Troubleshooting: Add entries for screenshot masking, tombstone integration, ANR profiling

Reviewed PRs

• #5428: Parse ART memory from ANR tombstones
• #5386: Add ReplayFrameObserver

Plus changelog review for versions 8.34.0–8.43.0.

Notes

This update spans 10 SDK releases with significant API surface expansion. Recommend:

1. Prioritize documenting the most user-facing features (ANR profiling, screenshot masking, feedback API, tombstone integration)
2. Add deprecation warnings for old feedback APIs
3. Verify Gradle plugin compatibility (6.6.0 requires specific AGP versions)
4. Consider splitting Session Replay advanced features into a separate reference file if the main skill becomes too large