Skip to content

What's new (.NET 11 RC 2): document features and migration notes - #3569

Draft
davidortinau wants to merge 1 commit into
mainfrom
davidortinau-rc2-whats-new-docs
Draft

davidortinau wants to merge 1 commit into
mainfrom
davidortinau-rc2-whats-new-docs

Conversation

@davidortinau

@davidortinau davidortinau commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Update only docs/whats-new/dotnet-11.md for .NET 11 RC 2. Preserve the Preview 1–7 and RC 1 topic text, headings, and source links. Add RC 1 and RC 2 release-note links, update ms.date, and add ai-usage: ai-assisted.

Cover C# Shell/page UI templates, optional Avalonia desktop projects, Apple Icon Composer, the opt-in Apple Shell handler, SourceGen C# expressions and preview requirements, incremental XAML Hot Reload updates, Android tooling and measured build/package results, and Apple SDK/runtime changes. Include scoped migration notes for scenes, deployment targets, legacy Apple item handlers, R8, ReadyToRun trimming, deprecation warnings, and desktop architecture defaults.

Keep the SDK binding version separate from the minimum OS version. Link existing conceptual articles and canonical platform SDK guidance. Do not duplicate #3502 or the badge content in #3359.

Release-day gate

Keep this PR in draft until the RC 2 release notes are published. The intended article link, https://github.com/dotnet/core/blob/main/release-notes/11.0/preview/rc2/dotnetmaui.md, returns HTTP 404 as of October 8, 2026. This is an expected external publication gate, not a claim that RC 2 is public.

The verified exact editorial source returns HTTP 200: RC 2 notes at a26e2ef9efeab9c78e571b9c13ad9779130cb0b8, in dotnet/core#10609.

Source checks

Key claims were checked against these exact mobile source revisions:

The C# template keeps App.xaml and XAML style resources. --avalonia alone creates shared and desktop projects; native projects require platform options. Expressions require both SourceGen and EnablePreviewFeatures=true. Proxy selection is session-wide, and proxy credentials apply to HTTPS CONNECT destinations. The desktop architecture boundary uses the effective deployment target during SDK props evaluation.

Validation

Local repository Markdown lint reports no issues. The complete staged review found no unresolved change defect. Checks cover metadata, Markdown parse/render, all relative links, 20 XML/XAML syntax blocks, exact performance arithmetic, unchanged xref types, and preservation of all 74 previous headings and 148 previous links. The #3359 article patch applies without conflict.

Hosted Learn/MSDocs and GitHub build results are pending at PR creation. The local Markdown render does not validate Learn-specific directives or xref resolution. App execution is not applicable to this documentation-only change.


Internal previews

File Preview link
docs/whats-new/dotnet-11.md Learn preview

Build report

Preserve previous milestones and add RC 2 features, measured Android results, and scoped migration guidance.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 12acf335-a35c-4bd2-b703-d94c65d4bebb
Copilot AI balanced review requested due to automatic review settings October 8, 2026 21:44
@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 eddd595:

✅ Validation status: passed

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

For more details, please refer to the build report.

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.

🟡 Changes recommended

The XAML example lacks its namespace declaration, and scene migration guidance could cause duplicate app-action dispatch.

2 open findings
What changed in this PR

Updates the .NET 11 what's-new article with RC 2 features, platform changes, and migration guidance.

Changes:

  • Adds template, Shell, Icon Composer, XAML, and Hot Reload updates.
  • Documents Android and Apple workload changes and migration requirements.
  • Updates metadata and RC release-note links.
File Description
docs/​whats-new/​dotnet-11.md Documents .NET 11 RC 2 features and migration notes.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines +448 to +450
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
x:Class="MyApp.MainPage">

iOS and Mac Catalyst apps built with the Xcode 27 SDKs must use the UIKit scene lifecycle. .NET 11 RC 2 app templates include a `UIApplicationSceneManifest` and a registered `MauiUISceneDelegate` subclass. The templates keep the single-window default with `UIApplicationSupportsMultipleScenes` set to `false`; scene adoption doesn't require multiple-window support.

Existing apps must add the scene configuration and move custom lifecycle and launch-option handling to scene callbacks. Each `PerformActionForShortcutItem` lifecycle registration must call its completion callback. An observer that doesn't handle the action must pass `false`. For more information, see [App lifecycle](~/fundamentals/app-lifecycle.md) and [App actions](~/platform-integration/appmodel/app-actions.md).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants