core icon indicating copy to clipboard operation
core copied to clipboard

Published 20 hours ago • verified publisher icon dotnet

Breaking Change to .NET Packages on Winget

Open mthalman opened this issue 3 years ago • 8 comments

Breaking Change to .NET Packages on Winget

The Microsoft .NET team plans to make a set of breaking changes to the .NET packages that are available through the Windows Package Manager tool (winget). Existing .NET packages that are currently community maintained will be replaced by new packages with different package identifiers. This new set of packages will be officially supported by the .NET team and conform to a consistent naming convention.

Removal of Existing Winget Packages

A variety of .NET winget packages have been defined by the community. These are not consistently defined and do not conform to naming and versioning conventions used by the .NET product. These packages should be considered deprecated and will be removed and replaced by packages that are exclusively maintained by the .NET team.

The following packages are deprecated and will be removed:

Dependencies on Existing Packages

There are a set of packages that have dependencies on the above .NET packages to be removed. To avoid breaking these dependent packages, their dependencies will be updated to the new replacement packages before the deprecated ones are removed.

This is the set of packages which will have their dependencies updated:

  • HandBrake.HandBrake
    • Current Dependencies:
      • Microsoft.dotnetRuntime.5-x64
      • Microsoft.dotnetRuntime.6-x64
    • New Dependencies:
      • Microsoft.DotNet.Runtime.5
      • Microsoft.DotNet.Runtime.6
  • Iriun.IriunWebcam
    • Current Dependencies:
      • Microsoft.dotnetRuntime.3-x86
    • New Dependencies:
      • Microsoft.DotNet.Runtime.3_1
  • LINQPad.LINQPad.6
    • Current Dependencies:
      • Microsoft.dotnetRuntime.3-x64
    • New Dependencies:
      • Microsoft.DotNet.Runtime.3_1
  • LINQPad.LINQPad.7
    • Current Dependencies:
      • Microsoft.dotnetRuntime.6-x64
      • Microsoft.dotnetRuntime.6-x86
    • New Dependencies:
      • Microsoft.DotNet.Runtime.6
  • Microsoft.PowerToys
    • Current Dependencies:
      • Microsoft.dotnetRuntime.3-x64
    • New Dependencies:
      • Microsoft.DotNet.Runtime.3_1
  • rocksdanister.LivelyWallpaper
    • Current Dependencies:
      • Microsoft.dotnetRuntime.3-x86
    • New Dependencies:
      • Microsoft.DotNet.Runtime.3_1
  • VMware.HorizonClient
    • Current Dependencies:
      • Microsoft.dotnetRuntime.5-x86
    • New Dependencies:
      • Microsoft.DotNet.Runtime.5

New .NET packages

The .NET team will be replacing the previously mentioned community-maintained packages with a new set of packages with different package identifiers. These packages will be maintained by the .NET team and kept up to date as part of each servicing release for each of the supported .NET versions.

These are the package identifiers of the new set of packages to be added:

  • Microsoft.DotNet.AspNetCore.3_1
  • Microsoft.DotNet.AspNetCore.5
  • Microsoft.DotNet.AspNetCore.6
  • Microsoft.DotNet.AspNetCore.Preview
  • Microsoft.DotNet.DesktopRuntime.3_1
  • Microsoft.DotNet.DesktopRuntime.5
  • Microsoft.DotNet.DesktopRuntime.6
  • Microsoft.DotNet.DesktopRuntime.Preview
  • Microsoft.DotNet.HostingBundle.3_1
  • Microsoft.DotNet.HostingBundle.5
  • Microsoft.DotNet.HostingBundle.6
  • Microsoft.DotNet.HostingBundle.Preview
  • Microsoft.DotNet.Runtime.3_1
  • Microsoft.DotNet.Runtime.5
  • Microsoft.DotNet.Runtime.6
  • Microsoft.DotNet.Runtime.Preview
  • Microsoft.DotNet.SDK.3_1
  • Microsoft.DotNet.SDK.5
  • Microsoft.DotNet.SDK.6
  • Microsoft.DotNet.SDK.Preview

Implementation Timeline

  1. Publish new .NET packages (Date: May 11, 2022)
  2. Create PRs to update dependencies to reference the new .NET packages instead of the deprecated ones (Date: May 11, 2022)
  3. Remove the deprecated .NET packages (Date: May 18, 2022)

Package Installation Instructions

In order to avoid compatibility issues, you must clean your machine of any existing .NET winget packages that are listed for removal prior to installing the new .NET packages.

Once you've installed the new .NET packages, upgrade will not work for those packages until a new winget feature is available. To work around this issue, you'll need to force an upgrade to the specific version that you want:

winget upgrade <package-id> --force --version <desired-version>

mthalman avatar May 05 '22 17:05 mthalman

One caveat here is the Windows Package Manager does not yet support dependencies in the client. We are performing some validation on dependencies reported in manifests. Mainly, we're validating they exist in the repository. Performing the "add" before "remove" will ensure the manifests aren't pointing to non-existent dependencies, but there is no current logic in the released "stable" client to handle them.

Related to:

  • microsoft/winget-cli/Issues/163

denelon avatar May 05 '22 22:05 denelon

now powertoys depends on net 6

lychichem avatar May 12 '22 23:05 lychichem

Are the back versions of .NET SDK being added or only the latest ones? I know some projects I've worked on have strict global.json files that prevent using newer SDKs (even patch versions).

jedieaston avatar May 18 '22 15:05 jedieaston

Are the back versions of .NET SDK being added or only the latest ones? I know some projects I've worked on have strict global.json files that prevent using newer SDKs (even patch versions).

@jedieaston - We'll include the latest patch version of each of the SDKs. For example, for .NET 6 we have SDKs published for 6.0.105, 6.0.203, and 6.0.300.

Does that provide what you're wanting?

mthalman avatar May 18 '22 16:05 mthalman

That's probably fine, although I work on projects sometimes that have rollForward: disable set in their global.json file (meaning I need the exact SDK version to be installed). I should probably tell them to remove that because it means I have like six SDK versions installed at once, but on the other hand it would be nice to be able to install each specified version via winget rather than having to go to the browser when setting up a new machine.

So, in conclusion, don't do the extra work on my account :) (I'd just prefer in the future that you didn't remove intermediate versions unless there's a good reason, as most other packages in the repo do)

jedieaston avatar May 18 '22 18:05 jedieaston

The intention is to not remove any versions going forward. This was a breaking change to just get us to a stable and consistent point.

mthalman avatar May 18 '22 18:05 mthalman

Related issue: microsoft/winget-pkgs#61981 @denelon @mthalman

lychichem avatar May 25 '22 14:05 lychichem

Please have a look at this code might help you Winget.zip

drraghavendra avatar Oct 08 '22 11:10 drraghavendra