Skip to content

.NET 11: document Preview 7 platform APIs - #3455

Merged
jfversluis merged 4 commits into
dotnet:mainfrom
davidortinau:davidortinau-preview-7-platform-docs
Aug 11, 2026
Merged

.NET 11: document Preview 7 platform APIs#3455
jfversluis merged 4 commits into
dotnet:mainfrom
davidortinau:davidortinau-preview-7-platform-docs

Conversation

@davidortinau

@davidortinau davidortinau commented Aug 6, 2026 •
edited by github-actions Bot
Loading

Copy link
Copy Markdown
Contributor

Summary

  • document saving captured photos and videos to the gallery
  • document Window.StatusBarTheme on Android 6.0+ and iOS
  • document Windows AppInstance lifecycle activation and single-instance routing

Validation

  • markdownlint: 0 issues
  • factual review against dotnet/maui #34641, #34903, and #36640: clean
  • diff check: clean

Internal previews

File Preview link
docs/fundamentals/app-lifecycle.md docs/fundamentals/app-lifecycle
docs/platform-integration/device-media/picker.md docs/platform-integration/device-media/picker
docs/user-interface/controls/window.md docs/user-interface/controls/window

Copilot AI review requested due to automatic review settings August 6, 2026 12:33
@davidortinau
davidortinau requested a review from a team as a code owner August 6, 2026 12:33
@learn-build-service-prod

learn-build-service-prod Bot commented Aug 6, 2026

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

learn-build-service-prod Bot commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit d5b3822:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/platform-integration/device-media/picker.md ⚠️Warning View (>=net-maui-8.0) Details
docs/user-interface/controls/window.md ⚠️Warning View (>=net-maui-8.0) Details
docs/fundamentals/app-lifecycle.md ✅Succeeded View (>=net-maui-8.0)

docs/platform-integration/device-media/picker.md

  • Line 197, Column 5: [Warning: xref-not-found - See documentation] Cross reference not found: 'Microsoft.Maui.Media.MediaPickerOptions.SaveToGallery'.

docs/user-interface/controls/window.md

  • Line 21, Column 3: [Warning: xref-not-found - See documentation] Cross reference not found: 'Microsoft.Maui.Controls.Window.StatusBarTheme'.
  • Line 21, Column 65: [Warning: xref-not-found - See documentation] Cross reference not found: 'Microsoft.Maui.StatusBarTheme'.
  • Line 61, Column 47: [Warning: xref-not-found - See documentation] Cross reference not found: 'Microsoft.Maui.Controls.Window.StatusBarTheme'.
  • Line 61, Column 224: [Warning: xref-not-found - See documentation] Cross reference not found: 'Microsoft.Maui.StatusBarTheme.Default'.
  • Line 65, Column 3: [Warning: xref-not-found - See documentation] Cross reference not found: 'Microsoft.Maui.StatusBarTheme.Light'.
  • Line 66, Column 3: [Warning: xref-not-found - See documentation] Cross reference not found: 'Microsoft.Maui.StatusBarTheme.Dark'.

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.

Copilot AI reviewed Aug 6, 2026
View reviewed changes

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

Documents new .NET MAUI (.NET 11 / Preview 7) platform-facing APIs and behaviors across Window theming, media capture saving behavior, and Windows AppInstance activation/lifecycle routing.

Changes:

  • Add Window.StatusBarTheme documentation and example (Android API 23+ and iOS) under >=net-maui-11.0.
  • Add MediaPickerOptions.SaveToGallery documentation and example for captured photos/videos under >=net-maui-11.0.
  • Add Windows OnAppInstanceActivated lifecycle documentation and single-instance redirection example under >=net-maui-11.0.
Show a summary per file
File Description
docs/user-interface/controls/window.md Adds StatusBarTheme property and a new section explaining status bar icon theming for .NET MAUI 11+.
docs/platform-integration/device-media/picker.md Documents saving captured media to the gallery via MediaPickerOptions.SaveToGallery for .NET MAUI 11+.
docs/fundamentals/app-lifecycle.md Documents Windows AppInstance activation handling and single-instance activation redirection for .NET MAUI 11+.

Copilot's findings

  • Files reviewed: 3/3 changed files
  • Comments generated: 2

Comment thread docs/fundamentals/app-lifecycle.md Outdated
Comment thread docs/fundamentals/app-lifecycle.md
@learn-build-service-prod

learn-build-service-prod Bot commented Aug 6, 2026

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

learn-build-service-prod Bot commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit bd5052c:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/app-lifecycle.md ✅Succeeded View (>=net-maui-8.0)
docs/platform-integration/device-media/picker.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/window.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@davidortinau davidortinau mentioned this pull request Aug 6, 2026
Merged
This was referenced Aug 7, 2026
Closed
Closed
Closed
davidortinau and others added 4 commits August 11, 2026 08:20
@davidortinau
Platform (.NET 11): document Preview 7 APIs
bfed2d5 
Document media capture gallery saves, mobile status bar themes, and Windows single-instance activation.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@davidortinau
Window (.NET 11): clarify Android status bar support
33781e9 
Document the Android API 23 minimum for Window.StatusBarTheme.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@davidortinau
Docs (.NET 11): avoid unresolved Preview 7 xrefs
059f723 
Format new Preview 7 API names as code until their reference metadata is available.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@davidortinau
App lifecycle (.NET 11): address activation review
9415d5a 
Use standard single-instance terminology and shut down the transient WinUI app normally after activation redirection completes.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@davidortinau
davidortinau force-pushed the davidortinau-preview-7-platform-docs branch from bd5052c to 9415d5a Compare August 11, 2026 13:25
@learn-build-service-prod

learn-build-service-prod Bot commented Aug 11, 2026

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

learn-build-service-prod Bot commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 9415d5a:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/app-lifecycle.md ✅Succeeded View (>=net-maui-8.0)
docs/platform-integration/device-media/picker.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/window.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@davidortinau

davidortinau commented Aug 11, 2026

Copy link
Copy Markdown
Contributor Author

@jfversluis Release-day review requested. SaveToGallery, StatusBarTheme, and Windows AppInstance guidance is verified against the final Preview 7 branch. CI is fully green; human approval is the only blocker.

@jfversluis
jfversluis merged commit de7e116 into dotnet:main Aug 11, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot
Copilot review effort
Applies to this pull request for everyone.Learn more about Copilot code review.
Copilot left review comments
@jfversluis jfversluis jfversluis approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@davidortinau @jfversluis