What's new (.NET 11): add Preview 7 highlights - #3458
Conversation
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 7babdea:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| docs/whats-new/dotnet-11.md | View (>=net-maui-8.0) | Details |
docs/whats-new/dotnet-11.md
- Line 200, Column 324: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#tabbedpage-on-ios-and-mac-catalyst' in 'user-interface/pages/tabbedpage.md'. - Line 200, Column 435: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#migrate-ios-tabbedpage-renderers' in 'migration/custom-renderers.md'. - Line 213, Column 267: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#route-templates' in 'fundamentals/shell/navigation.md'. - Line 239, Column 585: [Warning: file-not-found - See documentation]
Invalid file link: '~/platform-integration/communication/passkeys.md'. - Line 243, Column 445: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#save-captured-media-to-the-gallery' in 'platform-integration/device-media/picker.md'. - Line 247, Column 564: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#set-the-status-bar-theme' in 'user-interface/controls/window.md'. - Line 251, Column 538: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#handle-appinstance-activation' in 'fundamentals/app-lifecycle.md'. - Line 353, Column 27: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#enable-xaml-incremental-hot-reload' in 'xaml/hot-reload.md'. - Line 364, Column 358: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#compile-relative-source-ancestor-bindings' in 'fundamentals/data-binding/compiled-bindings.md'. - Line 213, Column 342: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/navigation-shell-route-templates' points to a learn site page that doesn't exist. Check the path or URL and update the link. - Line 239, Column 651: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/platformintegration-passkeys' points to a learn site page that doesn't exist. Check the path or URL and update the link.
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.
CI status
The remaining
Other checks: Keeping this draft until #3454, #3455, #3456, #3457 and dotnet/maui-samples#775-#777 merge. |
There was a problem hiding this comment.
Pull request overview
Updates the .NET MAUI .NET 11 “What’s new” article to include consolidated Preview 7 highlights, including an added Preview 7 release-notes link, new/expanded highlight sections (Controls/Navigation/Platform features/XAML), and an ms.date refresh.
Changes:
- Add the Preview 7 release notes link and refresh
ms.date. - Add new Preview 7 highlight entries for
TabbedPagehandler behavior and Shell route templates (new Navigation H2). - Add Preview 7 highlight entries for Passkeys, MediaPicker gallery save, Status bar theme, Windows AppInstance activation, and new XAML tooling capabilities.
Show a summary per file
| File | Description |
|---|---|
| docs/whats-new/dotnet-11.md | Adds .NET 11 Preview 7 highlights and links across multiple areas, and refreshes page metadata. |
Copilot's findings
Suppressed comments (7)
docs/whats-new/dotnet-11.md:213
- The link to
navigation.md#route-templatesdoesn't resolve in this PR branch (the anchor isn't present in the currentnavigation.md), which will cause a broken-link warning/failure during doc validation. Consider linking to the page without the anchor fragment until the dependent content lands.
Templates support required, optional, defaulted, constrained, catch-all, and mixed segments. Route templates are additive, so routes that don't contain a path parameter are unaffected. Route templates currently require absolute navigation. For more information, see [Route templates](~/fundamentals/shell/navigation.md#route-templates), the [Shell route templates sample](/samples/dotnet/maui-samples/navigation-shell-route-templates), and [GitHub PR #35110](https://github.com/dotnet/maui/pull/35110).
docs/whats-new/dotnet-11.md:239
~/platform-integration/communication/passkeys.mddoesn't exist in this PR branch, so this link is currently broken and will trip doc link validation. If the intent is to keep this PR buildable until the Passkeys article lands, consider linking to the PR that adds the article (or omit the doc link for now).
Passkeys are supported on Android 14 (API 34), iOS 16, Mac Catalyst 16, and Windows 10 version 1903 or later. The .NET 11 toolchain's minimum Mac Catalyst deployment target is 17, which is the effective floor for .NET 11 apps. The client performs no verification of its own. Challenge generation, and relying party ID, origin, attestation, and assertion validation, remain the responsibility of your server. Successful registration also requires platform trust configuration, such as Digital Asset Links on Android and Associated Domains on Apple platforms. For more information, see [Passkeys](~/platform-integration/communication/passkeys.md), the [Passkeys sample](/samples/dotnet/maui-samples/platformintegration-passkeys), and [GitHub PR #36837](https://github.com/dotnet/maui/pull/36837).
docs/whats-new/dotnet-11.md:243
- The link to
picker.md#save-captured-media-to-the-gallerydoesn't resolve in this PR branch (the anchor isn't present in the currentpicker.md), which can cause broken-link warnings/failures in doc validation. Consider linking to the page without the anchor fragment until the dependent content lands.
Starting in .NET 11 Preview 7, the `MediaPickerOptions.SaveToGallery` property saves a captured photo or video to the device's gallery. The property defaults to `false`, and applies only to the <xref:Microsoft.Maui.Media.IMediaPicker.CapturePhotoAsync%2A> and <xref:Microsoft.Maui.Media.IMediaPicker.CaptureVideoAsync%2A> methods. It's supported on Android, iOS, and Mac Catalyst, and is ignored on Windows and Tizen. For more information, see [Save captured media to the gallery](~/platform-integration/device-media/picker.md#save-captured-media-to-the-gallery) and [GitHub PR #34641](https://github.com/dotnet/maui/pull/34641).
docs/whats-new/dotnet-11.md:247
- The link to
window.md#set-the-status-bar-themedoesn't resolve in this PR branch (the anchor isn't present in the currentwindow.md), which can cause broken-link warnings/failures in doc validation. Consider linking to the page without the anchor fragment until the dependent content lands.
Starting in .NET 11 Preview 7, the `Window.StatusBarTheme` property controls the appearance of the operating system-drawn status bar icons on Android 6.0 (API 23) or later, and iOS, independently of the app theme. This is useful when edge-to-edge content places a light or dark surface behind the status bar. `StatusBarTheme.Light` indicates a light surface and displays dark icons, `StatusBarTheme.Dark` indicates a dark surface and displays light icons, and the default value of `StatusBarTheme.Default` follows the current app theme. For more information, see [Set the status bar theme](~/user-interface/controls/window.md#set-the-status-bar-theme) and [GitHub PR #34903](https://github.com/dotnet/maui/pull/34903).
docs/whats-new/dotnet-11.md:251
- The link to
app-lifecycle.md#handle-appinstance-activationdoesn't resolve in this PR branch (the anchor isn't present in the currentapp-lifecycle.md), which can cause broken-link warnings/failures in doc validation. Consider linking to the page without the anchor fragment until the dependent content lands.
Starting in .NET 11 Preview 7, Windows apps can handle `AppInstance` activations with the `OnAppInstanceActivated` lifecycle hook, which receives the initial activation as well as subsequent file, protocol, and redirected activations. Combined with `AppInstance.FindOrRegisterForKey`, this lets you make your app single-instanced by redirecting activations from other instances to the running instance, which also enables <xref:Microsoft.Maui.Authentication.WebAuthenticator> callbacks in single-instance apps. For more information, see [Handle AppInstance activation](~/fundamentals/app-lifecycle.md#handle-appinstance-activation) and [GitHub PR #36640](https://github.com/dotnet/maui/pull/36640).
docs/whats-new/dotnet-11.md:353
- The link to
hot-reload.md#enable-xaml-incremental-hot-reloaddoesn't resolve in this PR branch (the anchor isn't present in the currenthot-reload.md), which can cause broken-link warnings/failures in doc validation. Consider linking to the page without the anchor fragment until the dependent content lands.
For more information, see [Enable XAML Incremental Hot Reload](~/xaml/hot-reload.md#enable-xaml-incremental-hot-reload) and GitHub PRs [#34338](https://github.com/dotnet/maui/pull/34338) and [#36832](https://github.com/dotnet/maui/pull/36832).
docs/whats-new/dotnet-11.md:364
- The link to
compiled-bindings.md#compile-relative-source-ancestor-bindingsdoesn't resolve in this PR branch (the anchor isn't present in the currentcompiled-bindings.md), which can cause broken-link warnings/failures in doc validation. Consider linking to the page without the anchor fragment until the dependent content lands.
Bindings whose source type can't be resolved at compile time continue to use the runtime binding path. This includes `RelativeSource` bindings that use `Self` or `TemplatedParent`, and `x:Reference` bindings whose referenced element type can't be resolved. An `AncestorType` that can't be resolved causes XAML compilation to fail. For more information, see [Compile relative source ancestor bindings](~/fundamentals/data-binding/compiled-bindings.md#compile-relative-source-ancestor-bindings) and GitHub PRs [#34408](https://github.com/dotnet/maui/pull/34408) and [#36905](https://github.com/dotnet/maui/pull/36905).
- Files reviewed: 1/1 changed files
- Comments generated: 1
Adds the .NET MAUI in .NET 11 Preview 7 release-note link and concise, area-appropriate Preview 7 highlights to the What's New article: - Controls: iOS and Mac Catalyst TabbedPage handler default (#36507) - Navigation (new section): Shell route templates (#35110) - Platform features: Passkeys (#36837), MediaPickerOptions.SaveToGallery (#34641), Window.StatusBarTheme (#34903), Windows AppInstance activation (#36640) - XAML: XAML Incremental Hot Reload (#34338, #36832), AOT-safe compiled RelativeSource bindings (#34408, #36905) Each entry links to the detailed article and Samples Browser entry rather than repeating setup. Android and Apple workload-only items stay in the release notes. Newly-shipped Preview 7 APIs use backticks rather than xrefs while reference metadata catches up. Refreshes ms.date. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…binding fallback XAML Incremental Hot Reload is enabled by default for Debug builds and disabled for Release and publish builds, per dotnet/maui#37163 (backport of #37157), which reverted the temporary opt-out in #36832. Show the MSBuild property as an opt-out instead of an opt-in, and note that edits are applied by .NET Hot Reload hosts such as dotnet watch, because the engine uses a MetadataUpdateHandler. Correct the AOT-safe compiled RelativeSource binding fallback. For an x:Reference binding the compiler resolves the referenced element's type and compiles against it, and falls back to the runtime binding path only when the binding path can't be compiled against that type. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 35c845e8-c26a-4489-b9de-2c1d32638c6d
7babdea to
70924dc
Compare
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 70924dc:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| docs/whats-new/dotnet-11.md | View (>=net-maui-8.0) | Details |
docs/whats-new/dotnet-11.md
- Line 200, Column 324: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#tabbedpage-on-ios-and-mac-catalyst' in 'user-interface/pages/tabbedpage.md'. - Line 200, Column 435: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#migrate-ios-tabbedpage-renderers' in 'migration/custom-renderers.md'. - Line 213, Column 267: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#route-templates' in 'fundamentals/shell/navigation.md'. - Line 239, Column 585: [Warning: file-not-found - See documentation]
Invalid file link: '~/platform-integration/communication/passkeys.md'. - Line 243, Column 445: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#save-captured-media-to-the-gallery' in 'platform-integration/device-media/picker.md'. - Line 247, Column 564: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#set-the-status-bar-theme' in 'user-interface/controls/window.md'. - Line 251, Column 538: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#handle-appinstance-activation' in 'fundamentals/app-lifecycle.md'. - Line 355, Column 27: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#enable-xaml-incremental-hot-reload' in 'xaml/hot-reload.md'. - Line 366, Column 496: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#compile-relative-source-ancestor-bindings' in 'fundamentals/data-binding/compiled-bindings.md'. - Line 213, Column 342: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/navigation-shell-route-templates' points to a learn site page that doesn't exist. Check the path or URL and update the link. - Line 239, Column 651: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/platformintegration-passkeys' points to a learn site page that doesn't exist. Check the path or URL and update the link.
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.
Use "XAML source generator" instead of "XAML compiler", because the feature is implemented in src/Controls/src/SourceGen/KnownMarkups.cs. State the two x:Reference outcomes separately. A name that resolves in no name scope reports MAUIG1001 as an error from ProvideValueForReferenceExtension, so XAML compilation fails, in the same way as an unresolved AncestorType. The runtime fallback applies only when the referenced element resolves but the binding path can't be compiled against that resolved type. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 35c845e8-c26a-4489-b9de-2c1d32638c6d
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 3d8549b:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| docs/whats-new/dotnet-11.md | View (>=net-maui-8.0) | Details |
docs/whats-new/dotnet-11.md
- Line 200, Column 324: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#tabbedpage-on-ios-and-mac-catalyst' in 'user-interface/pages/tabbedpage.md'. - Line 200, Column 435: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#migrate-ios-tabbedpage-renderers' in 'migration/custom-renderers.md'. - Line 213, Column 267: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#route-templates' in 'fundamentals/shell/navigation.md'. - Line 239, Column 585: [Warning: file-not-found - See documentation]
Invalid file link: '~/platform-integration/communication/passkeys.md'. - Line 243, Column 445: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#save-captured-media-to-the-gallery' in 'platform-integration/device-media/picker.md'. - Line 247, Column 564: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#set-the-status-bar-theme' in 'user-interface/controls/window.md'. - Line 251, Column 538: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#handle-appinstance-activation' in 'fundamentals/app-lifecycle.md'. - Line 355, Column 27: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#enable-xaml-incremental-hot-reload' in 'xaml/hot-reload.md'. - Line 366, Column 581: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#compile-relative-source-ancestor-bindings' in 'fundamentals/data-binding/compiled-bindings.md'. - Line 213, Column 342: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/navigation-shell-route-templates' points to a learn site page that doesn't exist. Check the path or URL and update the link. - Line 239, Column 651: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/platformintegration-passkeys' points to a learn site page that doesn't exist. Check the path or URL and update the link.
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.
The paragraph opened with a broad claim that any binding whose source type can't be resolved continues to use the runtime binding path, then said that an unresolved x:Reference name or AncestorType causes XAML compilation to fail. Those statements conflict. Narrow the opening sentence to Self and TemplatedParent, which are the cases excluded from the compiled path by HasRelativeSourceBinding. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 35c845e8-c26a-4489-b9de-2c1d32638c6d
|
Learn Build status updates of commit fb07d83:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| docs/whats-new/dotnet-11.md | View (>=net-maui-8.0) | Details |
docs/whats-new/dotnet-11.md
- Line 200, Column 324: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#tabbedpage-on-ios-and-mac-catalyst' in 'user-interface/pages/tabbedpage.md'. - Line 200, Column 435: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#migrate-ios-tabbedpage-renderers' in 'migration/custom-renderers.md'. - Line 213, Column 267: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#route-templates' in 'fundamentals/shell/navigation.md'. - Line 239, Column 585: [Warning: file-not-found - See documentation]
Invalid file link: '~/platform-integration/communication/passkeys.md'. - Line 243, Column 445: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#save-captured-media-to-the-gallery' in 'platform-integration/device-media/picker.md'. - Line 247, Column 564: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#set-the-status-bar-theme' in 'user-interface/controls/window.md'. - Line 251, Column 538: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#handle-appinstance-activation' in 'fundamentals/app-lifecycle.md'. - Line 355, Column 27: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#enable-xaml-incremental-hot-reload' in 'xaml/hot-reload.md'. - Line 366, Column 505: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#compile-relative-source-ancestor-bindings' in 'fundamentals/data-binding/compiled-bindings.md'. - Line 213, Column 342: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/navigation-shell-route-templates' points to a learn site page that doesn't exist. Check the path or URL and update the link. - Line 239, Column 651: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/platformintegration-passkeys' points to a learn site page that doesn't exist. Check the path or URL and update the link.
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.
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 |
The AOT-safe RelativeSource section said the behavior applies "when compilation of bindings that define the Source property is enabled". That refers to XamlCBindingWithSourceCompilation, which gates the legacy XamlC compiler and the runtime binding path. It is not read by the XAML source generator: a code search for the symbol under src/Controls/src/SourceGen returns no results, and the shipped KnownMarkups.cs has no reference to it. Remove the precondition. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 35c845e8-c26a-4489-b9de-2c1d32638c6d
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 5dabb02:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| docs/whats-new/dotnet-11.md | View (>=net-maui-8.0) | Details |
docs/whats-new/dotnet-11.md
- Line 200, Column 324: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#tabbedpage-on-ios-and-mac-catalyst' in 'user-interface/pages/tabbedpage.md'. - Line 200, Column 435: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#migrate-ios-tabbedpage-renderers' in 'migration/custom-renderers.md'. - Line 213, Column 267: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#route-templates' in 'fundamentals/shell/navigation.md'. - Line 239, Column 585: [Warning: file-not-found - See documentation]
Invalid file link: '~/platform-integration/communication/passkeys.md'. - Line 243, Column 445: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#save-captured-media-to-the-gallery' in 'platform-integration/device-media/picker.md'. - Line 247, Column 564: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#set-the-status-bar-theme' in 'user-interface/controls/window.md'. - Line 251, Column 538: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#handle-appinstance-activation' in 'fundamentals/app-lifecycle.md'. - Line 355, Column 27: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#enable-xaml-incremental-hot-reload' in 'xaml/hot-reload.md'. - Line 366, Column 505: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#compile-relative-source-ancestor-bindings' in 'fundamentals/data-binding/compiled-bindings.md'. - Line 213, Column 342: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/navigation-shell-route-templates' points to a learn site page that doesn't exist. Check the path or URL and update the link. - Line 239, Column 651: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/platformintegration-passkeys' points to a learn site page that doesn't exist. Check the path or URL and update the link.
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.
Preview 7 ships the iOS and Mac Catalyst handler migration for both NavigationPage (dotnet/maui#36109) and TabbedPage (dotnet/maui#36507), so expand the Controls entry to cover both rather than TabbedPage alone. Verified against AppHostBuilderExtensions.cs at release/11.0.1xx-preview7: the IOS || MACCATALYST block registers NavigationViewHandler and TabbedViewHandler, but FlyoutPage is still on PhoneFlyoutPageRenderer. dotnet/maui#36676 is not an ancestor of that branch, so FlyoutPage is deliberately not claimed. Also note the migration-sensitive default behavior changes from #36109: Appearing now fires before the push, a re-pushed page gets a new view controller, and secondary toolbar items move to an overflow menu. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 35c845e8-c26a-4489-b9de-2c1d32638c6d
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 6f86b99:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| docs/whats-new/dotnet-11.md | View (>=net-maui-8.0) | Details |
docs/whats-new/dotnet-11.md
- Line 200, Column 651: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#navigationpage-on-ios-and-mac-catalyst' in 'user-interface/pages/navigationpage.md'. - Line 200, Column 774: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#migrate-ios-navigationpage-renderers' in 'migration/custom-renderers.md'. - Line 202, Column 253: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#tabbedpage-on-ios-and-mac-catalyst' in 'user-interface/pages/tabbedpage.md'. - Line 202, Column 364: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#migrate-ios-tabbedpage-renderers' in 'migration/custom-renderers.md'. - Line 215, Column 267: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#route-templates' in 'fundamentals/shell/navigation.md'. - Line 241, Column 585: [Warning: file-not-found - See documentation]
Invalid file link: '~/platform-integration/communication/passkeys.md'. - Line 245, Column 445: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#save-captured-media-to-the-gallery' in 'platform-integration/device-media/picker.md'. - Line 249, Column 564: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#set-the-status-bar-theme' in 'user-interface/controls/window.md'. - Line 253, Column 538: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#handle-appinstance-activation' in 'fundamentals/app-lifecycle.md'. - Line 357, Column 27: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#enable-xaml-incremental-hot-reload' in 'xaml/hot-reload.md'. - Line 368, Column 505: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#compile-relative-source-ancestor-bindings' in 'fundamentals/data-binding/compiled-bindings.md'. - Line 215, Column 342: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/navigation-shell-route-templates' points to a learn site page that doesn't exist. Check the path or URL and update the link. - Line 241, Column 651: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/platformintegration-passkeys' points to a learn site page that doesn't exist. Check the path or URL and update the link.
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.
dotnet#3457 now supplies the NavigationPage sections. Match its precise wording so the two articles agree: a re-pushed page is one that was previously popped, and the toolbar change applies to ToolbarItem objects whose Order property is Secondary. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 35c845e8-c26a-4489-b9de-2c1d32638c6d
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 f9e66ff:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| docs/whats-new/dotnet-11.md | View (>=net-maui-8.0) | Details |
docs/whats-new/dotnet-11.md
- Line 200, Column 669: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#navigationpage-on-ios-and-mac-catalyst' in 'user-interface/pages/navigationpage.md'. - Line 200, Column 792: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#migrate-ios-navigationpage-renderers' in 'migration/custom-renderers.md'. - Line 202, Column 253: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#tabbedpage-on-ios-and-mac-catalyst' in 'user-interface/pages/tabbedpage.md'. - Line 202, Column 364: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#migrate-ios-tabbedpage-renderers' in 'migration/custom-renderers.md'. - Line 215, Column 267: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#route-templates' in 'fundamentals/shell/navigation.md'. - Line 241, Column 585: [Warning: file-not-found - See documentation]
Invalid file link: '~/platform-integration/communication/passkeys.md'. - Line 245, Column 445: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#save-captured-media-to-the-gallery' in 'platform-integration/device-media/picker.md'. - Line 249, Column 564: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#set-the-status-bar-theme' in 'user-interface/controls/window.md'. - Line 253, Column 538: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#handle-appinstance-activation' in 'fundamentals/app-lifecycle.md'. - Line 357, Column 27: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#enable-xaml-incremental-hot-reload' in 'xaml/hot-reload.md'. - Line 368, Column 505: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#compile-relative-source-ancestor-bindings' in 'fundamentals/data-binding/compiled-bindings.md'. - Line 215, Column 342: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/navigation-shell-route-templates' points to a learn site page that doesn't exist. Check the path or URL and update the link. - Line 241, Column 651: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/platformintegration-passkeys' points to a learn site page that doesn't exist. Check the path or URL and update the link.
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.
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 f4030de:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| docs/whats-new/dotnet-11.md | View (>=net-maui-8.0) | Details |
docs/whats-new/dotnet-11.md
- Line 200, Column 669: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#navigationpage-on-ios-and-mac-catalyst' in 'user-interface/pages/navigationpage.md'. - Line 200, Column 792: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#migrate-ios-navigationpage-renderers' in 'migration/custom-renderers.md'. - Line 202, Column 253: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#tabbedpage-on-ios-and-mac-catalyst' in 'user-interface/pages/tabbedpage.md'. - Line 202, Column 364: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#migrate-ios-tabbedpage-renderers' in 'migration/custom-renderers.md'. - Line 215, Column 267: [Warning: bookmark-not-found - See documentation]
Cannot find bookmark '#route-templates' in 'fundamentals/shell/navigation.md'. - Line 241, Column 585: [Warning: file-not-found - See documentation]
Invalid file link: '~/platform-integration/communication/passkeys.md'. - Line 215, Column 342: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/navigation-shell-route-templates' points to a learn site page that doesn't exist. Check the path or URL and update the link. - Line 241, Column 651: [Suggestion: learn-site-link-broken - See documentation]
Link '/samples/dotnet/maui-samples/platformintegration-passkeys' points to a learn site page that doesn't exist. Check the path or URL and update the link.
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.
|
@davidortinau please check the longing errors, I just pushed the other changes to live so I suspect that will resolve these and then we can merge this one |
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 44940c6: 💡 Validation status: suggestions
docs/whats-new/dotnet-11.md
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. |
Summary
Final consolidated .NET MAUI 11 Preview 7 update to the What's New article. Adds the Preview 7 release-note link and concise, area-appropriate highlights that link out to the detailed articles and Samples Browser entries rather than repeating setup or implementation inventories.
Only
docs/whats-new/dotnet-11.mdis changed. No other article is touched.Changes
NavigationPageandTabbedPagehandler defaultsMediaPickerOptions.SaveToGalleryWindow.StatusBarThemeAppInstanceactivation / single-instanceDebug)RelativeSourcebindingsms.daterefreshed to 08/11/2026.The Controls entry is called out as migration-sensitive: both handlers are the default and neither is gated behind a feature switch, so the entry names the
NavigationRendererandTabbedRenderercompatibility fallbacks and links to the migration guidance.Corrections since this PR was opened
Five factual corrections were applied after the initial draft, each verified against shipped Preview 7 source rather than against the earlier draft release notes.
1. XAML Incremental Hot Reload is on by default for
Debug. dotnet/maui#37163, the backport of #37157, merged intorelease/11.0.1xx-preview7and reverted the temporary opt-out from #36832. The shipped cascade inMicrosoft.Maui.Controls.targetssets the property totruewhen it is empty andConfigurationisDebug, and tofalsewhen it is empty otherwise, so an explicit value always wins. The section previously said "opt-in" and "off by default in Preview 7" and showed the property set totrue. It now showsfalseas an opt-out, and the grounding moved from #36832 to #37163.2.
dotnet watch. #34338 registers[assembly: MetadataUpdateHandler], which is the standard .NET Hot Reload mechanism, so the entry notes that edits are applied by .NET Hot Reload hosts includingdotnet watchand cross-links the existing in-pagedotnet watchsections.3.
x:Referencebinding behavior. The section previously saidx:Referencebindings "whose referenced element type can't be resolved" fall back to the runtime binding path. That conflated two different outcomes. Verified insrc/Controls/src/SourceGen/KnownMarkups.csonrelease/11.0.1xx-preview7:RelativeSourcewithSelforTemplatedParentHasRelativeSourceBinding.x:Referencename resolves, binding path can't compile against the resolved typeTryResolveXReferenceSourceTypesucceeds,TryCompileBindingfails.x:Referencename resolves in no name scopeProvideValueForReferenceExtensionreportsMAUIG1001,DiagnosticSeverity.Error.AncestorTypecan't be resolvedMAUIG1001descriptor.A broad lead sentence claiming that any binding whose source type can't be resolved falls back to the runtime path was also removed, because it contradicted the two compilation-failure rows above.
4. Removed a false precondition. The section opened with "when compilation of bindings that define the
Sourceproperty is enabled". That refers toXamlCBindingWithSourceCompilation, which gates the legacy XamlC compiler and the runtime binding path. It is not read by the XAML source generator: a code search for the symbol undersrc/Controls/src/SourceGenreturns zero results, and the shippedKnownMarkups.cscontains no reference to it. The section now says directly that the XAML source generator compiles a resolvableAncestorType. The wording also changed from "XAML compiler" to "XAML source generator" throughout, because the feature is implemented in a Roslyn source generator.dotnet/docs-maui#3454 (head
494867e5) and dotnet/core#10505 (head2a78314d, merged as8c04b4abon 2026-08-11T14:42:12Z) now carry the matching corrections, so the three articles agree on the XIHR default and on thex:Referencebehavior.5. The Controls entry covers
NavigationPageas well asTabbedPage. Preview 7 ships the Apple-platform handler migration for both pages, so the entry and its heading were expanded. Verified insrc/Controls/src/Core/Hosting/AppHostBuilderExtensions.csatrelease/11.0.1xx-preview7: the#if IOS || MACCATALYSTblock registersNavigationViewHandlerandTabbedViewHandler, but still registersFlyoutPageagainstHandlers.Compatibility.PhoneFlyoutPageRenderer. Comparing each merge commit against that branch givesahead_by=0for #36109 and #36507, butstatus=diverged, ahead_by=3for #36676, soFlyoutPageis deliberately not claimed. The entry also records the default behavior changes from #36109:Appearingfires before the push rather than after the page becomes visible, a page that's pushed after being popped gets a new view controller, andToolbarItemobjects whoseOrderisSecondarymove to an overflow menu in the navigation bar. The wording matches the parallel sections that #3457 adds.Scope decisions
FastDeploy2, NativeAOT trimmable typemaps,AndroidMessageHandlerredirects, App Store Connect symbolication, ILC flow changes, and similar items are covered by dotnet/core#10505 and aren't duplicated here.AppInstanceredirect sample live in the detailed articles.Passkeys,MediaPickerOptions.SaveToGallery,Window.StatusBarTheme,StatusBarTheme,TabbedViewHandler,TabbedRenderer,OnAppInstanceActivated,AppInstance, andEnableMauiIncrementalHotReloadare backticked because reference metadata lags the preview. Only pre-existing APIs use xrefs.docs/whats-new/dotnet-*.mdisn't wrapped in same-version moniker blocks so the page renders for readers arriving with an olderview=value.This PR is draft because it links to articles, anchors, and samples that land in other open PRs. It should be merged only after all of the following:
dotnet/docs-maui
~/xaml/hot-reload.md#enable-xaml-incremental-hot-reload,~/fundamentals/data-binding/compiled-bindings.md#compile-relative-source-ancestor-bindings~/platform-integration/device-media/picker.md#save-captured-media-to-the-gallery,~/user-interface/controls/window.md#set-the-status-bar-theme,~/fundamentals/app-lifecycle.md#handle-appinstance-activation~/platform-integration/communication/passkeys.mdplus its TOC entry~/fundamentals/shell/navigation.md#route-templates,~/user-interface/pages/tabbedpage.md#tabbedpage-on-ios-and-mac-catalyst,~/migration/custom-renderers.md#migrate-ios-tabbedpage-renderers,~/user-interface/pages/navigationpage.md#navigationpage-on-ios-and-mac-catalyst,~/migration/custom-renderers.md#migrate-ios-navigationpage-renderersdotnet/maui-samples
/samples/dotnet/maui-samples/platformintegration-passkeys/samples/dotnet/maui-samples/navigation-shell-route-templatesdotnet/core
release-notes/11.0/preview/preview7/dotnetmaui.md, the target of the new release-note link. Merged 2026-08-11T14:42:12Z as commit8c04b4abinto therelease-notes/11.0-preview7staging branch, notmain, so theblob/mainURL used here resolves only once that branch reachesmainon release day. Verified: the file exists on the staging branch, and the equivalent Preview 6blob/mainURL returns 200, so the URL form is correct.Expected OPS results while the dependencies are open
0 errors, 11 warnings, 2 suggestions. All of them are dependency-driven and all clear on the merge order above.
bookmark-not-foundfile-not-foundpasskeys.md, supplied by #3456learn-site-link-broken(suggestion)Look for build warningsfails only because warnings exist;OpenPublishing.Build,MSDocs build verifier,lint,Check base branch,PoliCheck Scan, andlicense/claall pass. The Preview 7 release-note URL produces no OPS diagnostic. dotnet/core#10505 has now merged, but into therelease-notes/11.0-preview7staging branch, so that URL stays a 404 until the staging branch reachesmainon release day.All ten anchor slugs were re-verified against the current head of each dependency PR and match exactly. Durable
~/article and Samples Browser links are used throughout, so no follow-up link edits are needed once the dependencies land.Overlap check
Rebased on current
origin/main(193868ac) and re-checked all open dotnet/docs-maui PRs. PR #3457's description mentions adocs/whats-new/dotnet-11.mdedit, but that file is no longer in its diff — at head4f3b2ba4it changes five files:navigation.md,navigationpage.md,tabbedpage.md,custom-renderers.md, andhandlers/index.md. This PR is the sole owner of the What's New changes, so there is no conflict.Validation
markdownlint-cli2on the changed file: 0 issues#dotnet-watch-for-androidand#dotnet-watch-for-iosanchors verified against their headingsrelease/11.0.1xx-preview7Internal previews