[iOS, Mac] Fix OnBackButtonPressed not invoked for NavigationPage and Shell

[Dhivya-SF4094]

Note

Are you waiting for the changes in this PR to be merged?
It would be very helpful if you could test the resulting artifacts from this PR and let us know in a comment if this change resolves your issue. Thank you!

Issue Details:

#8296 - ContentPage.OnBackButtonPressed not invoked on iOS/MacCatalyst when the native navigation bar back button is tapped inside a NavigationPage.

#9095 - Shell.OnBackButtonPressed not invoked when the toolbar back button is tapped on Android and iOS Shell pages

Root Cause

#8296

• ShouldPopItem in NavigationRenderer.cs (the navigationBar:shouldPopItem: UIKit delegate callback) fires when the user taps the native iOS back button.
• Previously it unconditionally set _uiRequestedPop = true and returned true, allowing the native pop without ever notifying MAUI's page model. As a result, ContentPage.OnBackButtonPressed was never called on iOS when the native back button was tapped inside a NavigationPage.

#9095 - iOS (ShellSectionRenderer.cs)

• Same issue — tracker.Value.Page?.SendBackButtonPressed() skipped the Shell chain and went directly to the ContentPage.

Description of change

#8296 NavigationRenderer.cs

• In ShouldPopItem, call NavPage?.CurrentPage?.SendBackButtonPressed() before allowing the native pop. If it returns true (the page handled/cancelled back navigation), reset _uiRequestedPop and return false to prevent the native pop.

#9095 ShellSectionRenderer.cs (iOS Shell)

• Route through _context.Shell?.SendBackButtonPressed() instead of tracker.Value.Page?.SendBackButtonPressed(), so the Shell back button tap goes through the same chain as the system back button.

Note on _sendPopPending = false in the BackButtonBehavior command path: On iOS 26+, _sendPopPending is set to true unconditionally at the start of SendPop(), before any BackButtonBehavior checks. When a BackButtonBehavior.Command executes and returns false (preventing navigation), ViewDidDisappear never fires — so without an explicit reset, the flag stays true permanently and silently blocks all subsequent back presses. The _sendPopPending = false after command execution (line 188) is therefore an intentional and necessary fix to prevent the back button becoming permanently unresponsive after a command-handled back press on iOS 26+.

Test results

