[mobile] .NET 11 mobile runtime configuration updates - #54713
Merged
Conversation
…n .NET 11 Add NETSDK1242 so building an Android or Apple mobile project with UseMonoRuntime=true on net11.0 or later fails with a clear message directing users to the .NET 10 SDK, instead of a silent missing-pack error. WebAssembly Mono, CoreCLR, NativeAOT, and the platform workloads are unaffected. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
github-actions
Bot
added
Area-Infrastructure
sdk-diagnostic-docs-needed
Contributor
📋 SDK Diagnostic Documentation ReminderThis PR introduces 1 new SDK diagnostic code:
Action RequiredPlease ensure that documentation for this diagnostic is added or updated in the dotnet/docs repository at:
Each diagnostic should have:
Thank you for helping keep our documentation up to date! 🙏 |
kotlarmilos
force-pushed
the
dev/update-sdk-mobile
branch
from
June 14, 2026 15:59
3e8d249 to
45d442a
Compare
vitek-karas
reviewed
Jun 16, 2026
Building with the .NET 10 SDK does not resolve the error when the project targets .NET 11.0 or later, so the previous message was misleading. Point users at the two real fixes: use the CoreCLR runtime, or target .NET 10.0. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Gate the NETSDK1242 check on a private _DisableCheckForUnsupportedMonoMobileRuntime property so a project can opt out during the transition. The escape hatch stops working once the runtime packs are removed, which is acceptable. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds an SDK build-time validation that emits a new error (NETSDK1242) when UseMonoRuntime=true is used for Android or Apple mobile TFMs on .NET 11.0+ (directing users to switch to CoreCLR or target .NET 10.0), avoiding later/less-clear missing-pack failures.
Changes:
- Adds
_CheckForUnsupportedMonoMobileRuntimeto fail early for.NETCoreApp+UseMonoRuntime=true+net11.0++ (android/ios/tvos/maccatalyst). - Introduces the new resource string
MonoRuntimeNotSupportedForPlatformwith error codeNETSDK1242. - Updates all localized XLF files with the new trans-unit for
NETSDK1242.
Show a summary per file
| File | Description |
|---|---|
| src/Tasks/Microsoft.NET.Build.Tasks/targets/Microsoft.NET.TargetFrameworkInference.targets | Adds early validation target that throws NETSDK1242 for unsupported Mono mobile runtime usage on net11.0+. |
| src/Tasks/Common/Resources/Strings.resx | Adds MonoRuntimeNotSupportedForPlatform (NETSDK1242) and updates the “latest message added” guard comment. |
| src/Tasks/Common/Resources/xlf/Strings.cs.xlf | Adds localized entry placeholder for MonoRuntimeNotSupportedForPlatform (NETSDK1242). |
| src/Tasks/Common/Resources/xlf/Strings.de.xlf | Adds localized entry placeholder for MonoRuntimeNotSupportedForPlatform (NETSDK1242). |
| src/Tasks/Common/Resources/xlf/Strings.es.xlf | Adds localized entry placeholder for MonoRuntimeNotSupportedForPlatform (NETSDK1242). |
| src/Tasks/Common/Resources/xlf/Strings.fr.xlf | Adds localized entry placeholder for MonoRuntimeNotSupportedForPlatform (NETSDK1242). |
| src/Tasks/Common/Resources/xlf/Strings.it.xlf | Adds localized entry placeholder for MonoRuntimeNotSupportedForPlatform (NETSDK1242). |
| src/Tasks/Common/Resources/xlf/Strings.ja.xlf | Adds localized entry placeholder for MonoRuntimeNotSupportedForPlatform (NETSDK1242). |
| src/Tasks/Common/Resources/xlf/Strings.ko.xlf | Adds localized entry placeholder for MonoRuntimeNotSupportedForPlatform (NETSDK1242). |
| src/Tasks/Common/Resources/xlf/Strings.pl.xlf | Adds localized entry placeholder for MonoRuntimeNotSupportedForPlatform (NETSDK1242). |
| src/Tasks/Common/Resources/xlf/Strings.pt-BR.xlf | Adds localized entry placeholder for MonoRuntimeNotSupportedForPlatform (NETSDK1242). |
| src/Tasks/Common/Resources/xlf/Strings.ru.xlf | Adds localized entry placeholder for MonoRuntimeNotSupportedForPlatform (NETSDK1242). |
| src/Tasks/Common/Resources/xlf/Strings.tr.xlf | Adds localized entry placeholder for MonoRuntimeNotSupportedForPlatform (NETSDK1242). |
| src/Tasks/Common/Resources/xlf/Strings.zh-Hans.xlf | Adds localized entry placeholder for MonoRuntimeNotSupportedForPlatform (NETSDK1242). |
| src/Tasks/Common/Resources/xlf/Strings.zh-Hant.xlf | Adds localized entry placeholder for MonoRuntimeNotSupportedForPlatform (NETSDK1242). |
Copilot's findings
- Files reviewed: 15/15 changed files
- Comments generated: 1
vitek-karas
approved these changes
Jun 16, 2026
rolfbjarne
reviewed
Jun 16, 2026
Co-authored-by: Rolf Bjarne Kvinge <rolf@xamarin.com>
The Czech xlf source text was not regenerated after the NETSDK1242 message was shortened, causing XliffTasks to fail the out-of-date check across all build legs. Align the cs.xlf source with Strings.resx. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
vitek-karas
approved these changes
Jun 18, 2026
This was referenced Jun 18, 2026
Member
Author
Member
|
This change prevents the ability to build the runtime repo with Mono runtime. See dotnet/source-build#5603 |
Member
|
@mthalman I would set |
Member
I can do that but this would be a breaking change for downstream source-build distro partners that need to build with Mono runtime. Unfortunately, this change made its way into the |
Member
Oh never mind. Not sure what I was thinking. |
davidnguyen-tech
added a commit
to davidnguyen-tech/performance
that referenced
this pull request
Jul 7, 2026
The .NET 11 SDK blocks UseMonoRuntime for mobile TFMs (NETSDK1242). Pass /p:_DisableCheckForUnsupportedMonoMobileRuntime=true (the SDK's supported opt-out, dotnet/sdk#54713) alongside UseMonoRuntime=true for the Mono inner-loop variant so restore + build succeed on net11.0-ios. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Add build error NETSDK1242 so that building Android or Apple mobile projects with UseMonoRuntime=true on the .NET 11 SDK fails with a clear message directing users to the .NET 10 SDK, instead of a silent missing-pack error. Implemented via _CheckForUnsupportedMonoMobileRuntime in Microsoft.NET.TargetFrameworkInference.targets and the NETSDK1242 string (Strings.resx and 13 xlf translations).
Validation pipelines (must pass): dotnet-sdk-public PR build.