Add note that DOTNET_ADDITIONAL_DEPS only works with framework-dependent applications #36038
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.
The
DOTNET_ADDITIONAL_DEPS
environment variable is a key mechanism for runtime store activation in hosting startup assemblies, but it has an important limitation that wasn't documented: it only works with framework-dependent applications and is ignored for self-contained applications.This PR adds clear documentation of this limitation by adding NOTE blocks in the Runtime Store section immediately after
DOTNET_ADDITIONAL_DEPS
is introduced. The notes are added in both moniker ranges (>=aspnetcore-3.0
and<aspnetcore-3.0
) to ensure all users are informed of this behavior.Changes made:
ms.date
metadata to reflect the documentation updateThis documentation enhancement will help prevent confusion when developers attempt to use runtime stores with self-contained applications, as they'll now understand why the
DOTNET_ADDITIONAL_DEPS
environment variable has no effect in that deployment model.Fixes #35935.
💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.
Internal previews