feat(replay): Record segment names on Android

packages/flutter/lib/src/integrations/replay_telemetry_integration.dart

@@ -61,6 +61,11 @@ class ReplayTelemetryIntegration implements Integration<SentryFlutterOptions> {
       if (attributes != null) {
         event.span.setAttributes(attributes);
       }
+
+      final span = event.span;
+      if (identical(span, span.segmentSpan)) {
+        return _native?.registerSegmentName(span.name);
+      }
     };
 
     _onGenerateNewTrace = (OnGenerateNewTrace event) async {

packages/flutter/lib/src/native/c/sentry_native.dart

@@ -329,6 +329,11 @@ class SentryNative with SentryNativeSafeInvoker implements SentryNativeBinding {
   FutureOr<void> registerTraceId(SentryId traceId) {
     // No-op. Replay trace ID registration is currently Android-only.
   }
+
+  @override
+  FutureOr<void> registerSegmentName(String segmentName) {
+    // No-op. Replay segment name registration is currently Android-only.
+  }
 }
 
 extension SentryValueExtension on binding.sentry_value_u {

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

@@ -294,6 +294,22 @@ class SentryNativeJava extends SentryNativeChannel {
       });
     });
   }
+
+  @override
+  void registerSegmentName(String segmentName) {
+    if (segmentName.isEmpty) {
+      return;
+    }
+
+    tryCatchSync('registerSegmentName', () {
+      using((arena) {
+        final jSegmentName = segmentName.toJString()..releasedBy(arena);
+        _nativeReplay ??=
+            native.SentryFlutterPlugin.privateSentryGetReplayIntegration();
+        _nativeReplay?.registerSegmentName(jSegmentName);
+      });
+    });
+  }
 }
 
 // Direct JNI conversion is fine for primitives. Use the Map/List conversion

packages/flutter/lib/src/native/sentry_native_binding.dart

@@ -102,4 +102,7 @@ abstract class SentryNativeBinding {
 
   /// Registers the active Dart trace ID with native replay.
   FutureOr<void> registerTraceId(SentryId traceId);
+
+  /// Registers a segment name with native replay for the current replay segment.
+  FutureOr<void> registerSegmentName(String segmentName);
 }

packages/flutter/lib/src/native/sentry_native_channel.dart

@@ -445,4 +445,9 @@ class SentryNativeChannel
   FutureOr<void> registerTraceId(SentryId traceId) {
     // No-op. Replay trace ID registration is currently Android-only.
   }
+
+  @override
+  FutureOr<void> registerSegmentName(String segmentName) {
+    // No-op. Replay segment name registration is currently Android-only.
+  }
 }

packages/flutter/lib/src/web/sentry_web.dart

@@ -271,6 +271,11 @@ class SentryWeb with SentryNativeSafeInvoker implements SentryNativeBinding {
     // No-op. Replay trace ID registration is currently Android-only.
   }
 
+  @override
+  FutureOr<void> registerSegmentName(String segmentName) {
+    // No-op. Replay segment name registration is currently Android-only.
+  }
+
   @override
   int? startProfiler(SentryId traceId) {
     _logNotSupported('start profiler');

packages/flutter/test/integrations/replay_telemetry_integration_test.dart

@@ -117,6 +117,31 @@ void main() {
 
         verifyNever(fixture.nativeBinding.registerTraceId(any));
       });
+
+      test('registers segment name with native replay', () async {
+        fixture.options.replay.sessionSampleRate = 0.5;
+
+        await fixture.getSut().call(fixture.hub, fixture.options);
+        clearInteractions(fixture.nativeBinding);
+        final span = fixture.createTestSpan(name: 'CheckoutScreen');
+        await fixture.options.lifecycleRegistry
+            .dispatchCallback(OnProcessSpan(span));
+
+        verify(fixture.nativeBinding.registerSegmentName('CheckoutScreen'))
+            .called(1);
+      });
+
+      test('does not register segment name for child spans', () async {
+        fixture.options.replay.sessionSampleRate = 0.5;
+
+        await fixture.getSut().call(fixture.hub, fixture.options);
+        clearInteractions(fixture.nativeBinding);
+        final span = fixture.createChildTestSpan();
+        await fixture.options.lifecycleRegistry
+            .dispatchCallback(OnProcessSpan(span));
+
+        verifyNever(fixture.nativeBinding.registerSegmentName(any));
+      });
     });
 
     group('in session mode', () {
@@ -346,6 +371,21 @@ void main() {
 
         verifyNever(fixture.nativeBinding.registerTraceId(any));
       });
+
+      test('does not register segment name with native replay', () async {
+        fixture.options.replay.sessionSampleRate = 0.5;
+
+        final sut = fixture.getSut();
+        await sut.call(fixture.hub, fixture.options);
+        await sut.close();
+        clearInteractions(fixture.nativeBinding);
+
+        final span = fixture.createTestSpan(name: 'CheckoutScreen');
+        await fixture.options.lifecycleRegistry
+            .dispatchCallback(OnProcessSpan(span));
+
+        verifyNever(fixture.nativeBinding.registerSegmentName(any));
+      });
     });
   });
 }
@@ -370,6 +410,7 @@ class Fixture {
     });
     when(nativeBinding.replayId).thenReturn(null);
     when(nativeBinding.registerTraceId(any)).thenReturn(null);
+    when(nativeBinding.registerSegmentName(any)).thenReturn(null);
   }
 
   SentryLog createTestLog() => SentryLog(
@@ -388,8 +429,9 @@ class Fixture {
         attributes: <String, SentryAttribute>{},
       );
 
-  RecordingSentrySpanV2 createTestSpan() => RecordingSentrySpanV2.root(
-        name: 'test-span',
+  RecordingSentrySpanV2 createTestSpan({String name = 'test-span'}) =>
+      RecordingSentrySpanV2.root(
+        name: name,
         traceId: SentryId.newId(),
         onSpanEnd: (_) async {},
         clock: options.clock,

packages/flutter/test/mocks.mocks.dart

@@ -2103,6 +2103,13 @@ class MockSentryNativeBinding extends _i1.Mock
         #registerTraceId,
         [traceId],
       )) as _i12.FutureOr<void>);
+
+  @override
+  _i12.FutureOr<void> registerSegmentName(String? segmentName) =>
+      (super.noSuchMethod(Invocation.method(
+        #registerSegmentName,
+        [segmentName],
+      )) as _i12.FutureOr<void>);
 }
 
 /// A class which mocks [SentryDelayedFramesTracker].