Repository navigation
What's new (.NET 11 RC 2): document features and migration notes - #3569
davidortinau wants to merge 1 commit into
Conversation
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
PoliCheck Scan ReportThe 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 foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit eddd595: ✅ Validation status: passed
For more details, please refer to the build report. |
There was a problem hiding this comment.
🟡 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.
| <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). |

Summary
Update only
docs/whats-new/dotnet-11.mdfor .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, updatems.date, and addai-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.xamland XAML style resources.--avaloniaalone creates shared and desktop projects; native projects require platform options. Expressions require both SourceGen andEnablePreviewFeatures=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
Build report