feat(samples): Add Nav3 sample app (JAVA-274) by 0xadam-brown · Pull Request #6222 · getsentry/sentry-java

0xadam-brown · 2026-10-05T08:57:33Z

📜 Description

PR introduces a sample app for our Sentry Nav3 integration – in particular, SentryNavEffect.

The 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.

💡 Motivation and Context

Let's us verify Nav3 integration behavior end-to-end, and to see actual Sentry UI output.

Makes it easy for LLMs to verify behavior under development and after the fact.

addresses: JAVA-274

Screenshots

Setup Activity for enabling / disabling data generation and verifying compatibility with transactions based on Activities and user interactions

Basic flow for verifying nav transaction boundaries and data generation

View nav transactions in real time via bottom sheet

Flow for ensuring nav3 transactions continue to play nicely with custom transactions

Performance stress testing

💚 How did you test it?

Manually by installing the sample app and navigating through relevant flows.

📝 Checklist

I added GH Issue ID & Linear ID
I added tests to verify the changes.
No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled.
I updated the docs if needed.
I updated the wizard if needed.
Review from the native team if needed.
No breaking change or entry added to the changelog.
No breaking change for hybrid SDKs or communicated to hybrid SDKs.
Public API changes reviewed by another Mobile SDK team member or implemented according to the develop docs spec.

🔮 Next steps

Remove the @ApiStatus.Internal annotations from SentryNavEffect, SentryNavOptions, and BackStackEntryMapper + add an appropriate CHANGELOG entry + publish the sentry-android-navigation3 module via craft (link).
sentry-docs
Introduce a new rememberSentryEntryProvider() method that lets us extract Sentry back stack entry info from the mapping users already have to do on behalf of NavDisplay. (We don't have to hold up release of Nav3 support for this.)

#skip-changelog

linear-code · 2026-10-05T08:57:39Z

JAVA-274

github-actions · 2026-10-05T08:58:06Z

	Messages
📖	Do not forget to update Sentry-docs with your feature once the pull request gets approved.

Generated by 🚫 dangerJS against 8044d13

sentry · 2026-10-05T09:01:17Z

📲 Install Builds

Android

🔗 App Name	App ID	Version	Configuration
SDK Size	io.sentry.tests.size	8.59.0 (1)	release

⚙️ sentry-android Build Distribution Settings

cursor

Stale Bugbot comment from a previous run.

cursor

Stale Bugbot comment from a previous run.

cursor

Stale Bugbot comment from a previous run.

Restore the idle state after warm-up and keep integration-mode recompositions out of extractor and processed-call counters until real navigation work begins. Refs GH-6222 Co-Authored-By: Codex <[email protected]>

0xadam-brown · 2026-10-06T07:22:02Z

Rebased on an updated target; otherwise unchanged.

cursor

Stale Bugbot comment from a previous run.

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 <[email protected]>

Fall back to the single-stack route when saved route arguments are missing and remove unused extractor-count bookkeeping from performance measurements.\n\nCo-Authored-By: Codex <[email protected]>

Record the performance sample from a SideEffect so the SentryNavEffect DisposableEffect and its extractors have completed before timing is captured.\n\nCo-Authored-By: Codex <[email protected]>

Restore the idle state after warm-up and keep integration-mode recompositions out of extractor and processed-call counters until real navigation work begins. Refs GH-6222 Co-Authored-By: Codex <[email protected]>

0xadam-brown · 2026-10-06T09:41:00Z

Rebased on an updated target; otherwise unchanged.

Record performance counters after successful composition, finish stale custom transactions on return to the home route, and clear A/B measurement guards after restoring integration mode. Refs JAVA-274 Co-Authored-By: Codex <[email protected]>

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

There are 2 total unresolved issues (including 1 from previous review).

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 0b0196d. Configure here.}

Run performance counter updates once after SentryNavEffect setup for each back stack or integration-mode change. This preserves extractor guard ordering without including later Scaffold or NavDisplay work in timing measurements. Refs JAVA-274 Co-Authored-By: Codex <[email protected]>

Let the uncaught exception handler report crash-button failures so deduplication cannot turn them into handled events. Recognize Nav3 scenario tags when labeling transactions in the history sheet. Refs JAVA-274 Co-Authored-By: Codex <[email protected]>

0xadam-brown added the ship-it PR is ready to merge from a reviewer perspective label Oct 5, 2026

0xadam-brown requested review from adinauer, markushi, romtsn and runningcode as code owners October 5, 2026 08:57

sentry Bot reviewed Oct 5, 2026

View reviewed changes

