Add enableTombstone option for native crash reporting on Android (#3526)

* feat(flutter): Add enableTombstone option for improved native crash reporting

Add `enableTombstone` option to SentryFlutterOptions that enables tombstone-based
native crash reporting on Android 12+ (API level 30+).

When enabled, uses Android's `ApplicationExitInfo.REASON_CRASH_NATIVE` to capture
native crashes with more detailed thread information.

The option is disabled by default.

Slack thread: https://sentry.slack.com/archives/CP4UUUF1S/p1771404252312029?thread_ts=1769055443.846779&cid=CP4UUUF1S

https://claude.ai/code/session_016kkosYW3XG2rhHafEfspqA

* Apply suggestion from @romtsn

* Add integration test

* Enable tombstone option in integration test

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Giancarlo Buenaflor <giancarlobuenaflor97@gmail.com>
Co-authored-by: Giancarlo Buenaflor <giancarlo.buenaflor@sentry.io>

Author: 3 people

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+### Features
+
+- Add `enableTombstone` option for improved native crash reporting on Android 12+ ([#3526](https://github.com/getsentry/sentry-dart/pull/3526))
+  - When enabled, uses Android's `ApplicationExitInfo.REASON_CRASH_NATIVE` to capture native crashes with more detailed thread information
+  - Disabled by default
+
 ### Fixes
 
 - Dont guard user attributes behind `sendDefaultPii` for logs and metrics ([#3524](https://github.com/getsentry/sentry-dart/pull/3524))

packages/flutter/example/integration_test/integration_test.dart

@@ -217,6 +217,7 @@ void main() {
         options.anrTimeoutInterval = const Duration(seconds: 2);
         options.connectionTimeout = const Duration(milliseconds: 1234);
         options.readTimeout = const Duration(milliseconds: 2345);
+        options.enableTombstone = true;
       });
     });
 
@@ -280,12 +281,15 @@ void main() {
       expect(findMatchingPackage, isNotNull);
     }
     expect(androidOptions.isEnableAutoTraceIdGeneration(), isFalse);
+    expect(androidOptions.isTombstoneEnabled(), isTrue);
+
     final androidProxy = androidOptions.getProxy();
     expect(androidProxy, isNotNull);
     expect(androidProxy!.getHost()?.toDartString(), 'proxy.local');
     expect(androidProxy.getPort()?.toDartString(), '8084');
     expect(androidProxy.getUser()?.toDartString(), 'u');
     expect(androidProxy.getPass()?.toDartString(), 'p');
+
     final r = androidOptions.getSessionReplay();
     expect(r.getQuality(), jni.SentryReplayOptions$SentryReplayQuality.HIGH);
     expect(r.getSessionSampleRate(), isNotNull);

packages/flutter/lib/src/native/java/sentry_native_java_init.dart

@@ -215,6 +215,7 @@ void configureAndroidOptions({
     androidOptions
         .setAnrTimeoutIntervalMillis(options.anrTimeoutInterval.inMilliseconds);
     androidOptions.setAnrEnabled(options.anrEnabled);
+    androidOptions.setTombstoneEnabled(options.enableTombstone);
     androidOptions.setAttachThreads(options.attachThreads);
     androidOptions.setAttachStacktrace(options.attachStacktrace);
 

packages/flutter/lib/src/sentry_flutter_options.dart

@@ -68,6 +68,12 @@ class SentryFlutterOptions extends SentryOptions {
   /// Available only for Android. Enabled by default.
   bool anrEnabled = true;
 
+  /// Enable or disable Tombstone reporting for improved native crash reporting.
+  /// When enabled, uses Android's `ApplicationExitInfo.REASON_CRASH_NATIVE` to
+  /// capture native crashes with more detailed thread information.
+  /// Available only for Android 12+ (API level 30+). Disabled by default.
+  bool enableTombstone = false;
+
   Duration _anrTimeoutInterval = Duration(milliseconds: 5000);
 
   /// ANR Timeout internal. Default is 5000 milliseconds or 5 seconds.

packages/flutter/test/sentry_flutter_options_test.dart

@@ -51,5 +51,12 @@ void main() {
       expect(options.enableMemoryPressureBreadcrumbs, isTrue);
       expect(options.enableAutoNativeBreadcrumbs, isFalse);
     });
+
+    testWidgets('enableTombstone defaults to false',
+        (WidgetTester tester) async {
+      final options = defaultTestOptions();
+
+      expect(options.enableTombstone, isFalse);
+    });
   });
 }