chore(samples): Add Mapbox MapsActivity to exercise SurfaceView replay capture

Scaffolds a simple Mapbox-backed MapsActivity in the sample app so the
new experimental captureSurfaceViews option can be exercised end-to-end.
Mapbox 11.x renders into a SurfaceView by default, which previously
appeared as a transparent hole in Session Replay recordings (GH-4862).

Also flips the sample's replay strategy to pixelCopy and relaxes default
masking so maps and text are visible in the replay, and switches
MyApplication to manual SentryAndroid.init so we can set the new
captureSurfaceViews option programmatically.

The Mapbox SDK requires MAPBOX_DOWNLOADS_TOKEN in ~/.gradle/gradle.properties
and a public access token wired into the app (R.string.mapbox_access_token
or MapboxOptions.accessToken).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: romtsn

sentry-samples/sentry-samples-android/build.gradle.kts

@@ -129,6 +129,8 @@ dependencies {
   implementation(projects.sentryOkhttp)
   implementation(projects.sentrySpotlight)
 
+  implementation("com.mapbox.maps:android:11.16.2")
+
   //    how to exclude androidx if release health feature is disabled
   //    implementation(projects.sentryAndroid) {
   //        exclude(group = "androidx.lifecycle", module = "lifecycle-process")

sentry-samples/sentry-samples-android/src/main/AndroidManifest.xml

@@ -88,6 +88,10 @@
       android:name=".TriggerHttpRequestActivity"
       android:exported="false" />
 
+    <activity
+      android:name=".MapsActivity"
+      android:exported="false" />
+
     <!--    NOTE: Replace the test DSN below with YOUR OWN DSN to see the events from this app in your Sentry project/dashboard-->
     <meta-data
       android:name="io.sentry.dsn"
@@ -116,7 +120,9 @@
     <!--    <meta-data android:name="io.sentry.anr.enable" android:value="false" />-->
 
     <!--    how to disable the auto-init-->
-    <!--    <meta-data android:name="io.sentry.auto-init" android:value="false" />-->
+    <meta-data
+      android:name="io.sentry.auto-init"
+      android:value="false" />
 
     <!--    how to disable the NDK-->
     <!--    <meta-data android:name="io.sentry.ndk.enable" android:value="false" />-->
@@ -227,13 +233,16 @@
 
     <meta-data
       android:name="io.sentry.session-replay.screenshot-strategy"
-      android:value="canvas" />
+      android:value="pixelCopy" />
     <meta-data
       android:name="io.sentry.session-replay.session-sample-rate"
       android:value="1" />
     <meta-data
       android:name="io.sentry.session-replay.mask-all-text"
-      android:value="true" />
+      android:value="false" />
+    <meta-data
+      android:name="io.sentry.session-replay.mask-all-images"
+      android:value="false" />
 
     <!-- Testing Network Details  -->
     <!-- Catpure network details for all urls -->

sentry-samples/sentry-samples-android/src/main/java/io/sentry/samples/android/MainActivity.kt

@@ -709,6 +709,16 @@ fun IntegrationsScreen() {
         }
       }
     }
