Skip to content

Add .NET 11 breaking change: restore doesn't search the global packages folder for a higher package version - #55786

Open
gewarren with Copilot wants to merge 4 commits into
mainfrom
copilot/breaking-change-restore-package-versions
Open

Add .NET 11 breaking change: restore doesn't search the global packages folder for a higher package version#55786
gewarren with Copilot wants to merge 4 commits into
mainfrom
copilot/breaking-change-restore-package-versions

Conversation

Copilot AI commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

In .NET 11 RC 1, when a requested package version doesn't exist, NuGet restore only searches package sources for the "next best" (lowest higher) version — versions present only in the global packages folder are no longer candidates. This can change which version is selected, or turn an NU1603 warning into an NU1102 error.

Changes

  • New article docs/core/compatibility/sdk/11/restore-global-packages-folder-version-search.md — previous/new behavior tables adapted from the issue, the unchanged exact-version-match carve-out, reason (determinism across machines), and recommended action linking to NuGet supply-chain best practices.
  • TOC — entry added under SDK and MSBuild (.NET 11) in docs/core/compatibility/toc.yml.
  • Index — row added to the SDK and MSBuild table in docs/core/compatibility/11.md.

Notes for reviewers

  • The issue text uses NU1604 in the tables but NU1603 in the prose; the article uses NU1603 throughout, since NU1603 is the "resolved to a higher version than requested" warning and NU1604 is the "dependency without a lower bound" warning. Please confirm.
  • Type of change follows the issue's selection: Source incompatible (restore can now fail with NU1102). Automated review suggested "Behavioral change" — flagging in case the SDK team prefers that categorization; the article and index entry currently match each other.
  • No other articles in this repo document the NU1603/NU1102 fallback behavior (that content lives in the NuGet docs repo), so no related-article updates were made.

Internal previews

File Preview link
docs/core/compatibility/11.md Learn preview
docs/core/compatibility/sdk/11/restore-global-packages-folder-version-search.md Learn preview
docs/core/compatibility/toc.yml Learn preview

Build report

Copilot AI lite review requested due to automatic review settings September 1, 2026 00:49

Copilot AI left a comment

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.

Copilot wasn't able to review any files in this pull request.


💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

…older for higher version

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix restore behavior for package version searches Add .NET 11 breaking change: restore doesn't search the global packages folder for a higher package version Sep 1, 2026
Copilot AI requested a review from gewarren September 1, 2026 00:51
Comment thread docs/core/compatibility/toc.yml Outdated
Comment thread docs/core/compatibility/11.md Outdated
Comment thread docs/core/compatibility/sdk/11/restore-global-packages-folder-version-search.md Outdated
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Comment thread docs/core/compatibility/sdk/11/restore-global-packages-folder-version-search.md Outdated
Comment thread docs/core/compatibility/sdk/11/restore-global-packages-folder-version-search.md Outdated
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
@gewarren
gewarren marked this pull request as ready for review September 1, 2026 17:25
@gewarren
gewarren requested a review from a team as a code owner September 1, 2026 17:25
@gewarren
gewarren requested a review from zivkan September 1, 2026 17:25

@BillWagner BillWagner left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This LGTM.

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]: Restore will no longer search package versions from the global packages folder when choosing a higher version

4 participants