Skip to content

Document PublishRuntimeIdentifier in the .NET SDK MSBuild property reference #53878

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Copilot wants to merge 12 commits into
base: main
Choose a base branch
from
+11 −0
Open

Document PublishRuntimeIdentifier in the .NET SDK MSBuild property reference #53878

Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
180ace3
Initial plan
Copilot May 18, 2026
0670b58
Document PublishRuntimeIdentifier property
Copilot May 18, 2026
7f8bb6a
Refine PublishRuntimeIdentifier wording
Copilot May 18, 2026
b6caa88
Adjust PublishRuntimeIdentifier style
Copilot May 18, 2026
1028cbc
Finalize PublishRuntimeIdentifier wording
Copilot May 18, 2026
840d567
Clarify PublishRuntimeIdentifier precedence
Copilot May 18, 2026
09a9d29
Improve PublishRuntimeIdentifier readability
Copilot May 18, 2026
e1d1d39
Use active voice for PublishRuntimeIdentifier docs
Copilot May 18, 2026
6a06e3e
Finalize PublishRuntimeIdentifier description
Copilot May 18, 2026
8bdc3de
Polish PublishRuntimeIdentifier wording
Copilot May 18, 2026
5043074
Remove redundant PublishRuntimeIdentifier text
Copilot May 18, 2026
c282711
Split PublishRuntimeIdentifier description into short sentences
Copilot May 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions docs/core/project-sdk/msbuild-props.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -405,6 +405,7 @@ The following MSBuild properties are documented in this section:
- [PublishReferencesDocumentationFiles](#publishreferencesdocumentationfiles)
- [PublishReferencesSymbols](#publishreferencessymbols)
- [PublishRelease](#publishrelease)
- [PublishRuntimeIdentifier](#publishruntimeidentifier)
- [PublishSelfContained](#publishselfcontained)
- [RollForward](#rollforward)
- [RuntimeFrameworkVersion](#runtimeframeworkversion)
Expand Down Expand Up @@ -581,6 +582,16 @@ The `PublishRelease` property informs `dotnet publish` to use the `Release` conf
> - Starting in the .NET 8 SDK, `PublishRelease` defaults to `true` for projects that target .NET 8 or later. For more information, see ['dotnet publish' uses Release configuration](../compatibility/sdk/8.0/dotnet-publish-config.md).
> - This property does not affect the behavior of `dotnet build /t:Publish`, and it changes the configuration only when publishing via the .NET CLI.

### PublishRuntimeIdentifier

Specify a single [runtime identifier (RID)](../rid-catalog.md) for publish operations only. This property was introduced in .NET 7. It doesn't affect build operations. During publish, `PublishRuntimeIdentifier` sets `RuntimeIdentifier`. If you pass `RuntimeIdentifier` as a global property, that value takes precedence.

```xml
<PropertyGroup>
<PublishRuntimeIdentifier>linux-x64</PublishRuntimeIdentifier>
</PropertyGroup>
```

### PublishSelfContained

The `PublishSelfContained` property informs `dotnet publish` to publish an app as a [self-contained app](../deploying/index.md#self-contained-deployment). This property is useful when you can't use the `--self-contained` argument for the [dotnet publish](../tools/dotnet-publish.md) command&mdash;for example, when you're publishing at the solution level. In that case, you can add the `PublishSelfContained` MSBuild property to a project or *Directory.Build.Props* file.
Expand Down
Loading