[0xadam-brown]

PR Stack (Nav3 Lifecycle)

• feat(android): Nav3 support for multi-Activity and multi-Fragment applications #6301
• ref(android): [Nav3 Lifecycle 1] Add NavLeaseCoordinator #6302
• ref(android): [Nav3 Lifecycle 2] Add lease-aware NavScopes facade #6304
• feat(android): [Nav3 Lifecycle 3] Coordinate SentryNavEffect access to current IScope #6305
• test(android): [Nav3 Lifecycle 4] Integration tests for lifecycle handoffs #6307
• feat(sample): [Nav3 Lifecycle 5] Add Nav3 lifecycle scenarios to sample app #6309

---

📜 Description

Add runnable Navigation 3 sample flows for applications with multiple Activities and multiple Fragments, each hosting its own SentryNavEffect.

The sample records a shared navigation transaction history, labels transactions by Activity, and provides scenarios for Activity handoffs, Fragment replacement, dialogs, and ViewPager pages.

💡 Motivation and Context

These scenarios make the lifecycle behavior introduced by the stack directly observable and provide a practical harness for manual verification and future debugging.

addresses: JAVA-785

💚 How did you test it?

• Had my clanker perform lots of manual testing

📝 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

Merge the stack from Part 1 through Part 5 using merge commits, then squash-merge the collection PR into main.

#skip-changelog

⚠️ Merge this PR using a merge commit (not squash). Only the collection branch is squash-merged into main.

[linear-code]

JAVA-274

[github-actions]

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

Generated by 🚫 dangerJS against bfd5a9f

[sentry]

📲 Install Builds

Android

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

⚙️ sentry-android Build Distribution Settings

[cursor]

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

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

Want reviews to match your repository better? Bugbot Learning can learn team-specific rules from PR activity. A team admin can enable Learning in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 7039fb1. Configure here.}

[cursor]

History filter misses scenario tag

Medium Severity

tagCurrentNav3Scenario writes sample_nav3_scenario only onto Sentry.getSpan(), while activity and session tags are also applied on the scope transaction. History recording now drops any finished transaction missing sample_nav3_scenario. If the current span is a child, or the destination SideEffect runs before the navigation transaction exists, the sheet silently omits that transaction.

Additional Locations (1)

• sentry-samples/sentry-samples-android/src/main/java/io/sentry/samples/android/navigation/nav3/Nav3TransactionHistory.kt#L43-L48

 

^{Reviewed by Cursor Bugbot for commit 7039fb1. Configure here.}