+    item {
+      SentryTraced("open_maps_activity") {
+        OutlinedButton(
+          onClick = { activity.startActivity(Intent(activity, MapsActivity::class.java)) },
+          modifier = Modifier,
+        ) {
+          Text("Open Maps Activity", maxLines = 2, overflow = TextOverflow.Ellipsis)
+        }
+      }
+    }
     item {
       SentryTraced("throw_in_coroutine") {
         OutlinedButton(onClick = { CoroutinesUtil.throwInCoroutine() }, modifier = Modifier) {

sentry-samples/sentry-samples-android/src/main/java/io/sentry/samples/android/MapsActivity.kt

@@ -0,0 +1,33 @@
+package io.sentry.samples.android
+
+import android.os.Bundle
+import androidx.appcompat.app.AppCompatActivity
+import com.mapbox.geojson.Point
+import com.mapbox.maps.CameraOptions
+import com.mapbox.maps.MapView
+import com.mapbox.maps.Style
+
+/**
+ * Hosts a full-screen Mapbox [MapView] to test Session Replay's SurfaceView capture path. By
+ * default Mapbox 11.x renders into a [android.view.SurfaceView], so this screen will be all black
+ * in replays without `SentryReplayOptions.isCaptureSurfaceViews = true`.
+ *
+ * Requires `MAPBOX_DOWNLOADS_TOKEN` in `~/.gradle/gradle.properties` to resolve the SDK and a
+ * public access token wired into `R.string.mapbox_access_token` (or set via
+ * `MapboxOptions.accessToken`).
+ */
+class MapsActivity : AppCompatActivity() {
+
+  private lateinit var mapView: MapView
+
+  override fun onCreate(savedInstanceState: Bundle?) {
+    super.onCreate(savedInstanceState)
+    mapView = MapView(this)
+    setContentView(mapView)
+
+    mapView.mapboxMap.setCamera(
+      CameraOptions.Builder().center(Point.fromLngLat(-0.1276, 51.5072)).zoom(10.0).build()
+    )
+    mapView.mapboxMap.loadStyle(Style.STANDARD)
+  }
+}

sentry-samples/sentry-samples-android/src/main/java/io/sentry/samples/android/MyApplication.java

@@ -3,6 +3,7 @@
 import android.app.Application;
 import android.os.StrictMode;
 import io.sentry.Sentry;
+import io.sentry.android.core.SentryAndroid;
 
 /** Apps. main Application. */
 public class MyApplication extends Application {
@@ -13,19 +14,15 @@ public void onCreate() {
     strictMode();
     super.onCreate();
 
-    // Example how to initialize the SDK manually which allows access to SentryOptions callbacks.
-    // Make sure you disable the auto init via manifest meta-data: io.sentry.auto-init=false
-    // SentryAndroid.init(
-    //    this,
-    //    options -> {
-    //      /*
-    //      use options, for example, to add a beforeSend callback:
-    //
-    //      options.setBeforeSend((event, hint) -> {
-    //        process event
-    //      });
-    //       */
-    //    });
+    // Auto-init is disabled in the manifest so we can tweak SentryOptions here. All other options
+    // still come from the manifest meta-data (DSN, sample rates, replay config, etc.).
+    SentryAndroid.init(
+        this,
+        options -> {
+          // Experimental: capture SurfaceView content (e.g. Mapbox, Unity, video players) so they
+          // don't appear as transparent holes in Session Replay recordings.
+          options.getSessionReplay().setCaptureSurfaceViews(true);
+        });
   }
 
   private void strictMode() {

sentry-samples/sentry-samples-android/src/main/res/values/strings.xml

@@ -56,4 +56,5 @@ Nulla interdum gravida augue, vel fringilla lorem bibendum vel. In hac habitasse
   <string name="open_camera_activity">Open Camera Activity</string>
   <string name="open_http_request_activity">Open Trigger HTTP Request Activity</string>
   <string name="trigger_okhttp_request">Trigger OkHttp Request</string>
+  <string name="open_maps_activity">Open Maps Activity</string>
 </resources>

settings.gradle.kts

@@ -12,6 +12,16 @@ dependencyResolutionManagement {
         google()
         mavenCentral()
         mavenLocal()
+        // Mapbox Maven repository — used by the sample's MapsActivity. Requires
+        // MAPBOX_DOWNLOADS_TOKEN in ~/.gradle/gradle.properties.
+        maven {
+            url = uri("https://api.mapbox.com/downloads/v2/releases/maven")
+            credentials {
+                username = "mapbox"
+                password = providers.gradleProperty("MAPBOX_DOWNLOADS_TOKEN").getOrElse("")
+            }
+            authentication { create<org.gradle.authentication.http.BasicAuthentication>("basic") }
+        }
     }
 }