Skip to content

Document PublishRuntimeIdentifier property#53896

Closed
emrecunkus wants to merge 1 commit into
dotnet:mainfrom
emrecunkus:main
Closed

Document PublishRuntimeIdentifier property#53896
emrecunkus wants to merge 1 commit into
dotnet:mainfrom
emrecunkus:main

Conversation

@emrecunkus
Copy link
Copy Markdown

@emrecunkus emrecunkus commented May 20, 2026

Fixes #53869

Adds documentation for the PublishRuntimeIdentifier MSBuild property and includes an example usage.


Internal previews

📄 File 🔗 Preview link
docs/core/project-sdk/msbuild-props.md MSBuild reference for .NET SDK projects

Added documentation for the PublishRuntimeIdentifier property, explaining its usage and providing an example.
@emrecunkus emrecunkus requested review from a team and gewarren as code owners May 20, 2026 14:27
@dotnetrepoman dotnetrepoman Bot added this to the May 2026 milestone May 20, 2026
@dotnet-policy-service dotnet-policy-service Bot added dotnet-fundamentals/svc community-contribution Indicates PR is created by someone from the .NET community. labels May 20, 2026
Copy link
Copy Markdown
Contributor

@adegeo adegeo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks great! Thank you for the contribution.

There are two improvements we can make, and one I think is critical.

The first improvement is inline and has to do with the wording.

The second improvement is that we should mention that this property doesn't override RuntimeIdentifier. RuntimeIdentifier still takes precident, even when publishing.


### PublishRuntimeIdentifier

The `PublishRuntimeIdentifier` property lets you specify a single [runtime identifier (RID)](../rid-catalog.md) for the `dotnet publish` command. This property is similar to the [RuntimeIdentifier](#runtimeidentifier) property, except that it's specific to the `publish` verb.
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.

Instead of verb, we should use target as it's an MSBuild target, or just say "publishing"

Suggested change
The `PublishRuntimeIdentifier` property lets you specify a single [runtime identifier (RID)](../rid-catalog.md) for the `dotnet publish` command. This property is similar to the [RuntimeIdentifier](#runtimeidentifier) property, except that it's specific to the `publish` verb.
The `PublishRuntimeIdentifier` property lets you specify a single [runtime identifier (RID)](../rid-catalog.md) for the `dotnet publish` command. This property is similar to the [RuntimeIdentifier](#runtimeidentifier) property, except that it's specific to the `publish` target.

@gewarren
Copy link
Copy Markdown
Contributor

Apologies, but this was already taken care of in #53878.

@gewarren gewarren closed this May 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

community-contribution Indicates PR is created by someone from the .NET community. dotnet-fundamentals/svc

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document the 'PublishRuntimeIdentifier' property

3 participants