docs: Breaking change article for NativeAOT lib prefix on Unix (.NET 11)#52862
Merged
docs: Breaking change article for NativeAOT lib prefix on Unix (.NET 11)#52862
Conversation
…T 11 Fixes #52324 Agent-Logs-Url: https://github.com/dotnet/docs/sessions/1401b505-77ed-4394-aafb-c700702941c5 Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Update NativeAOT to use 'lib' prefix for Unix outputs
docs: Breaking change article for NativeAOT lib prefix on Unix (.NET 11)
Apr 3, 2026
…fix to msbuild-props.md Agent-Logs-Url: https://github.com/dotnet/docs/sessions/3ef11c32-59d2-4c5b-ab73-f7d5d36f2b3b Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Contributor
Author
gewarren
approved these changes
Apr 4, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
Adds .NET 11 documentation for a NativeAOT behavior change on Unix where non-executable native library outputs now get the lib prefix by default, and documents the UseNativeLibPrefix opt-out property.
Changes:
- Adds a new .NET 11 breaking change article describing the new default
libprefix behavior and the opt-out property. - Updates the .NET 11 breaking changes index and TOC to include the new Interop entry.
- Documents
UseNativeLibPrefixin the MSBuild properties reference.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| docs/core/project-sdk/msbuild-props.md | Adds UseNativeLibPrefix property documentation and links to the breaking change article. |
| docs/core/compatibility/toc.yml | Adds an Interop node for .NET 11 and links the new breaking change article. |
| docs/core/compatibility/interop/11/nativeaot-lib-prefix.md | New breaking change article describing the Unix lib prefix default and opt-out. |
| docs/core/compatibility/11.md | Adds an Interop section entry for the new breaking change article. |
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.
Documents the .NET 11 Preview 3 NativeAOT breaking change where non-executable native library outputs on Unix now get the
libprefix by default (e.g.,mylib.so→libmylib.so,mylib.a→libmylib.a).Changes
docs/core/compatibility/interop/11/nativeaot-lib-prefix.md— covers previous/new behavior, opt-out viaUseNativeLibPrefix, and recommended actionsdocs/core/compatibility/11.md— adds new Interop section with entry for the articledocs/core/compatibility/toc.yml— adds Interop section under .NET 11docs/core/project-sdk/msbuild-props.md— addsUseNativeLibPrefixto the Publish-related properties section with a full description, example, and cross-link to the breaking change articleOpt-out
Internal previews