Shell — OnBackButtonPressed (fixes #9095)

Platform	Navigation	OnBackButtonPressed
iOS / MacCatalyst	GoToAsync	✅ Triggered
Android	GoToAsync	✅ Triggered (app back button and emulator back button)
Windows	GoToAsync	✅ Triggered

OnBackButtonPressed is triggered for both the Shell and the contained ContentPage.

NavigationPage — OnBackButtonPressed (fixes #8296)

Platform	Navigation	OnBackButtonPressed	Notes
iOS / MacCatalyst	PushAsync	✅ Triggered
iOS / MacCatalyst	PushModalAsync	—	Back button not visible in modal navigation
Android	PushAsync	✅ Triggered (app back button and emulator back button)
Android	PushModalAsync	✅ Triggered	Called on the modal ContentPage
Windows	PushAsync	✅ Triggered
Windows	PushModalAsync	—	Back button not visible in modal navigation

On Android and Windows, OnBackButtonPressed is triggered for both the NavigationPage and the contained ContentPage.

TabbedPage — OnBackButtonPressed

Platform	Navigation	OnBackButtonPressed	Notes
iOS / MacCatalyst	PushAsync	✅ Triggered
iOS / MacCatalyst	PushModalAsync	—	Back button not visible in modal navigation
Android	PushAsync	✅ Triggered
Android	PushModalAsync	✅ Triggered
Windows	PushAsync	✅ Triggered
Windows	PushModalAsync	—	Back button not visible in modal navigation

FlyoutPage — OnBackButtonPressed

Platform	Navigation	OnBackButtonPressed	Notes
iOS / MacCatalyst	PushAsync	✅ Triggered
iOS / MacCatalyst	PushModalAsync	—	Back button not visible in modal navigation
Android	PushAsync	✅ Triggered
Android	PushModalAsync	✅ Triggered
Windows	PushAsync	✅ Triggered
Windows	PushModalAsync	—	Back button not visible in modal navigation

Validated the behaviour in the following platforms

• Android
• Windows
• iOS
• Mac

Issue Fixes

Fixes #8296

Screenshots

	Before	After
8296	BeforeFix-8296.mov	AfterFix-8296.mov
9095	9095_BeforeFix_iOS.mov	9095_AfterFix_iOS.mov

[github-actions]

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/dotnet/maui/main/eng/scripts/get-maui-pr.sh | bash -s -- 35072

Or

• Run remotely in PowerShell:

iex "& { $(irm https://raw.githubusercontent.com/dotnet/maui/main/eng/scripts/get-maui-pr.ps1) } 35072"

[sheiksyedm]

/azp run maui-pr-uitests

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[Copilot]

Pull request overview

Fixes cases where tapping the UI back button (navigation bar/toolbar) bypasses MAUI’s back-press pipeline, so OnBackButtonPressed overrides were not invoked for Shell (Android/iOS/Mac) and NavigationPage (iOS/Mac). Adds corresponding HostApp repro pages and Appium UI tests.

Changes:

• iOS Shell: route navigation-bar back taps through Shell.SendBackButtonPressed() and fix _sendPopPending reset on iOS 26+ when back is canceled.
• Android Shell: route toolbar back taps through Shell.SendBackButtonPressed() instead of going straight to the current Page.
• Add new HostApp issue pages + Appium UI tests for issues #8296 and #9095.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
src/Controls/src/Core/Compatibility/Handlers/Shell/iOS/ShellSectionRenderer.cs	Ensures Shell back-button interception runs for nav-bar back, and prevents iOS 26+ _sendPopPending from getting stuck when back is canceled.
src/Controls/src/Core/Compatibility/Handlers/Shell/Android/ShellToolbarTracker.cs	Routes toolbar back through Shell’s back pipeline before popping navigation.
src/Controls/src/Core/Compatibility/Handlers/NavigationPage/iOS/NavigationRenderer.cs	Attempts to intercept iOS native back taps and invoke MAUI back-press handling before allowing the pop.
src/Controls/tests/TestCases.HostApp/Issues/Issue9095.cs	Adds Shell-based HostApp repro for toolbar back vs OnBackButtonPressed (true/false paths).
src/Controls/tests/TestCases.HostApp/Issues/Issue8296.cs	Adds NavigationPage-based HostApp repro for iOS/macOS native back button calling OnBackButtonPressed (true/false paths).
src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue9095.cs	Adds UI test coverage for Shell toolbar back behavior.
src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue8296.cs	Adds UI test coverage for NavigationPage native back behavior.

[kubaflo]

Could you please review the ai's summary?

[MauiBot]

⚠️ Merge Conflict Detected — This PR has merge conflicts with its target branch. Please rebase onto the target branch and resolve the conflicts.

[kubaflo]

/backport to release/10.0.1xx-sr7

[github-actions]

Started backporting to release/10.0.1xx-sr7 (link to workflow run)

[github-actions]

@kubaflo backporting to release/10.0.1xx-sr7 failed, the patch most likely resulted in conflicts. Please backport manually!

git am output

$ git am --3way --empty=keep --ignore-whitespace --keep-non-patch changes.patch

Applying: Fix: ContentPage.OnBackButtonPressed not invoked on iOS native back button
Applying: Updated Fix
Using index info to reconstruct a base tree...
M	src/Controls/src/Core/Compatibility/Handlers/Shell/iOS/ShellSectionRenderer.cs
Falling back to patching base and 3-way merge...
Auto-merging src/Controls/src/Core/Compatibility/Handlers/Shell/iOS/ShellSectionRenderer.cs
Applying: test: add UITest for #9095 - Shell.OnBackButtonPressed invoked via toolbar back button
Using index info to reconstruct a base tree...
M	src/Controls/src/Core/Compatibility/Handlers/Shell/iOS/ShellSectionRenderer.cs
A	src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue9095.cs
Falling back to patching base and 3-way merge...
Auto-merging src/Controls/src/Core/Compatibility/Handlers/Shell/iOS/ShellSectionRenderer.cs
CONFLICT (modify/delete): src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue9095.cs deleted in HEAD and modified in test: add UITest for #9095 - Shell.OnBackButtonPressed invoked via toolbar back button.  Version test: add UITest for #9095 - Shell.OnBackButtonPressed invoked via toolbar back button of src/Controls/tests/TestCases.Shared.Tests/Tests/Issues/Issue9095.cs left in tree.
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config set advice.mergeConflict false"
Patch failed at 0003 test: add UITest for #9095 - Shell.OnBackButtonPressed invoked via toolbar back button
Error: The process '/usr/bin/git' failed with exit code 128

Link to workflow output