Skip to content

Add NETSDK1242 SDK error documentation#54379

Open
kotlarmilos wants to merge 2 commits into
dotnet:mainfrom
kotlarmilos:mobile-netsdk1242-docs
Open

Add NETSDK1242 SDK error documentation#54379
kotlarmilos wants to merge 2 commits into
dotnet:mainfrom
kotlarmilos:mobile-netsdk1242-docs

Conversation

@kotlarmilos

@kotlarmilos kotlarmilos commented Jun 15, 2026

Copy link
Copy Markdown
Member

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

  • New page docs/core/tools/sdk-errors/netsdk1242.md describing the error and how to resolve it.
  • Added NETSDK1242 to the SDK error index table (docs/core/tools/sdk-errors/index.md).
  • Added the NETSDK1242 entry to the tools-diagnostics TOC (docs/navigate/tools-diagnostics/toc.yml).

Internal-only information

Source diagnostic: MonoRuntimeNotSupportedForPlatform in dotnet/sdk.


Internal previews

📄 File 🔗 Preview link
docs/core/tools/sdk-errors/index.md .NET SDK error list
docs/core/tools/sdk-errors/netsdk1242.md "NETSDK1242: Building projects with the Mono runtime is not supported in .NET 11 and later"
docs/navigate/tools-diagnostics/toc.yml docs/navigate/tools-diagnostics/toc

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.
Copilot AI review requested due to automatic review settings June 15, 2026 16:23
@kotlarmilos kotlarmilos requested review from a team and meaghanlewis as code owners June 15, 2026 16:23
@dotnetrepoman dotnetrepoman Bot added this to the June 2026 milestone Jun 15, 2026

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

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

Comment thread docs/core/tools/sdk-errors/netsdk1242.md Outdated
Comment thread docs/core/tools/sdk-errors/netsdk1242.md Outdated
Comment thread docs/core/tools/sdk-errors/netsdk1242.md Outdated
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