Skip to content

Clarify .NET 11 runtime-specific build properties for iOS, tvOS, Mac Catalyst, and macOS - #142

Open
vitek-karas wants to merge 1 commit into
dotnet:mainfrom
vitek-karas:vitkaras-microsoft-sync-macios-build-properties
Open

vitek-karas wants to merge 1 commit into
dotnet:mainfrom
vitek-karas:vitkaras-microsoft-sync-macios-build-properties

Conversation

@vitek-karas

@vitek-karas vitek-karas commented Sep 30, 2026 •

Copy link
Copy Markdown
Member

The published build-property reference has not yet caught up with the .NET 11 runtime changes. Without a clear runtime boundary, developers may expect Mono-only settings to configure CoreCLR or NativeAOT applications.

This update preserves earlier Mono guidance while explaining the .NET 11 CoreCLR defaults for iOS, tvOS, and Mac Catalyst and the CoreCLR-only behavior on macOS. It documents the platform-specific errors for UseMonoRuntime=true, identifies six Mono-only properties, and qualifies the MAUI Debug interpreter and trimming guidance. NativeAOT remains distinct, and the existing MtouchLink and TrimMode guidance is retained.


Internal previews

File Preview link
docs/ios/building-apps/build-properties.md Learn preview

Build report

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings September 30, 2026 14:51

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.

Copilot review overview

🟢 Approval recommended

The documentation changes are consistent, accurate, and complete.

Review effort: Balanced
Findings: None

What changed in this PR

Clarifies runtime-specific build property behavior following the .NET 11 transition to CoreCLR.

Changes:

  • Documents .NET 11 runtime defaults and Mono-related errors.
  • Identifies Mono-only properties and warnings.
  • Qualifies MAUI interpreter and trimming guidance.
File Description
docs/​ios/​building-apps/​build-properties.md Updates runtime, interpreter, and trimming guidance.

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

@vitek-karas

Copy link
Copy Markdown
Member Author

@rolfbjarne could you please take a look - another docs update for 11.

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