Add NETSDK1242 SDK error documentation#54379
Merged
Merged
Conversation
Document the NETSDK1242 build error, raised when a project selects the Mono runtime for a mobile platform (android, ios, maccatalyst, tvos) while targeting .NET 11 or later.
Contributor
There was a problem hiding this comment.
Pull request overview
Adds reference documentation for the .NET SDK diagnostic NETSDK1242, and wires it into the existing SDK errors index and Tools diagnostics navigation.
Changes:
- Added a new SDK error reference page for NETSDK1242 with cause and resolution guidance.
- Added NETSDK1242 to the SDK error index table.
- Added NETSDK1242 to the Tools diagnostics TOC.
Show a summary per file
| File | Description |
|---|---|
| docs/navigate/tools-diagnostics/toc.yml | Adds NETSDK1242 to the Tools diagnostics navigation tree. |
| docs/core/tools/sdk-errors/netsdk1242.md | New error reference page documenting NETSDK1242 and resolution options. |
| docs/core/tools/sdk-errors/index.md | Adds NETSDK1242 to the SDK errors index table. |
Copilot's findings
- Files reviewed: 3/3 changed files
- Comments generated: 3
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
vitek-karas
requested changes
Jun 16, 2026
The previous wording told users to build with the .NET 10 SDK, which does not resolve the error when the project targets .NET 11.0 or later. Recommend the two real fixes: use the CoreCLR runtime, or retarget the project to .NET 10. Drop the global.json approach, which is unnecessary, and align the title and body on ".NET 11.0 and later". Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Remove the NETSDK1242 entry from the Tools diagnostics navigation. The error reference page and the SDK errors index cover the diagnostic. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
List the error reference page in the Tools diagnostics navigation, matching every other NETSDK error page and avoiding an orphaned-article build warning. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Keep the resolution wording but remove the code block; the property change is clear from the text. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Remove the blank line between the two resolution bullets. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
vitek-karas
reviewed
Jun 16, 2026
vitek-karas
approved these changes
Jun 16, 2026
Co-authored-by: Vitek Karas <10670590+vitek-karas@users.noreply.github.com>
now.
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.
Summary
Adds reference documentation for the new SDK build error NETSDK1242, introduced in the .NET 11 SDK. The error is raised when a project selects the Mono runtime (
UseMonoRuntime=true) for a mobile target platform (android,ios,maccatalyst,tvos) while targeting .NET 11 or later.This addresses the SDK diagnostic documentation reminder for
NETSDK1242.Changes
docs/core/tools/sdk-errors/netsdk1242.mddescribing the error and how to resolve it.NETSDK1242to the SDK error index table (docs/core/tools/sdk-errors/index.md).NETSDK1242entry to the tools-diagnostics TOC (docs/navigate/tools-diagnostics/toc.yml).Internal-only information
Source diagnostic:
MonoRuntimeNotSupportedForPlatformin dotnet/sdk.Internal previews