feat(sample): [Nav3 Lifecycle 5] Add multi-root scenarios

Add runnable multi-Activity and multi-Fragment Navigation 3 scenarios with shared transaction history so lifecycle handoffs can be exercised in the Android sample.\n\nRefs JAVA-274

Author: 0xadam-brown

sentry-android-navigation3/src/main/kotlin/io/sentry/compose/navigation3/SentryNavOptions.kt

@@ -3,7 +3,7 @@ package io.sentry.compose.navigation3
 import androidx.compose.runtime.Immutable
 import org.jetbrains.annotations.ApiStatus
 
-// Keep the default low: every captured entry may require argument extraction and recursive
+// Keep the default low, as every captured entry may require argument extraction and recursive
 // sanitization when navigation changes are observed.
 private const val DEFAULT_MAX_CAPTURED_BACK_STACK_ENTRIES = 5
 

sentry-android-navigation3/src/main/kotlin/io/sentry/compose/navigation3/lifecycle/StagedNavData.kt

@@ -4,7 +4,7 @@ import io.sentry.IScope
 import io.sentry.PropagationContext
 
 /**
- * Holds navigation state staged for publication: a screen name and back stack nav context.
+ * Holds navigation state staged for publication.
  *
  * Only state that occupies a single slot in the shared [IScope] is staged. Nav events (i.e.,
  * breadcrumbs) only append to the scope, so they can't overwrite another instance's data and are

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

@@ -208,6 +208,7 @@ dependencies {
   implementation(libs.androidx.navigation3.runtime)
   implementation(libs.androidx.navigation3.ui)
   implementation(libs.androidx.recyclerview)
+  implementation(libs.androidx.viewpager2)
   implementation(libs.androidx.browser)
   implementation(libs.androidx.room3.runtime)
   implementation(libs.bundles.androidx.room2)
@@ -230,6 +231,9 @@ dependencies {
 
   debugImplementation(projects.sentryAndroidDistribution)
   debugImplementation(libs.leakcanary)
+
+  testImplementation(libs.google.truth)
+  testImplementation(libs.kotlin.test.junit)
 }
 
 abstract class ToggleNativeLoggingTask : Exec() {

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

@@ -123,6 +123,30 @@
       android:screenOrientation="portrait"
       android:theme="@style/AppTheme.Main" />
 
+    <activity
+      android:name=".navigation.nav3.Nav3ProductsActivity"
+      android:exported="false"
+      android:screenOrientation="portrait"
+      android:theme="@style/AppTheme.Main" />
+
+    <activity
+      android:name=".navigation.nav3.Nav3CheckoutActivity"
+      android:exported="false"
+      android:screenOrientation="portrait"
+      android:theme="@style/AppTheme.Main" />
+
+    <!-- No screenOrientation: translucent Activities can't request one on Android 8.0. -->
+    <activity
+      android:name=".navigation.nav3.Nav3TranslucentCheckoutActivity"
+      android:exported="false"
+      android:theme="@style/AppTheme.Main.Translucent" />
+
+    <activity
+      android:name=".navigation.nav3.Nav3FragmentsActivity"
+      android:exported="false"
+      android:screenOrientation="portrait"
+      android:theme="@style/AppTheme.Main" />
+
     <activity
       android:name=".FrameDataForSpansActivity"
       android:exported="false" />

sentry-samples/sentry-samples-android/src/main/java/io/sentry/samples/android/navigation/nav3/Nav3Activity.kt

@@ -39,6 +39,8 @@ import androidx.compose.ui.ExperimentalComposeUiApi
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.draw.drawWithContent
 import androidx.compose.ui.platform.LocalContext
+import androidx.compose.ui.semantics.semantics
+import androidx.compose.ui.semantics.testTagsAsResourceId
 import androidx.navigation3.runtime.entryProvider
 import androidx.navigation3.ui.NavDisplay
 import io.sentry.compose.navigation3.SentryBackStackEntry
@@ -75,9 +77,6 @@ class Nav3Activity : ComponentActivity() {
 
   private var routeWorkOptions by mutableStateOf(setOf(RouteWorkOption.MANUAL_CHILD_SPAN))
 
-  private var isTransactionHistoryActive = false
-  private val transactionHistory =
-    NavigationTransactionHistory(isActive = { isTransactionHistoryActive })
   private var showTransactionHistorySheet by mutableStateOf(false)
 
   private var showActivityUiLoadTransactionDelayMessage = false
@@ -99,14 +98,14 @@ class Nav3Activity : ComponentActivity() {
       cancelCurrentActivityUiLoadTransaction()
     }
 
-    transactionHistory.install()
+    NavigationTransactionHistory.install()
 
     setContent {
       Nav3SampleTheme {
         Nav3SampleApp(
           performanceState = performanceState,
           configuration = configuration,
-          transactions = transactionHistory.transactions,
+          transactions = NavigationTransactionHistory.transactions,
           showActivityUiLoadTransactionDelayMessage = showActivityUiLoadTransactionDelayMessage,
           routeWorkOptions = routeWorkOptions,
           showTransactionHistorySheet = showTransactionHistorySheet,
@@ -124,13 +123,7 @@ class Nav3Activity : ComponentActivity() {
     }
   }
 
-  override fun onStart() {
-    super.onStart()
-    isTransactionHistoryActive = true
-  }
-
   override fun onStop() {
-    isTransactionHistoryActive = false
     performanceState.stopAutomaticWork()
     super.onStop()
   }
@@ -139,7 +132,6 @@ class Nav3Activity : ComponentActivity() {
     if (isFinishing) {
       previousConfig.applyToCurrentOptions()
     }
-    transactionHistory.uninstall()
     super.onDestroy()
   }
 
@@ -361,7 +353,9 @@ private fun Nav3SampleApp(
   }
 
   Scaffold(
-    modifier = Modifier.fillMaxSize().safeDrawingPadding(),
+    // Expose test tags as resource IDs so adb/uiautomator can target them.
+    modifier =
+      Modifier.fillMaxSize().safeDrawingPadding().semantics { testTagsAsResourceId = true },
     containerColor = MaterialTheme.colorScheme.background,
     topBar = {
       Nav3TopBar(
@@ -464,6 +458,28 @@ private fun Nav3SampleApp(
                 )
               }
             }
+            entry<Nav3Route.MultiActivity> { route ->
+              TracedNav3Route(route, selectedScenario) {
+                Nav3RouteWorkEffect(route, routeWorkOptions)
+                MultiActivityRoute {
+                  activity?.startActivity(
+                    Intent(activity, Nav3ProductsActivity::class.java)
+                      .putExtras(Bundle().apply { putNav3SampleConfiguration(configuration) })
+                  )
+                }
+              }
+            }
+            entry<Nav3Route.MultiFragment> { route ->
+              TracedNav3Route(route, selectedScenario) {
+                Nav3RouteWorkEffect(route, routeWorkOptions)
+                MultiFragmentRoute {
+                  activity?.startActivity(
+                    Intent(activity, Nav3FragmentsActivity::class.java)
+                      .putExtras(Bundle().apply { putNav3SampleConfiguration(configuration) })
+                  )
+                }
+              }
+            }
             entry<Nav3Route.Landing> { route ->
               TracedNav3Route(route, selectedScenario) {
                 Nav3RouteWorkEffect(route, routeWorkOptions)