Comment thread ...sentry-samples-android/src/main/java/io/sentry/samples/android/navigation/nav3/Nav3Routes.kt Outdated

cursor Bot reviewed Oct 5, 2026

View reviewed changes

Comment thread ...s-android/src/main/java/io/sentry/samples/android/navigation/nav3/Nav3PerformanceControls.kt Outdated

sentry Bot reviewed Oct 5, 2026

View reviewed changes

Comment thread ...ntry-samples-android/src/main/java/io/sentry/samples/android/navigation/nav3/Nav3Activity.kt Outdated

cursor Bot reviewed Oct 5, 2026

View reviewed changes

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

cursor Bot reviewed Oct 5, 2026

View reviewed changes

Comment thread ...ntry-samples-android/src/main/java/io/sentry/samples/android/navigation/nav3/Nav3Activity.kt Outdated

sentry Bot reviewed Oct 5, 2026

View reviewed changes

Comment thread ...s-android/src/main/java/io/sentry/samples/android/navigation/nav3/Nav3PerformanceControls.kt

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

0xadam-brown force-pushed the ref/extract-shared-sample-app-infra branch from bef6b0f to 5d20ce5 Compare October 6, 2026 03:53

0xadam-brown force-pushed the feat/nav3-sample-app branch from 24523ee to 17b7421 Compare October 6, 2026 07:21

cursor Bot reviewed Oct 6, 2026

View reviewed changes

sentry Bot reviewed Oct 6, 2026

View reviewed changes

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

Comment thread ...y-samples-android/src/main/java/io/sentry/samples/android/navigation/nav3/Nav3Performance.kt

romtsn approved these changes Oct 6, 2026

View reviewed changes

Base automatically changed from ref/extract-shared-sample-app-infra to main October 6, 2026 09:38

0xadam-brown and others added 5 commits October 6, 2026 11:39

fix(samples): Harden Nav3 state restoration

cf0785f

Fall back to the single-stack route when saved route arguments are missing and remove unused extractor-count bookkeeping from performance measurements.\n\nCo-Authored-By: Codex <[email protected]>

fix(samples): Measure Nav3 effect after application

76818d9

Record the performance sample from a SideEffect so the SentryNavEffect DisposableEffect and its extractors have completed before timing is captured.\n\nCo-Authored-By: Codex <[email protected]>

fix(nav3): Remove unverifiable Nav3 timing metrics

0bb37f1

fix(samples): Correct Nav3 measurement state

0b0196d

Restore the idle state after warm-up and keep integration-mode recompositions out of extractor and processed-call counters until real navigation work begins. Refs GH-6222 Co-Authored-By: Codex <[email protected]>

0xadam-brown force-pushed the feat/nav3-sample-app branch from 17b7421 to 0b0196d Compare October 6, 2026 09:40

cursor Bot reviewed Oct 6, 2026

View reviewed changes

Comment thread ...samples-android/src/main/java/io/sentry/samples/android/navigation/nav3/Nav3SampleTracing.kt

sentry Bot reviewed Oct 6, 2026

View reviewed changes

Comment thread ...es-android/src/main/java/io/sentry/samples/android/navigation/nav3/Nav3CustomTransactions.kt Outdated

0xadam-brown and others added 2 commits October 6, 2026 11:52

0xadam-brown enabled auto-merge (squash) October 6, 2026 10:00

sentry Bot reviewed Oct 6, 2026

View reviewed changes

Comment thread ...y-samples-android/src/main/java/io/sentry/samples/android/navigation/nav3/Nav3Performance.kt

0xadam-brown merged commit da4dbf8 into main Oct 6, 2026
71 of 72 checks passed

0xadam-brown deleted the feat/nav3-sample-app branch October 6, 2026 10:26

Conversation

0xadam-brown commented Oct 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📜 Description

💡 Motivation and Context

Screenshots

💚 How did you test it?

📝 Checklist

🔮 Next steps

Uh oh!

linear-code Bot commented Oct 5, 2026

Uh oh!

github-actions Bot commented Oct 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sentry Bot commented Oct 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📲 Install Builds

Android

Uh oh!

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

0xadam-brown commented Oct 6, 2026

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

0xadam-brown commented Oct 6, 2026

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

0xadam-brown commented Oct 5, 2026 •

edited

Loading

github-actions Bot commented Oct 5, 2026 •

edited

Loading

sentry Bot commented Oct 5, 2026 •

edited

Loading

cursor Bot left a comment •

edited

Loading

cursor Bot left a comment •

edited

Loading

cursor Bot left a comment •

edited

Loading

cursor Bot left a comment •

edited

Loading