Skip to content

[Net11 Preview6] Shell: Document Android Handler implementation and ShellRenderer usage - #3389

Closed
Vignesh-SF3580 wants to merge 4 commits into
dotnet:mainfrom
Vignesh-SF3580:doc-AndroidShellHandler
Closed

[Net11 Preview6] Shell: Document Android Handler implementation and ShellRenderer usage#3389
Vignesh-SF3580 wants to merge 4 commits into
dotnet:mainfrom
Vignesh-SF3580:doc-AndroidShellHandler

Conversation

@Vignesh-SF3580

Copy link
Copy Markdown

Summary

In .NET 11, the Android Shell implementation moves from the renderer-based approach (ShellRenderer) to the handler-based architecture, aligning with the current .NET MAUI handler model.
This PR updates the Shell overview documentation to describe the Android handler-based implementation and provides an opt-out path for developers who need to continue using the ShellRenderer behavior.

Related

MAUI PR: dotnet/maui#34758

Notes
Changes are scoped to the >= net-maui-11.0 moniker. Existing .NET 10 and earlier documentation remains unchanged.

Platform scope: Android only.

Copilot AI review requested due to automatic review settings June 29, 2026 14:56
@Vignesh-SF3580
Vignesh-SF3580 requested a review from a team as a code owner June 29, 2026 14:56
@Vignesh-SF3580
Vignesh-SF3580 marked this pull request as draft June 29, 2026 14:56
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 883929b:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/migration/skiasharp.md ⚠️Warning View (>=net-maui-8.0) Details
docs/fundamentals/shell/index.md ✅Succeeded View (>=net-maui-8.0)

docs/migration/skiasharp.md

  • Line 25, Column 103: [Warning: xref-not-found - See documentation] Cross reference not found: 'SkiaSharp.Views.Forms'.
  • Line 25, Column 256: [Warning: xref-not-found - See documentation] Cross reference not found: 'SkiaSharp.Views.Forms'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the .NET MAUI Shell overview documentation to describe the Android move from the renderer-based ShellRenderer implementation to a handler-based implementation in .NET 11, and documents an opt-out path to keep ShellRenderer behavior.

Changes:

  • Adds a >=net-maui-11.0 monikered note explaining the Android Shell architecture change in .NET 11.
  • Adds a MauiProgram.cs snippet intended to show how to revert Android Shell back to ShellRenderer behavior.

Comment thread docs/fundamentals/shell/index.md
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 010b2cc:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/shell/index.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 49ac968:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/shell/index.md ✅Succeeded View (>=net-maui-8.0)
docs/whats-new/dotnet-11.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@Vignesh-SF3580

Copy link
Copy Markdown
Author

Closing this PR in favor of #3408

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants