feat(samples): Add Nav3 sample app (JAVA-274) (#6222)

Introduce a sample app for our Sentry Nav3 integration (SentryNavEffect). Key implementation classes are Nav3SetupActivity and Nav3Activity, each of which is closely modeled after the existing Nav2SetupActivity and Nav2Activity that back our Nav2 sample app.

Co-Authored-By: Codex <noreply@openai.com>

Author: 0xadam-brown

gradle/libs.versions.toml

@@ -3,6 +3,7 @@ animalsniffer = "2.0.1"
 apollo = "2.5.9"
 androidxLifecycle = "2.2.0"
 androidxNavigation = "2.9.8"
+androidxNavigation3 = "1.1.5"
 androidxTestCore = "1.7.0"
 androidxCompose = "1.9.5"
 asyncProfiler = "4.4"
@@ -109,6 +110,8 @@ androidx-lifecycle-process = { module = "androidx.lifecycle:lifecycle-process",
 androidx-navigation-runtime = { module = "androidx.navigation:navigation-runtime", version.ref = "androidxNavigation" }
 androidx-navigation-compose = { module = "androidx.navigation:navigation-compose", version.ref = "androidxNavigation" }
 androidx-navigation-fragment = { module = "androidx.navigation:navigation-fragment-ktx", version.ref = "androidxNavigation" }
+androidx-navigation3-runtime = { module = "androidx.navigation3:navigation3-runtime", version.ref = "androidxNavigation3" }
+androidx-navigation3-ui = { module = "androidx.navigation3:navigation3-ui", version.ref = "androidxNavigation3" }
 androidx-room-compiler = { module = "androidx.room:room-compiler", version.ref = "room2" }
 androidx-room-ktx = { module = "androidx.room:room-ktx", version.ref = "room2" }
 androidx-room-runtime = { module = "androidx.room:room-runtime", version.ref = "room2" }

sentry-samples/sentry-samples-android/README.md

@@ -21,6 +21,9 @@ You can also apply the [Sentry Android Gradle Plugin](https://github.com/getsent
 
 In Android Studio, add `useSagp=` (empty value) to `gradle.properties`, or pass `-PuseSagp` as a Gradle project property.
 
+For LLM-driven verification, use `adb` to inspect and interact with the running emulator. Compose-based screens often expose stable
+`Modifier.testTag()` values, which can be used with the UI hierarchy dump to locate controls reliably.
+
 ## Build modes
 
 ### With or without SAGP

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

@@ -187,6 +187,7 @@ dependencies {
   implementation(projects.sentryAndroid)
   implementation(projects.sentryAndroidFragment)
   implementation(projects.sentryAndroidNavigation)
+  implementation(projects.sentryAndroidNavigation3)
   implementation(projects.sentryAndroidSqlite)
   implementation(projects.sentryAndroidTimber)
   implementation(projects.sentryCompose)
@@ -212,6 +213,8 @@ dependencies {
   implementation(libs.androidx.compose.material.icons.extended)
   implementation(libs.androidx.navigation.compose)
   implementation(libs.androidx.navigation.fragment)
+  implementation(libs.androidx.navigation3.runtime)
+  implementation(libs.androidx.navigation3.ui)
   implementation(libs.androidx.recyclerview)
   implementation(libs.androidx.browser)
   implementation(libs.androidx.room3.runtime)

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

@@ -112,6 +112,17 @@
       android:screenOrientation="portrait"
       android:theme="@style/AppTheme.Main" />
 
+    <activity
+      android:name=".navigation.nav3.Nav3SetupActivity"
+      android:exported="false"
+      android:theme="@style/AppTheme.Main" />
+
+    <activity
+      android:name=".navigation.nav3.Nav3Activity"
+      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/MainActivity.kt

@@ -93,6 +93,7 @@ import io.sentry.compose.SentryTraced
 import io.sentry.protocol.Feedback
 import io.sentry.protocol.User
 import io.sentry.samples.android.memory.MemoryLimiterActivity
+import io.sentry.samples.android.navigation.nav3.Nav3SetupActivity
 import java.io.File
 import java.io.FileOutputStream
 import java.io.IOException
@@ -912,6 +913,16 @@ fun IntegrationsScreen() {
         }
       }
     }
+    item {
+      SentryTraced("open_nav3_activity") {
+        OutlinedButton(
+          onClick = { activity.startActivity(Intent(activity, Nav3SetupActivity::class.java)) },
+          modifier = Modifier,
+        ) {
+          Text("Open Nav3 Activity", maxLines = 2, overflow = TextOverflow.Ellipsis)
+        }
+      }
+    }
     item {
       SentryTraced("open_sample_fragment") {
         OutlinedButton(

sentry-samples/sentry-samples-android/src/main/java/io/sentry/samples/android/navigation/README.md

@@ -0,0 +1,32 @@
+# Nav2 and Nav3 Samples
+
+## Nav Sample Transaction Tips
+
+When inspecting route-level transactions from `Nav2Activity` or `Nav3Activity`, note that the sample app also enables automatic Activity
+tracing by default. That can produce overlapping `ui.load` transactions for the Activity itself, which may make it harder to isolate the
+navigation transactions generated by the Nav2 or Nav3 integrations.
+
+If you want the route transactions to be the primary trace surface while testing those sample screens, temporarily disable automatic
+Activity tracing in `src/main/AndroidManifest.xml`:
+
+```xml
+<meta-data
+  android:name="io.sentry.traces.activity.enable"
+  android:value="false" />
+```
+
+This is mainly useful for debugging and comparison in the sample app. It is not a general recommendation for production apps.
+
+## Navigation Performance Scenarios
+
+Both navigation samples include an interactive performance scenario for exercising stack mutations and route rendering.
+
+### Nav2
+
+Open Nav2 from the integrations screen, select the `Performance` tab, and use the controls to build a stack or replace the top destination.
+The sample also supports automatic recompositions and navigation for sustained stress testing.
+
+### Nav3
+
+Open Nav3 from the integrations screen, select the `Performance` tab, and use the presets or performance controls to run a scenario with the
+desired stack depth, workload, integration mode, and argument shape.

sentry-samples/sentry-samples-android/src/main/java/io/sentry/samples/android/navigation/nav2/Nav2TransactionHistory.kt

@@ -76,7 +76,8 @@ internal data class Nav2TraceSpan(
 private fun SentryTransaction.toNav2TransactionTrace(dsn: String?): Nav2TransactionTrace {
   val trace = contexts.trace
   val startTimestamp = startTimestamp
-  val endTimestamp = timestamp ?: startTimestamp
+  val endTimestamp =
+    timestamp ?: spans.mapNotNull { span -> span.timestamp }.maxOrNull() ?: startTimestamp
   val durationMillis = ((endTimestamp - startTimestamp) * 1_000.0).coerceAtLeast(0.0)
   val rootSpanId = trace?.spanId?.toString()
   val traceId = trace?.traceId?.toString().orEmpty()