Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Aug 11, 2025

This PR documents the breaking change where .NET Tool packaging now invokes Publish instead of Build, affecting which assets are included in tool packages.

What changed

In .NET 10 Preview 6, the .NET Tool packaging process changed from invoking the Build target to the Publish target. This means that assets created during the publish process (like StaticWebAssets from WebSDK, minified and trimmed application assets) are now included in tool packages by default.

Impact

  • Users who previously copied these files explicitly may receive build diagnostics warning them of duplicate copies
  • Tool packages will now include publish-time optimizations automatically
  • Enables creation of optimized, platform-specific .NET Tool packages (self-contained tools, trimmed/AOT tools)

Documentation added

  • New file: docs/core/compatibility/sdk/10.0/dotnet-tool-pack-publish.md - Complete breaking change documentation following established patterns
  • Updated: docs/core/compatibility/toc.yml - Added entry to SDK section
  • Updated: docs/core/compatibility/10.0.md - Added entry to SDK breaking changes table

The documentation follows the Microsoft Writing Style Guide and includes all required sections: version information, previous/new behavior, type of breaking change, reason for change, recommended actions, and affected APIs.

Fixes #47916.


💡 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
docs/core/compatibility/10.0.md Breaking changes in .NET 10
docs/core/compatibility/sdk/10.0/dotnet-tool-pack-publish.md .NET tool packaging invokes Publish instead of Build
docs/core/compatibility/toc.yml docs/core/compatibility/toc

Copilot AI changed the title [WIP] [Breaking change]: .NET Tool packaging now invokes Publish instead of Build Document .NET Tool packaging breaking change for .NET 10 Preview 6 Aug 11, 2025
Copilot AI requested a review from gewarren August 11, 2025 22:40
Copilot finished work on behalf of gewarren August 11, 2025 22:40
@gewarren gewarren marked this pull request as ready for review August 12, 2025 21:17
@gewarren gewarren requested a review from a team as a code owner August 12, 2025 21:17
@gewarren gewarren requested review from a team and baronfel August 12, 2025 21:19
Copy link
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

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

This LGTM. I had one technical question to resolve before merging.

@gewarren gewarren merged commit dc17c8a into main Aug 13, 2025
10 checks passed
@gewarren gewarren deleted the copilot/fix-47916 branch August 13, 2025 16:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Breaking change]: .NET Tool packaging now invokes Publish instead of Build

4 participants