Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Sep 3, 2025

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:

  • Added identical NOTE blocks explaining the framework-dependent application requirement
  • Updated the ms.date metadata to reflect the documentation update
  • Used proper Microsoft Learn NOTE syntax for consistency with existing documentation

This 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

📄 File 🔗 Preview link
aspnetcore/fundamentals/host/platform-specific-configuration.md Use hosting startup assemblies in ASP.NET Core

@Copilot Copilot AI changed the title [WIP] Add a note that 'Runtime Store' activation only works with framework-dependent applications Add note that DOTNET_ADDITIONAL_DEPS only works with framework-dependent applications Sep 3, 2025
Copilot finished work on behalf of tdykstra September 3, 2025 16:55
@Copilot Copilot AI requested a review from tdykstra September 3, 2025 16:55
@tdykstra tdykstra requested a review from wadepickett September 4, 2025 01:56
@tdykstra tdykstra marked this pull request as ready for review September 4, 2025 01:58
Copy link
Contributor

@wadepickett wadepickett left a comment

Choose a reason for hiding this comment

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

Looks great. Just a minor correction to the ms.date you could take or leave.

@tdykstra tdykstra added the reQUEST Triggers an issue to be imported into Quest label Sep 6, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
reQUEST Triggers an issue to be imported into Quest
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add a note that 'Runtime Store' activation only works with framework-dependent applications
3 participants